Cost Tracking for Models

核心用法

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 或明确标注时区 |

核心用法

OpenClaw Cost Tracker 是一款专为 OpenClaw 用户设计的本地费用统计工具。其核心功能是从 ~/.openclaw/agents/*/sessions/*.jsonl 会话日志中提取费用数据，通过 jq 解析 JSON 中的 message.usage.cost.total 字段，按日期和模型维度聚合生成精确的费用报告。

支持多种报告周期：

• 日报：当日/昨日费用对比（带涨跌百分比）
• 周报：本周总计及环比上周变化
• 月报：本月总计及月度环比
• 自定义范围：指定起止日期的灵活查询

输出格式针对 Discord 等消息渠道优化，包含 emoji 标识、模型占比、可视化分隔线，便于团队共享和成本监控。

显著优点

1. 完全本地化：无网络请求，所有数据处理和计算均在本地完成，隐私零泄露风险
2. 轻量依赖：仅需系统工具 jq（JSON 解析）和 bc（计算），无 npm 第三方包，供应链攻击面极小
3. 精确计费：直接读取 API 返回的 cost 字段，非估算值，确保费用统计准确
4. 多维度分析：支持按模型拆分（claude-opus-4-5、gpt-4o 等），便于识别高成本调用来源
5. Discord 友好：输出格式针对即时通讯场景优化，支持直接复制粘贴分享

潜在缺点与局限性

1. 数据来源受限：仅支持 OpenClaw 官方日志格式，其他平台或自定义代理工具无法兼容
2. 环境依赖：强制依赖 jq，Windows 用户需额外配置（WSL 或手动安装）
3. 无实时同步：基于日志文件的离线分析，无法做到实时费用预警
4. 历史数据局限：若未保留历史会话日志，无法进行跨月长期趋势分析
5. T3 来源可信度：当前无明确 GitHub 仓库来源，属于个人/社区项目级别

适合人群

• OpenClaw 重度用户：需要精细化追踪多模型调用成本的个人或团队
• Discord 社群运营者：希望在频道内定期同步 AI 工具使用成本的社区管理员
• 成本敏感型开发者：需要按周/月维度监控 API 支出，优化预算分配
• 隐私优先用户：拒绝将费用数据上传至第三方 SaaS 工具的本地主义倡导者

常规风险

• 日志文件权限：需确保对 ~/.openclaw/ 目录的读取权限，否则报告为空
• 日志轮转清理：若 OpenClaw 自动清理旧日志，历史数据将不可追溯
• 时区处理：跨日期边界的会话可能因时区配置导致统计偏差
• 模型名称变更：上游模型 ID 变更可能导致分类聚合异常