openclaw-cost-tracker

💰 精准追踪 AI 成本的本地管家

OpenClaw 官方推出的本地成本分析工具,通过解析会话日志精准计算 AI 调用成本,生成多维度报告助力团队成本管控,全程离线处理保障数据隐私。

收藏
5.6k
安装
2.1k
版本
v1.0.0
CLS 安全性认证2026-06-05
点击查看完整报告 >

使用说明

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 资源,建议在低峰期运行报告生成任务。

安全解读

核心用法

OpenClaw Cost Tracker是一款专为OpenClaw用户设计的本地化成本监控工具。核心功能是通过jq工具解析~/.openclaw/agents/*/sessions/*.jsonl格式的会话日志,提取message.usage.cost.total字段进行精确计费统计。

使用方式

  • 日报模式:--today/--yesterday 快速查看单日花费
  • 周报模式:--week 对比本周与上周支出趋势
  • 自定义范围:--from YYYY-MM-DD --to YYYY-MM-DD 灵活查询

输出支持Discord友好的格式化报告,包含模型维度细分(如claude-opus-4-5、gpt-4o等)、占比分析和环比变化指示。

显著优点

1. 零隐私风险:100%本地处理,无网络外发,符合GDPR/CCPA数据最小化原则
2. 供应链极简:仅依赖系统工具jq/bc,零npm第三方包,CVE暴露面为零

3. 来源可信:GitHub组织clawdbot维护,T2级可信组织认证,版本历史完整

4. 成本可视化:自动计算模型维度占比、日/周/月趋势对比,助力预算管控

潜在局限

  • 平台限制:仅支持macOS(darwin)和Linux,Windows未适配
  • 依赖预装:需手动安装jq(brew install jqapt install jq
  • 数据源单一:仅支持OpenClaw官方日志格式,其他Claude客户端不兼容
  • 权限要求:需读取用户主目录下的会话文件,多用户场景需额外配置

适合人群

  • 高频使用OpenClaw API的个人开发者/团队
  • 需要精细化成本拆分(按模型、按日期)的预算管理者
  • 对数据隐私敏感、拒绝云端账单工具的企业用户
  • Discord社区运营者(内置格式化输出适合机器人推送)

常规风险

| 风险项 | 等级 | 说明 |
|--------|------|------|
| 命令注入 | 中 | cli.js使用`execSync`调用shell脚本,虽参数已转义但存在理论注入面 |
| 本地文件读取 | 低 | 功能必需的只读访问,无写入操作,符合最小权限 |
| 系统工具依赖 | 低 | jq/bc缺失会导致功能失效,但不会引发安全问题 |

缓解建议:Skill调用场景风险可控;若直接CLI使用,建议按报告推荐改用execFile数组传参模式彻底消除注入风险。

openclaw-cost-tracker 内容

config文件夹
references文件夹
scripts文件夹
手动下载zip · 9.6 kB
cron-examples.jsonapplication/json
请选择文件