核心用法
Session Cost 是一款面向 OpenClaw 用户的 CLI 成本分析脚本，用于解析 ~/.openclaw/agents/main/sessions/ 目录下的 .jsonl 会话日志，按模型聚合统计 Token 使用量、缓存读写及费用明细。支持时间范围过滤（如 --offset 24h）、提供商筛选（--provider anthropic）、单会话详情（--details <id>）及表格视图（--table）。
显著优点
- 多格式输出：原生支持
text、json、discord三种格式，便于集成到自动化流水线或聊天机器人； - 精细化成本拆分：不仅展示总费用，还细分 input/output/cache read/cache write 四项成本；
- 缓存感知：专门统计 Anthropic 等平台的缓存 Token 折扣，准确反映实际扣费；
- 零配置快速启动：默认扫描主代理会话目录，一条命令即可生成完整报告。
潜在缺点与局限性
- 路径硬编码：目前仅限
main代理，自定义多代理场景需手动指定--path； - Node.js 依赖：要求系统预装 Node 运行时，无独立二进制分发；
- 离线分析：仅解析本地日志，无法实时对接 OpenClaw 云端账单 API；
- 模型定价维护：费用计算依赖内置费率表，新模型或调价需手动更新脚本。
适合人群
- 需要监控多模型 API 支出的开发者与团队；
- 运营 Discord/Slack Bot 并希望自动推送每日/每周用量摘要的管理员；
- 对 Token 效率敏感、需优化提示词成本的 AI 应用架构师。
常规风险
- 日志隐私：分析过程中会读取本地会话文件，可能包含敏感提示词内容，建议在受控环境运行；
- 费用估算偏差：缓存命中率、模型版本差异可能导致实际账单与估算存在 5-15% 误差；
- 路径遍历风险：若
--path指向不受信目录，需警惕恶意构造的 JSONL 文件引发的解析异常。