mirror of
https://github.com/openclaw/openclaw.git
synced 2026-08-03 17:41:37 +00:00
Each legacy heartbeat tasks: entry becomes an editable system-created cron job (declaration key heartbeat-task:<agentId>:<hash>, per-occurrence identity for duplicate names) that fires a guarded heartbeat wake carrying the task prompt plus current monitor scratch context. Task cadence is now independent of the base heartbeat interval; active-hours, busy-retry, min-spacing, and flood guards are preserved, deferred payload-carrying wakes are retained and retried after the spacing floor, and colliding task/event wakes cannot starve each other. openclaw doctor --fix migrates existing blocks: async parse/plan, then one synchronous SQLite transaction that rereads the pinned scratch revision, upserts job rows, and strips the tasks: block atomically — concurrent doctors serialize on the database and a losing run aborts untouched. Orphan fields, invalid intervals, and incomplete entries block migration of their block with a clear finding instead of silent text loss. The runtime tasks: parser is deleted; leftover text is ordinary scratch prose. Nine Codex gpt-5.6-sol xhigh autoreview cycles; final verdict clean.
1.3 KiB
1.3 KiB
summary, title, read_when
| summary | title | read_when | |
|---|---|---|---|
| Workspace template for HEARTBEAT.md | HEARTBEAT.md template |
|
HEARTBEAT.md template
HEARTBEAT.md lives in the agent workspace and holds the periodic heartbeat checklist. Keep it empty, or with only whitespace, Markdown comments, ATX headings, empty list stubs (- , * [ ]), or fence markers, to make OpenClaw skip the heartbeat model call entirely (reason=empty-heartbeat-file).
Shipped default content:
<!-- Heartbeat template; comments-only content prevents scheduled heartbeat API calls. -->
# Keep this file empty (or with only comments) to skip heartbeat API calls.
# Add a short checklist below when the heartbeat should inspect shared context.
Add a short checklist below the comment lines only when one heartbeat turn should inspect the items together. Keep it small: heartbeat runs read this file every tick (default every 30 minutes), so bloated instructions burn tokens on every wake.
For independently scheduled or due-only checks, create cron jobs. Heartbeat scratch no longer supports scheduler syntax. Run openclaw doctor --fix to convert older tasks: blocks.