SuperAPI AI 工具集

heartbeat-governor

部署与运维

查看项目

更新于 10-15 19:57

技能介绍

用途:Heartbeat Governor 针对自主运行的 cron 技能进行预算管控。带缺陷的技能(无限重试、超大上下文、循环中调用模型)可能在被发现前就消耗大量费用,该工具用于跟踪并阻断这类超支。

主要能力:按技能跟踪滚动 30 天的累计执行成本与墙钟时间;预算项包括 max_usd_monthly(默认 $5.00)、max_usd_per_run(默认 $0.50)、max_wall_minutes(默认 30)、max_runs_daily(默认 48),均可按技能配置。超支动作:月花费超限则暂停技能、记录并告警;单次花费或墙钟超限则中止当前运行并记录;日运行次数超限则跳过当日剩余运行并记录。每小时运行一次 --check 以在一个 cron 周期内捕获超支。

使用方式(命令保持原样): python3 governor.py --status python3 governor.py --record <skill> --usd 0.12 --minutes 4 python3 governor.py --pause <skill> python3 governor.py --resume <skill> python3 governor.py --set-budget <skill> --monthly 10.00 python3 governor.py --check python3 governor.py --report python3 governor.py --format json 建议安装新 cron 技能后显式设置月预算,定期查看 --status 的利用率,超过 80% 时排查;技能被暂停后需先调查原因再 --resume。状态存于 ~/.openclaw/skill-state/heartbeat-governor/state.yaml,含 skill_ledgers、paused_skills、breach_log、monthly_summary。

适用场景:定时技能的费用与时长监控、API 账单异常上涨时的人工排查。限制:资料未说明适配的技能框架与运行环境细节,具体效果暂未提供。