openclaw-cost-tracker

OpenClaw Cost Tracker 是一款专为 OpenClaw 用户设计的本地成本分析工具，旨在帮助开发者和团队精准追踪 AI 模型的使用成本。该技能通过直接解析本地会话日志文件，提取详细的成本数据并生成结构化的报告，完全在本地环境运行，确保敏感的成本数据不会离开用户设备。

核心用法方面，用户安装 jq 工具后，可通过简单的命令行参数调用不同的报告模式。技能支持生成日报（今日/昨日）、周报（本周总计及环比）、月报（本月总计及同比增长）以及自定义日期范围的报告。脚本会自动扫描 ~/.openclaw/agents/*/sessions/*.jsonl 路径下的日志文件，使用 jq 精确提取 message.usage.cost.total 字段，按日期和模型类型分组统计，确保每笔 API 调用成本只被计算一次。输出支持标准文本和 Discord 富文本格式，便于团队在协作平台直接分享。

显著优点体现在其架构设计上。首先，纯本地运行的模式从根本上杜绝了数据泄露风险，所有成本信息均在用户设备上处理。其次，工具零外部依赖，仅需要系统标准的 jq、bash 和 bc 工具，无需安装沉重的 npm 包或第三方服务。此外，报告维度丰富，不仅能展示总成本，还能按 claude-opus-4-5、gpt-4o 等具体模型细分占比，帮助用户识别成本来源。MIT 许可证保证了代码的透明度和可审计性。

潜在缺点主要包括生态局限性。该技能专为 OpenClaw 设计，无法兼容其他 AI 平台的数据格式。同时，它依赖于本地日志文件的存在，若日志被清理或权限设置不当将无法工作。作为 T3 来源的社区工具，虽然代码通过安全审计，但用户仍需自行承担审查责任。此外，工具目前仅支持 macOS 和 Linux 系统，Windows 用户无法直接使用。

适合的目标群体包括：OpenClaw 的重度使用者，特别是需要监控多模型成本的开发者；注重数据隐私、偏好本地处理方案的敏感行业团队；使用 Discord 进行日常协作且需要定期成本报告的技术团队；以及希望精细化管控 AI 预算的中小企业。

使用风险主要集中在权限管理和性能考量上。技能需要读取 ~/.openclaw/agents 目录下的日志文件，用户需确保文件权限设置正确，避免无意中暴露其他敏感数据。虽然 cli.js 使用 execSync 执行脚本时已对参数进行转义处理，但仍建议验证输入源的可信度。当日志文件体积过大时，jq 解析可能会消耗较多内存和 CPU 资源，建议在低峰期运行报告生成任务。