用途:OpenClaw 本身没有内置的硬性支出上限,该技能通过监控会话日志估算累计 API 成本,在达到阈值时提醒,并在月度预算触顶时自动暂停非必要的 cron 自动化。
主要能力:按模型与 token 数量结合价格表估算花费;支持设置月度预算与提醒阈值;按阈值执行不同动作(低于 50% 静默记录,≥50% 通知,≥75% 通知并建议暂停哪些 cron 技能,≥100% 通知并自动暂停除 daily-review、morning-briefing 和本技能自身外的所有 cron 技能);每月 1 日重置花费为 0;达到 100% 时写入 circuit_open: true,install.sh 在注册新 cron 任务前会检查该标志。
使用方式:首次运行需记录预算,例如 python3 check.py --set-budget 50 设置每月 50 美元硬上限,python3 check.py --set-alert 0.5 0.75 设置 50% 和 75% 提醒。技能每 4 小时运行一次(cron: "0 */4 * * *"),读取 ~/.openclaw/skill-state/spend-circuit-breaker/state.yaml 中的 monthly_budget_usd 与 spend_this_month_usd,解析 ~/.openclaw/sessions/ 下的会话日志估算新增花费,更新状态并应用阈值逻辑。恢复自动化可运行 python3 check.py --reset-circuit,将 circuit_open 设为 false 并重新注册所有被暂停的 cron 任务。添加自定义模型可用 python3 check.py --add-model my-model-name --input-cost 3.00 --output-cost 15.00,价格按每百万 token 计。
适用场景:需要对 OpenClaw 的 API 花费进行预算控制、避免超支并自动降级非关键自动化任务的用户。
限制:依赖会话日志与内置价格表估算,可能不精确;仅针对 cron 调度的技能生效;具体平台与收费信息暂未提供。