核心用法
OpenClaw Cost Tracker 是一款专为 OpenClaw 用户设计的成本追踪工具，通过解析本地会话日志文件（~/.openclaw/agents/*/sessions/*.jsonl），提取 message.usage.cost.total 字段，实现精确的 API 调用成本统计。
功能特性
- 多时间维度报告：支持当日、昨日、本周、本月及自定义日期范围的成本查询
- 模型级细分：按模型类型（如 claude-opus-4-5、gpt-4o 等）拆分成本占比
- Discord 友好输出：格式化输出适合即时通讯渠道分享
- 周环比/月环比分析：自动计算成本变化趋势
技术实现
依赖 jq 工具进行高效的 JSON 流式解析，确保大数据量下的处理性能。成本计算基于实际 API 返回的 usage 数据，而非估算值。
显著优点
1. 数据源权威直接：从官方会话日志提取，避免第三方统计误差
2. 零配置即开即用：仅需安装 jq，无需额外认证或网络配置
3. 团队协作友好：Discord 格式输出便于成本透明化共享
4. 轻量无侵入：纯 Bash 脚本实现，不修改 OpenClaw 核心行为
潜在局限
- 仅支持本地日志解析，无法追踪多设备分布式使用情况
- 依赖 OpenClaw 日志格式稳定性，若官方变更字段结构需更新脚本
- 无实时预警功能，需手动执行查询
- 历史数据 retention 受本地存储限制
适合人群
- 需要精确控制 AI 预算的个人开发者
- 追求成本透明化的技术团队
- 使用 Discord 进行团队协作的远程团队
- 需要向管理层汇报AI 支出的技术负责人
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 数据隐私 | 成本数据含模型使用模式信息 | 避免在公共频道分享敏感时段报告 |
| 日志完整性 | 手动删除日志导致统计遗漏 | 建立日志备份机制 |
| 时区差异 | 跨时区团队日期边界可能不一致 | 统一使用 UTC 或明确标注时区 |