ClawCost 成本追踪器评估
核心用法
ClawCost 是专为 OpenClaw 智能体设计的轻量级成本监控工具,通过 Python 脚本实现精细化的 API 开销追踪。核心功能围绕三大维度展开:
实时监控:--budget 参数触发当日开销检查,输出包含余额状态、今日消耗、周累计、历史总览及模型分账的完整 JSON 数据。支持双时间维度模型拆分(models_today / models_alltime),便于识别消费热点。
余额管理:--set-balance 设定初始充值金额,系统自动计算剩余额度,形成"初始-已用-剩余"的闭环追踪。
可视化输出:采用树形符号(├└)构建层次化账单,配合 Emoji 状态标识(✅/⚠️/🚨),将原始数据转化为直觉友好的财务仪表盘。
显著优点
1. 预防性控制:四级预警机制(80%日预算/100%超支/低余额5$/未设置余额)将被动查询转为主动拦截
2. 模型级洞察:Sonnet/Haiku/Opus 三档费用占比透视,直接指导模型降级策略
3. 零外部依赖:纯本地 Python3 执行,不触碰网络端点,规避第三方数据泄露风险
4. 场景自适应:根据用户提问深度自动切换简略/详细模式,兼顾效率与信息密度
局限性与风险
- 单点存储:成本数据为本地文件,无云同步能力,多设备场景下数据碎片化
- 手工充值:余额设定依赖用户手动输入,无法对接 OpenClaw 官方 API 实现自动校准
- 历史窗口有限:仅保留7日每日明细,长期趋势分析能力不足
- 权限风险:脚本需读取本地成本日志文件,共享环境存在敏感信息暴露可能
适合人群
高频使用 OpenClaw API 的开发者、团队成本管理员、需要精细化预算控制的代理运维人员。尤其适合对模型调用成本敏感、希望主动优化 Token 消耗策略的技术用户。
常规风险
数据持久化依赖本地文件系统,建议配合定期备份;余额设定的人为疏漏可能导致预警失效,建议建立充值-设额的 SOP 复核流程。