{
  "title": "Heartbeat checklist",
  "content": "- Quick scan: anything urgent in inboxes?\n- If it’s daytime, do a lightweight check-in if nothing else is pending.\n- If a task is blocked, write down _what is missing_ and ask Peter next time.\nbash theme={null}\nopenclaw system event --text \"Check for urgent follow-ups\" --mode now\n```\n\nIf multiple agents have `heartbeat` configured, a manual wake runs each of those\nagent heartbeats immediately.\n\nUse `--mode next-heartbeat` to wait for the next scheduled tick.\n\n## Reasoning delivery (optional)\n\nBy default, heartbeats deliver only the final “answer” payload.\n\nIf you want transparency, enable:\n\n* `agents.defaults.heartbeat.includeReasoning: true`\n\nWhen enabled, heartbeats will also deliver a separate message prefixed\n`Reasoning:` (same shape as `/reasoning on`). This can be useful when the agent\nis managing multiple sessions/codexes and you want to see why it decided to ping\nyou — but it can also leak more internal detail than you want. Prefer keeping it\noff in group chats.\n\nHeartbeats run full agent turns. Shorter intervals burn more tokens. Keep\n`HEARTBEAT.md` small and consider a cheaper `model` or `target: \"none\"` if you\nonly want internal state updates.",
  "code_samples": [
    {
      "code": "### Can the agent update HEARTBEAT.md?\n\nYes — if you ask it to.\n\n`HEARTBEAT.md` is just a normal file in the agent workspace, so you can tell the\nagent (in a normal chat) something like:\n\n* “Update `HEARTBEAT.md` to add a daily calendar check.”\n* “Rewrite `HEARTBEAT.md` so it’s shorter and focused on inbox follow-ups.”\n\nIf you want this to happen proactively, you can also include an explicit line in\nyour heartbeat prompt like: “If the checklist becomes stale, update HEARTBEAT.md\nwith a better one.”\n\nSafety note: don’t put secrets (API keys, phone numbers, private tokens) into\n`HEARTBEAT.md` — it becomes part of the prompt context.\n\n## Manual wake (on-demand)\n\nYou can enqueue a system event and trigger an immediate heartbeat with:",
      "language": "unknown"
    }
  ],
  "headings": [
    {
      "level": "h3",
      "text": "Can the agent update HEARTBEAT.md?",
      "id": "can-the-agent-update-heartbeat.md?"
    },
    {
      "level": "h2",
      "text": "Manual wake (on-demand)",
      "id": "manual-wake-(on-demand)"
    },
    {
      "level": "h2",
      "text": "Reasoning delivery (optional)",
      "id": "reasoning-delivery-(optional)"
    },
    {
      "level": "h2",
      "text": "Cost awareness",
      "id": "cost-awareness"
    }
  ],
  "url": "llms-txt#heartbeat-checklist",
  "links": []
}