核心用法
ClawCost 是一款专为 OpenClaw Agent 设计的成本追踪工具，通过本地 Python 脚本实时聚合 API 调用费用数据。用户执行 python3 clawcost.py --budget 10 即可获取完整的消费视图，包括当日/本周支出、累计总费用、各模型（Sonnet/Haiku/Opus）成本占比，以及近 7 日每日消费曲线。支持通过 --set-balance 设置初始余额，系统自动计算剩余金额。
显著优点
1. 预算可控性：预设日预算阈值，超支 80% 触发 ⚠️ 预警，超 100% 弹出 🚨 紧急提示，强制用户感知成本
2. 模型粒度洞察：区分 Claude 3 各档位模型消费占比，辅助用户识别「性价比盲区」（如 Sonnet 占比过高时建议切 Haiku）
3. 可视化友好：树形层级输出 + 进度条式百分比，3 秒扫读关键信息；支持余额低提示（< $5）和设置引导
4. 零外部依赖：纯本地脚本运行，不传输敏感消费数据至第三方
潜在局限
- 手动初始化：需用户主动设置初始余额，无自动充值/账单同步能力
- 单会话统计：累计数据依赖本地存储，多设备/重装后历史丢失
- OpenClaw 专属：仅适配 OpenClaw 的日志格式，不兼容标准 OpenAI/Anthropic 账单
适合人群
- 高频使用 Claude 3 API 的开发者与自动化工作流搭建者
- 需要向团队/客户汇报 AI 调用成本的项目经理
- 希望建立「用前检查」习惯、避免月底账单惊吓的个人用户
常规风险
- 余额误设：用户输入错误初始值导致剩余金额计算失真，建议首次设置后核对平台账单
- 预算麻痹：固定日预算可能忽略突发高成本任务（如批量文档分析），需结合周维度交叉验证
- 脚本权限：{baseDir}/scripts 路径需正确配置，硬编码路径可能导致多项目环境冲突