核心用法
Clawdbot Cost Tracker 是一款专为 AI 模型 API 成本管理设计的追踪工具，主要服务于需要精细化监控 Clawdbot 会话代币消耗的用户。
数据获取：通过 sessions_list 命令提取会话的 totalTokens 和 model 字段，获取基础用量数据。
成本计算：内置主流模型定价表（Claude Opus $15/$75、Sonnet $3/$15、Codex-mini $1/$5、GPT-4o $2.5/$10、GPT-4o-mini $0.15/$0.6），采用 30% 输入/70% 输出的行业通用比例估算费用。
快照管理：支持将每日用量存档至 memory/usage/YYYY-MM-DD.json，便于跨期对比和趋势分析。
自动化脚本：提供 snapshot-usage.js 和 calculate-cost.js 两个 Node.js 脚本，实现用量快照创建和指定日期范围的成本计算。
显著优点
- 多模型支持：覆盖 Anthropic、OpenAI 两大主流厂商的高频使用模型
- 轻量集成：通过标准 JSON 文件持久化，无需外部数据库
- 财务可视化：遵循中文市场惯例（红涨绿跌）的颜色规范，便于报表阅读
- 日报就绪：内置 HEARTBEAT.md 集成模板，快速嵌入现有工作流
潜在局限
- 估算误差：固定 30/70 输入输出比例可能与实际会话分布存在偏差，高精度场景需真实比例数据
- 手动触发：依赖用户主动执行
sessions_list和脚本，非实时流式监控 - 模型覆盖有限：未包含 Gemini、Llama 等开源/竞品模型定价
- 汇率缺失：纯美元计价，无本币转换或含税计算
适合人群
- 个人开发者及小团队：需要基础成本意识，无需企业级 FinOps 平台
- 内容运营/社区管理员：管理 Discord 等渠道的 Clawdbot 机器人用量
- 预算敏感型项目：需要快速估算 AI 支出以控制 burn rate
常规风险
- 数据精度风险：API 返回的
totalTokens可能因缓存延迟或计费粒度与实际账单存在差异 - 定价变动风险：模型定价表为静态配置，厂商调价后需手动更新
- 存储风险：本地 JSON 文件存在丢失或权限问题，建议配合版本控制或备份策略