Docs › OpenClaw

OpenClaw

OpenClaw agents run continuously and call tools in loops. RunVouch treats each scheduled task or heartbeat window as a run, so polling loops and runaway spend show up within minutes.

Heartbeat pattern

rv agent openclaw-main --cadence 15m --grace 5m --cap-day-cost 10
# from a cron on the OpenClaw host, every 15 min:
rv run openclaw-main -- curl -fsS http://127.0.0.1:18789/health

If the gateway stops answering, MISSED/FAILED fires. Add a daily cap to catch the "$150 polling loop".

Per-task runs via the HTTP API

curl -X POST https://api.runvouch.com/v1/runs/start -H "X-API-Key: $RUNVOUCH_KEY" -d '{"agent":"openclaw-inbox","source":"openclaw"}'
# … tool events … then
curl -X POST https://api.runvouch.com/v1/runs/end -H "X-API-Key: $RUNVOUCH_KEY" -d '{"run_id":"…","status":"ok","cost":0.21,"evidence":{"replied":true}}'

Or install the RunVouch skill: copy SKILL.md into your OpenClaw skills directory (~/.openclaw/skills/runvouch/). It teaches the agent to check in at start, per tool call and at the end, with evidence.

The verified-run skill for scheduled tasks

For a task on a schedule, install verified-run: it wraps the task in start-run, task, end-run with the output file as evidence, and reports fail when the file is missing. Copy integrations/openclaw/verified-run into ~/.openclaw/skills/ (skill file: SKILL.md, wrapper: verified-run.sh), set RUNVOUCH_KEY, then:

0 7 * * * ~/.openclaw/skills/verified-run/scripts/verified-run.sh inbox-digest --every 24h --grace 30m --evidence-file ~/out/digest.md -- openclaw task run inbox-digest

Install steps, plugin manifest and the companion skill: github.com/runvouch/runvouch/tree/main/integrations/openclaw, and the integration page.


Need a key? Get a free key · Stuck? contact