Files
openclaw/docs/reference/templates/HEARTBEAT.md
Peter Steinberger f43fac21c7 fix(gateway): stop showing retired HEARTBEAT.md in the agent files editor (#113621)
* fix(gateway): drop retired HEARTBEAT.md from agent core files

* fix(ci): stop asserting retired HEARTBEAT.md in docker release smoke

* docs: align HEARTBEAT.md references with cron scratch

* docs(agents): drop retired HEARTBEAT.md from workspace read comment
2026-07-25 04:58:31 -07:00

1.1 KiB

summary, title, read_when
summary title read_when
Migration guide for the retired HEARTBEAT.md workspace file Retired HEARTBEAT.md workspace file
Migrating an older workspace that still has HEARTBEAT.md

HEARTBEAT.md is retired

OpenClaw no longer creates HEARTBEAT.md in new workspaces or reads it at runtime. Heartbeat instructions now live in the system-owned monitor's cron scratch in the shared state database.

Manage the current scratch with the monitor job id from openclaw cron list --all:

openclaw cron scratch <jobId>
openclaw cron scratch <jobId> --set "..."
openclaw cron scratch <jobId> --file notes.md
openclaw cron scratch <jobId> --unset

If an older workspace still contains HEARTBEAT.md, run openclaw doctor --fix. Doctor imports its instructions into monitor scratch, converts valid legacy tasks: entries into cron jobs, archives the original under the state directory, and removes the workspace file.