核心用法
OpenClaw Cost Tracker 是一款本地成本分析工具，专为 OpenClaw 用户设计。通过直接读取 ~/.openclaw/agents/ 下的会话 JSONL 文件，提取 message.usage 和 message.model 字段，实现零外部依赖的成本追踪。
基础命令：
python3 scripts/cost_tracker.py— 全时段报告--days 7/--since 2024-02-01— 时间范围过滤--format json— 输出结构化数据用于仪表盘集成
输出维度：
- 模型级明细：各模型总成本、Token 拆分（输入/输出/缓存读/缓存写）、请求数、可视化占比条
- 每日消费：文本柱状图或 JSON 数组，支持趋势分析
- 汇总统计：跨模型总计成本、Token 量、请求数
显著优点
1. 零依赖安全：仅使用 Python 标准库，无第三方包风险，无需 API 密钥，杜绝凭证泄露
2. 本地原生：直接读取文件系统，不经过网络层，适合 air-gapped 环境
3. 性能优化：基于 mtime 快速过滤会话文件，大数据量下仍高效
4. 灵活集成：JSON Schema 标准化输出，可对接 Prometheus/Grafana、自建告警或预算系统
5. 模型透明：清晰拆分缓存读写 Token，便于优化 Claude/GPT 的 prompt caching 策略
潜在局限
- 格式绑定：依赖 OpenClaw 特定的 JSONL 会话格式，若上游变更需同步更新
- 离线局限：无法获取实时 API 定价，需内置或手动更新费率表
- 非实时：基于本地会话文件，存在写入延迟，非实时计费精度
- 单用户视角：仅分析本地数据，无法聚合团队多设备消费
适合人群
- 高频使用 Claude/GPT API 的开发者与团队
- 需要成本可视化的预算管控场景
- 隐私敏感、拒绝云端成本分析工具的用户
- 希望将 AI 消费纳入现有监控体系的运维人员
常规风险
| 风险类型 | 说明 | 缓释措施 |
|---------|------|---------|
| 数据完整性 | 会话文件可能因崩溃未 flush 而丢失记录 | 结合 API 账单定期交叉校验 |
| 费率漂移 | 内置费率与官方定价不同步 | 建立定价更新机制，设置成本偏差告警阈值 |
| 权限暴露 | 需读取用户目录下会话文件 | 确保文件权限 600，避免多用户共享环境 |
| 误删风险 | 工具不修改源文件，但扫描过程可能触发某些安全软件 | 在受信环境运行，避免实时扫描生产目录 |