clawcost

ClawCost 是一款专为 OpenClaw 代理用户设计的本地化成本追踪工具，由社区开发者 shallify 开发维护。该工具通过解析 OpenClaw 生成的会话日志，为用户提供实时的 AI 使用成本监控与预算管理服务。

核心用法
ClawCost 通过命令行界面运作，用户可通过 python3 clawcost.py --budget 10 查看当前成本状态，或使用 --set-balance 50.00 设置初始账户余额。工具自动计算剩余金额（初始余额减去总支出），并以直观的树形结构展示关键指标：账户余额、今日支出及预算占比、本周累计消费、历史总成本与令牌消耗量。针对多模型使用场景，ClawCost 提供按模型细分的成本分析（如 Sonnet、Haiku、Opus 的使用占比），帮助用户识别高成本模型。

显著优点
该工具最大优势在于其纯粹的本地化架构。所有数据处理均在用户设备完成，无需网络连接，杜绝了 API 密钥或成本数据外泄的风险。功能设计注重实用性：当单日支出超过预算 80% 时触发预警，超过 100% 时发出超支警报，并在余额不足 5 美元时提示充值。输出界面采用友好的树形符号与 emoji 结合，降低数字疲劳。此外，工具仅依赖 Python 3 标准库（json、glob、pathlib 等），零外部依赖确保了跨平台兼容性和长期稳定性。

潜在缺点与局限性
作为 T3 级个人开发者作品，ClawCost 缺乏大型企业或基金会的背书与长期维护保障。功能层面，工具仅支持单机使用，无法实现跨设备数据同步，不适合需要团队协作成本审计的企业场景。其紧密依赖 OpenClaw 特定的日志文件格式（~/.openclaw/agents/main/sessions/*.jsonl），若 OpenClaw 更新日志结构可能导致功能失效。此外，预算控制为被动提醒机制，无法主动拦截超支行为。

适合的目标群体
该工具最适合个人开发者、自由职业者及小型团队中的 OpenClaw 重度用户，特别是那些需要精细控制 AI API 成本、关注不同模型性价比的技术人群。对于希望培养成本意识、避免开发阶段意外产生高额账单的用户尤为实用。不适用于需要企业级 SSO 集成、多账户聚合或复杂审批流程的大型组织。

使用风险
主要风险集中在本地文件操作：工具需要读取 OpenClaw 会话日志并读写 ~/.clawcost/config.json 配置文件，虽然经过安全审计，但用户仍需确保文件权限设置正确，避免配置文件被恶意篡改导致预算数据失真。此外，工具依赖手动设置的初始余额，若用户忘记更新充值记录，剩余金额计算将产生偏差。建议用户定期核对实际账单与工具显示数据，并将预算阈值设置为比实际承受力更保守的数值，以预留安全缓冲。