Token 监控器
概述
分析 OpenClaw 会话 JSONL 文件，追踪：
- Token 消耗统计（输入/输出/缓存命中）
- 成功率/失败率
- Skill/功能级别的详细分析
- 性能指标
快速开始
# 分析单个会话
python {baseDir}/scripts/analyze_session.py --session-file ~/.claude/projects/<项目>/<会话>.jsonl
# 分析整个项目
python {baseDir}/scripts/analyze_session.py --project-dir ~/.claude/projects/<项目>
# 生成 HTML 报告
python {baseDir}/scripts/analyze_session.py --project-dir ~/.claude/projects/<项目> --format html --output report.html
# 按 skill 名称筛选
python {baseDir}/scripts/analyze_session.py --skill "skill-name" --project-dir ~/.claude/projects/<项目>
功能说明
- 解析会话文件：读取 OpenClaw 项目的
.jsonl会话文件 - 提取使用数据：收集 token 数量、工具调用等信息
- 按 Skill 分类：按 skill/工具名称分组操作
- 计算指标：
- 输入 tokens
- 输出 tokens
- 缓存读取 tokens
- 缓存写入 tokens
- 总 tokens
- 成功率/失败率
- 平均延迟
- 生成报告：输出结构化报告（JSON、Markdown 或 HTML）
输出格式
JSON 输出
{
"summary": {
"总会话数": 10,
"总消息数": 150,
"输入tokens": 30000,
"输出tokens": 15000,
"缓存读取tokens": 5000,
"总tokens": 50000
},
"skills": {
"skill-name": {
"调用次数": 5,
"输入tokens": 8000,
"输出tokens": 2000,
"缓存读取tokens": 1000,
"总tokens": 11000,
"成功率": 0.95
}
}
}
HTML 报告
交互式报告包含：
- 汇总仪表板
- Skill 级别详细表格
- Token 分布可视化
- 成功率指示器
会话文件结构
会话文件为 JSONL 格式，每条记录如下：
{
"type": "message",
"message": {
"role": "assistant",
"content": [...],
"usage": {
"input_tokens": 1000,
"output_tokens": 500,
"cache_read_input_tokens": 200
}
},
"timestamp": "2026-03-16T07:12:47.060Z"
}
参考文档
references/session-format.md- 会话文件格式详细说明references/metrics-calculation.md- 指标计算方式