OpenClaw 智能成本管家

精准追踪 OpenClaw 使用成本，支持多维度报告生成，通过 jq 直接解析会话日志，为团队提供透明化的 AI 支出管理。

基本信息

• 技能名称?Cost Tracking for Models
• 中文名称?OpenClaw 智能成本管家
• 作者?vincentqiu
• 分类?专业技能
• 版本?1.0.2
• 标签?cost-management, openclaw, budget-tracking, reporting, cli-tool, discord-integration

使用方法

使用说明
核心用法
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 或明确标注时区 |