메뉴
Enforces per-skill execution budgets for scheduled cron skills — pauses runaway skills that exceed their token or wall-clock budget before they drain your monthly API allowance.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | heartbeat-governor |
| version | 1.0 |
| category | openclaw-native |
| description | Enforces per-skill execution budgets for scheduled cron skills — pauses runaway skills that exceed their token or wall-clock budget before they drain your monthly API allowance. |
| stateful | true |
| cron | 0 * * * * |
Cron skills run autonomously. A skill with a bug — an infinite retry, an unexpectedly large context, a model call inside a loop — can silently consume hundreds of dollars before you notice.
Heartbeat Governor tracks cumulative execution cost and wall-clock time per scheduled skill on a rolling 30-day basis. When a skill exceeds its budget, the governor pauses it and sends an alert. The skill won't fire again until you explicitly review and resume it.
It runs every hour to catch budget overruns within one cron cycle.
| Budget type | Default | Configurable |
|---|---|---|
max_usd_monthly | $5.00 | Yes, per skill |
max_usd_per_run | $0.50 | Yes, per skill |
max_wall_minutes | 30 | Yes, per skill |
max_runs_daily | 48 | Yes, per skill |
| Breach type | Action |
|---|---|
monthly_usd exceeded | Pause skill, log breach, alert |
per_run_usd exceeded | Abort current run, log breach |
wall_clock exceeded | Abort current run, log breach |
daily_runs exceeded | Skip remaining runs today, log |
python3 governor.py --status # Show all skills and budget utilisation
python3 governor.py --record <skill> --usd 0.12 --minutes 4 # Record a run
python3 governor.py --pause <skill> # Manually pause a skill
python3 governor.py --resume <skill> # Resume a paused skill after review
python3 governor.py --set-budget <skill> --monthly 10.00 # Override budget
python3 governor.py --check # Run hourly check (called by cron)
python3 governor.py --report # Full monthly spend report
python3 governor.py --format json
Every hour the governor runs --check:
paused: false:
max_usd_monthly → paused: true, logmax_runs_daily → skip, logStep 1 — Set sensible budgets
After installing any new cron skill, set its monthly budget:
python3 governor.py --set-budget daily-review --monthly 2.00
python3 governor.py --set-budget morning-briefing --monthly 3.00
Defaults are conservative ($5/month) but explicit is better.
Step 2 — Monitor utilisation
python3 governor.py --status
Review the utilisation column. Any skill above 80% monthly budget warrants investigation.
Step 3 — Respond to pause alerts
When the governor pauses a skill, investigate why it's over budget:
Resume after investigating:
python3 governor.py --resume <skill>
Per-skill ledgers and pause flags stored in ~/.openclaw/skill-state/heartbeat-governor/state.yaml.
Fields: skill_ledgers map, paused_skills list, breach_log, monthly_summary.
Handles PR review feedback by fetching comments, grouping issues, fixing one group at a time, and verifying before replies.
Reviews whether a skill will trigger reliably, guide useful behavior, avoid overlap, and produce testable outcomes.
Diagnoses OpenClaw provider, fallback, channel, MCP, and gateway config issues with read-only scans and stateful summaries.
Tracks required validation gates, records pass/fail/waived results, and reports readiness before task completion.
YAML-based delegation grant ledger — issues, validates, and tracks scoped permission grants for sub-agent expansions with token budgets and auto-expiry.
Walks the memory DAG to recall detailed context on demand — query, expand, and assemble cited answers from hierarchical summaries without re-reading raw transcripts.