OpenClaw 会话成本分析工具，自动扫描代理日志，统计 Token 消耗、API 费用及性能指标，支持多维度过滤与多种输出格式。
说明：
# Session Cost 工具评估
## 核心用法
Session Cost 是专为 OpenClaw 生态系统设计的成本分析工具，用于解析会话日志文件（`.jsonl`），提供详细的 Token 使用量、API 费用计算及性能指标统计。工具默认扫描 `~/.openclaw/agents/` 目录下的所有代理会话，按代理和模型分组输出结果。
**主要功能包括：**
– **多维过滤**：支持按代理名称、模型提供商（Anthropic/OpenAI/Ollama 等）、时间范围（如 `30m`、`7d`）筛选数据
– **灵活输出**：提供文本摘要（默认）、详细会话明细、紧凑表格、JSON 结构化数据、Discord 聊天格式共 5 种输出模式
– **智能搜索**：支持跨代理自动查找特定会话 ID，无需指定路径
– **缓存成本计算**：完整支持 Anthropic 缓存机制的读/写费用拆分
## 显著优点
1. **开箱即用**：无需配置，自动发现代理目录结构，默认行为即可生成完整成本报告
2. **精细化成本追踪**：不仅统计总费用，还细分输入 Token、输出 Token、缓存读取、缓存写入四类成本，便于优化支出结构
3. **多场景适配**：Discord 格式专为聊天机器人优化；JSON 格式便于程序化集成；表格模式适合终端快速浏览
4. **时间窗口灵活**：内置时间解析器，支持 `30m`/`2h`/`7d` 等人类友好格式
5. **本地模型兼容**：对 Ollama 等零费用模型正确标注 “(not reported by model)”，避免数据误解
## 潜在缺点与局限性
– **生态绑定**：专为 OpenClaw 目录结构设计，脱离该环境需手动指定 `–path`，通用性受限
– **依赖 Node.js**：运行环境要求已安装 Node，轻量级场景存在额外依赖成本
– **实时性限制**：仅分析已完成会话的日志文件，不支持实时监控或流式统计
– **模型定价内置**：若提供商调整价格或新增模型，需等待工具更新才能获得准确费用计算
– **轨迹文件排除**：明确跳过 `*.trajectory.jsonl`，此类数据需其他工具分析
## 适合人群
– **OpenClaw 重度用户**：需要追踪多代理、多模型的 API 支出分布
– **团队成本管理员**：需定期生成费用报告，按代理或项目分摊成本
– **LLM 应用开发者**：需要量化不同模型、不同提示策略的实际 Token 消耗与费用对比
– **CI/CD 集成场景**：通过 `–format json` 输出进行自动化成本告警或预算控制
## 常规风险
– **数据隐私**：扫描的日志文件包含完整会话内容，在多用户环境需确保目录权限正确
– **路径注入**：`–path` 参数接受任意目录路径，若被注入恶意路径可能读取非预期文件（虽无执行风险）
– **成本估算偏差**：工具依赖内置定价表，与真实账单可能存在微小差异，关键财务场景建议交叉核对
– **单会话查询性能**：跨代理搜索特定会话 ID 时，若代理数量极多可能存在 I/O 瓶颈
会员专属
