核心用法
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，导致错误结论