session-cost

核心功能与使用方式

Session Cost 是一款专为 OpenClaw 设计的本地日志分析工具，通过解析 ~/.openclaw/agents/main/sessions/ 目录下的 .jsonl 会话日志文件，提供详细的 Token 使用量、API 成本及性能指标分析。用户可通过 Node.js 运行时直接执行脚本，支持 --offset 时间过滤（如 24h、7d）、--provider 提供商筛选（anthropic/openai 等）以及 --details 详细模式查看单会话数据。

工具提供三种输出格式：友好的纯文本摘要（适合终端查看）、结构化的 JSON 数据（便于二次开发集成）以及 Discord 格式（优化用于聊天机器人展示）。特别值得注意的是，该工具精确计算了缓存读写 Token 的成本折扣，帮助用户发现潜在的降本空间。

显著优势

极致的本地安全性：脚本仅依赖 Node.js 内置模块（fs/path/os），无任何 npm 外部依赖，不发起网络请求，所有数据处理均在本地完成，彻底杜绝数据泄露风险。

精细化的成本核算：不仅统计基础输入输出 Token，还单独计算 Cache Read/Write 的折扣成本，提供按模型分组的多维度报表，支持识别高成本会话和模型使用模式。

灵活的集成能力：Discord 格式输出使其能无缝接入运维告警系统，JSON 格式便于导入 BI 工具进行长期趋势分析，而 Table 模式则适合快速终端排查。

局限性与注意事项

当前版本仅支持分析 main agent 的会话（硬编码路径），若使用多 agent 架构需手动指定 --path 参数。此外，工具专注于事后分析，不具备实时成本监控或预算告警功能。作为 T3 来源的社区工具，长期维护更新频率可能存在不确定性。

适用人群

该技能特别适合以下场景：使用 OpenClaw 进行多模型调用的开发团队需要分摊成本；AI 应用运维人员需要监控异常用量；财务管理人员需要定期导出 API 开支报表；以及个人开发者需要优化 Prompt 策略以降低 Token 消耗。

潜在风险提示

尽管安全评级为 A 级，但用户需注意：脚本运行需要读取本地文件系统权限，在多用户共享环境中应确保日志文件权限设置正确；虽然支持自定义路径，但需避免误将包含敏感信息的非日志目录作为分析目标；大规模历史数据分析（如超过 10GB 日志文件）可能消耗较多内存，建议在独立环境中执行。