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 瓶颈