Session Cost

核心用法

Session Cost 是 OpenClaw 生态专用的 CLI 成本分析工具，用于解析代理会话日志（~/.openclaw/agents/main/sessions/ 下的 .jsonl 文件），按模型维度聚合统计 Token 使用量、缓存命中率及 API 费用。支持时间窗口过滤（如 --offset 24h）、服务商筛选（Anthropic/OpenAI/Ollama 等）、单会话详情追溯及多种输出格式（文本/JSON/Discord 友好格式）。

显著优点

1. 精细化成本洞察：区分输入/输出/缓存读/缓存写四类计费维度，准确反映 Anthropic 缓存折扣机制
2. 多场景输出适配：原生支持 Discord 机器人集成、JSON 数据管道及可读性表格三种形态
3. 零配置即开即用：默认路径自动解析，Node.js 单文件脚本，无外部依赖
4. 灵活时间切片：支持分钟/小时/天级偏移量快速回溯，便于周期性对账

潜在缺点与局限性

• 作用域受限：当前仅支持 main Agent，多 Agent 场景需手动指定 --path
• 定价模型静态：内置费率表需随服务商调价手动更新，无实时 API 拉取
• Ollama 等本地模型：成本计算可能失效或显示为零，需用户自行校验
• 无持久化数据库：纯文件扫描，大数据量时性能取决于磁盘 I/O

适合人群

• 需要向团队/客户量化 AI 使用成本的工程管理者
• 运行 Discord/Slack 机器人并需自动汇报开销的社区运营者
• 希望优化 Prompt 缓存策略以降低 Anthropic 账单的技术团队

常规风险

• 数据隐私：日志文件包含完整对话内容，分析时需确保路径权限管控
• 费用预估误差：缓存计费规则复杂，实际账单可能与估算存在微小偏差
• 路径遍历风险：--path 参数若指向不可信目录，可能意外暴露敏感日志