精准追踪 OpenClaw 使用成本,支持多维度报告生成,通过 jq 直接解析会话日志,为团队提供透明化的 AI 支出管理。
说明:
## 核心用法
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 或明确标注时区 |








