Cost Tracking for Models

核心用法

Clawdbot Cost Tracker 是一款面向开发者和AI重度用户的成本监控工具，核心功能是从本地会话日志中提取真实的API费用数据（USD），而非依赖容易误导的token估算。

关键数据源：~/.clawdbot/agents/main/sessions/*.jsonl，其中每条API调用记录包含精确的usage.cost对象，涵盖input、output、cacheRead、cacheWrite分项费用。

典型工作流：
1. 快速查询：通过bash one-liner获取单日/昨日/累计费用
2. 脚本化提取：extract-cost.sh 支持多维度输出（--yesterday/--week/--date/--json）
3. 报告集成：将费用追踪嵌入HEARTBEAT.md，实现自动化日报

显著优点

• 数据准确性：直接读取Clawdbot内置的真实计费数据，规避了totalTokens字段因context compaction重置导致的统计失真
• 零配置成本：无需API密钥或外部服务，纯本地文件解析
• 灵活输出：支持纯文本、JSON格式，便于接入其他自动化流程
• 模型级细粒度：可拆分不同模型（Claude Opus/Sonnet、Codex等）的费用构成
• 本地化适配：内置中式财务配色约定（红涨绿跌）

潜在局限

• 环境依赖：依赖macOS/Linux date命令语法，跨平台需手动调整（已提供注释说明）
• 文件IO密集：大规模会话历史下，grep/awk循环处理可能存在性能瓶颈
• 无实时能力：基于离线日志，非流式监控，存在分钟级延迟
• 存储管理：历史快照需用户自行实现轮转策略，否则磁盘占用持续增长
• 模型定价硬编码：参考表格为静态文档，实际以API返回的cost字段为准

适合人群

• 使用Clawdbot进行高频AI交互的个人开发者/研究员
• 需要向团队/客户量化AI成本的技术负责人
• 追求财务可解释性的AI产品运营者
• 希望将AI费用纳入每日工作流报告的效率极客

常规风险

• 数据隐私：JSONL文件包含完整prompt/response内容，成本统计脚本可能意外暴露敏感信息
• 路径变更风险：Clawdbot未来版本可能调整sessions目录结构，导致脚本失效
• 精度误差：浮点累加（awk计算）在极端高频场景下可能产生分级偏差
• 误用风险：新手可能混淆extract-cost.sh与已废弃的snapshot-usage.js，导致错误结论

核心功能

Clawdbot Cost Tracker 是一款专为 Clawdbot 用户设计的本地成本监控工具，解决了一个关键痛点：官方 `sessions_list` 的 `totalTokens` 字段会因上下文压缩而重置，无法反映真实累积用量。该 Skill 直接读取 ~/.clawdbot/agents/main/sessions/*.jsonl 中的 API 原始计费数据，提供精确到美元分位的成本追踪。

显著优点

1. 数据源准确：绕过易失性的 token 计数，直接从 JSONL 文件提取含 cost.total 的真实计费对象，避免估算误差
2. 多维度分析：支持单日 (--yesterday)、指定日期 (--date)、本周 (--week)、全生命周期统计，以及按模型分组的成本拆解
3. 零外部依赖：核心逻辑基于 Bash 原生工具和 Node.js 内置模块，无 npm 包引入，供应链攻击面极小
4. 开箱即用：提供 extract-cost.sh 一键脚本，同时保留原始 grep/sed 命令供高级用户自定义

潜在局限

• JSON 解析脆弱性：使用 grep + sed 而非 jq 解析结构化数据，若 Clawdbot 变更日志格式可能导致提取失败
• 平台兼容性：日期计算命令区分 macOS (date -v-1d) 与 Linux (date -d)，需手动切换注释
• 废弃代码残留：snapshot-usage.js 等旧版脚本虽已标记 Deprecated，但仍存在于代码库，可能误导用户
• T3 来源信任度：个人开发者维护，无企业背书，建议结合代码审计后使用

适合人群

• 高频使用 Claude/Codex API 的开发者与团队
• 需要向管理层汇报 AI 支出的技术负责人
• 希望建立个人/团队 AI 预算监控体系的效率工具用户
• 具备基础 Shell 操作能力、能够处理 mild 脚本故障的用户

常规风险提示

• 仅读取本地文件，无网络外泄风险，符合 GDPR 数据最小化原则
• 建议定期备份 sessions 目录，防止历史成本数据丢失
• 定价表需手动更新以匹配厂商最新费率调整
• 依赖 Clawdbot 日志格式稳定性，重大版本升级后需验证兼容性