核心用法
Session Cost 是一款专为 OpenClaw 用户设计的会话日志分析脚本，用于精准追踪 AI API 调用产生的 Token 用量与费用支出。工具通过解析 ~/.openclaw/agents/main/sessions/ 目录下的 .jsonl 日志文件，按模型维度聚合统计，生成清晰的成本报表。
主要功能：
- 多维度筛选：支持按时间窗口（
--offset 30m/2h/7d）、模型供应商（--provider anthropic/openai/ollama）、自定义路径灵活过滤 - 多格式输出：Text（人类友好）、JSON（机器可读）、Discord（聊天平台优化）三种格式
- 详情穿透：
--details展示单会话粒度数据，--table提供紧凑表格视图 - 缓存成本识别：单独拆分 Cache read/write 的折扣计费，避免成本盲区
显著优点
1. 成本透明化：将分散的 JSONL 日志转化为可行动的财务洞察，特别适合多模型混用场景
2. 零配置开箱即用：默认读取标准 OpenClaw 目录，Node.js 单脚本无依赖
3. 平台适配：Discord 格式原生支持机器人集成，方便团队成本公示
4. 性能友好：本地文件解析，无需上传敏感日志到第三方服务
潜在局限
- 路径硬编码：当前仅支持
mainagent，其他 agent 需手动指定--path - 定价静态：依赖内置模型价格表，若供应商调价需同步更新脚本
- 无实时监控：离线批处理工具，非实时仪表盘
- 无趋势对比：缺少跨周期成本波动分析功能
适合人群
- AI 应用开发者：需要量化调试阶段的 API 消耗
- 技术团队负责人：定期审计团队模型使用成本
- 个人重度用户：追踪月度/项目级 AI 支出预算
常规风险
- 数据隐私：虽本地处理，但日志包含完整 Prompt 内容，需确保运行环境安全
- 成本误差：缓存命中率、特价 Tier 等边缘场景可能导致统计与账单微小偏差
- Node 版本依赖：未明确最低 Node 版本，老旧环境可能遇到语法兼容问题