LLM API 调用日志记录、分析与可视化。透明代理拦截所有 LLM API 调用,记录完整 prompt/generation/token 用量, 附带零依赖网页日志查看器(支持多维过滤、完整对话展示、token 成本统计)。 适用场景:分析 API 调用成本、调试 prompt、查看历史对话记录、排查慢请求/...
LLM API 调用日志完整解决方案。透明代理拦截所有请求,零侵入记录,配套终端和网页两种查看方式。
文件: log-viewer.html(skill 目录内)
log-viewer.html 复制到任意位置,双击用浏览器打开.jsonl 日志文件(支持多文件合并)Esc 关闭详情,↑↓ 切换上下条# 进入日志查看器目录
cd ~/.openclaw/workspace/company/api-proxy/
# 今日摘要列表
python3 log_viewer.py
# 最后 N 条
python3 log_viewer.py --last 5
# 某条完整详情
python3 log_viewer.py --id 3 --full
# 今日统计(token 用量、成本估算)
python3 log_viewer.py --stats
# 今日统计 + 生成飞书文档
python3 log_viewer.py --stats --feishu
# 搜索关键词
python3 log_viewer.py --search "关键词"
# 只看失败请求
python3 log_viewer.py --errors
# 生成飞书文档(超300条自动截断明细)
python3 log_viewer.py --feishu
# 指定日期
python3 log_viewer.py --date 2026-03-10 --feishu
bash ~/.openclaw/workspace/skills/api-logger/install.sh
安装脚本将:
~/.openclaw/workspace/company/api-proxy/proxy.py 和 log_viewer.py~/.openclaw/workspace/company/api-logs/修改 openclaw.json 的 baseUrl:
"baseUrl": "http://127.0.0.1:18790/anthropic"
修改上游地址(proxy.py 中的 --upstream 默认值):
parser.add_argument("--upstream", default="https://your-actual-api-endpoint/anthropic", ...)
⚠️ 修改 openclaw.json 后需重启 Gateway 才生效,重启前请与用户确认。
| 文件 | 用途 |
|---|---|
proxy.py | 透明代理服务(Python asyncio + aiohttp) |
log_viewer.py | 终端查看器(彩色输出,支持飞书文档) |
log-viewer.html | 网页查看器(零依赖,双击打开) |
install.sh | 一键安装脚本 |
| 字段 | 说明 |
|---|---|
timestamp | ISO 时间(含时区) |
request_id | UUID |
streaming | 是否流式请求 |
request_body | 完整请求(model、system、messages) |
response_status | HTTP 状态码 |
response_body_parsed | 解析后的响应(content、usage) |
duration_ms | 耗时(毫秒) |
response_body_parsed.usage 中ZIP package — ready to use