OpenClaw heartbeat.md gebruiken

OpenClaw werkt met een HEARTBEAT.md-bestand. Dit bestand wordt door OpenClaw gebruikt om periodiek automatisch taken uit te voeren zonder te vragen wat het moet doen of wanneer. Denk hierbij aan achtergrondtaken (bijv. controleer je kalender) en om te controleren hoe het met je gaat (bijv. kan ik iets voor je doen?). 

In dit artikel leggen we uit wat HEARTBEAT.md is, hoe je het gebruikt, en hoe je het aanpast.

Wat is HEARTBEAT.md?

HEARTBEAT.md is een statusbestand dat OpenClaw gebruikt als “hartslag”. Het idee is simpel:

• Als OpenClaw draait (of periodiek werk doet), wordt de heartbeat regelmatig uitgevoerd (met intervallen gedefinieerd in het HEARTBEAT.md-bestand).
• Als de heartbeat in orde is, antwoord OpenClaw met ‘HEARTBEAT_OK’.
• Het bestand is bewust menselijk leesbaar (Markdown).

Heartbeat quickstart

Na het onboardingsproces stelt OpenClaw je diverse vragen. Via deze vragen wordt de initiële configuratie van je agent uitgevoerd, waaronder de ‘heartbeat’. De ‘heartbeat’-instructie wordt door OpenClaw gebruikt om periodiek automatisch taken uit te voeren. Je kunt de heartbeat altijd later direct in een gesprek via een communicatiekanaal aanpassen, bijvoorbeeld via WhatsApp. Zo kun je als je WhatsApp met OpenClaw gebruikt bijvoorbeeld simpelweg vragen ‘welke instructies krijg je van HEARTBEAT.md’? en vervolgens die in een gesprek verder aanpassen, bijvoorbeeld:

Me> What does your HEARTBEAT instruct you to do?
OpenClaw> I'm instructed to provide you a weather update at 9AM every morning
Me> Great! Also check my calendar at 9AM every morning and give me an overview of my appointments.
etc

Let op: De LLM die je gebruikt voor OpenClaw bepaalt hoe letterlijk OpenClaw je instructies interpreteert. Zo kan een instructie als ‘if nothing urgent, return quietly’ vrij letterlijk worden opgevat. Vraag je bijvoorbeeld om een weerupdate elke 3 uur, dan kan OpenClaw (afhankelijk van je LLM) deze instructie interpreteren als ‘geen weeralarm (bijv. storm op komst)? dan geef ik ook geen nieuws over het weer'.

Waar vind ik HEARTBEAT.md?

De workspace is de ‘home’-directory van de OpenClaw-agent. Het is de enige folder die wordt gebruikt voor tools en voor de context van de workspace. Houd deze privé en behandel deze als geheugen. Deze map is gescheiden van ~/.openclaw/, waarin configuratiebestanden, inloggegevens en sessies worden opgeslagen.

In OpenClaw-installaties vind je de workspace in de volgende directory:

~/.openclaw/workspace/

Het HEARTBEAT.md-bestand vind je eveneens in deze directory, bijvoorbeeld:

ls -lah ~/.openclaw/workspace | grep HEARTBEAT

Als je meerdere workspaces of profielen gebruikt, kan de locatie afwijken. In dat geval kun je ook breed zoeken:

find ~/.openclaw -maxdepth 4 -name "HEARTBEAT.md" -print

HEARTBEAT.md bekijken en aanpassen

Open het bestand, bijvoorbeeld:

nano ~/.openclaw/workspace/HEARTBEAT.md

De inhoud is opzettelijk eenvoudig gemaakt en het advies is om de inhoud eenvoudig te houden. Je kan eventueel ook in een gesprek met OpenClaw vragen om HEARTBEAT.md bij te werken, bijvoorbeeld via WhatsApp.

# Heartbeat checklist

- Quick scan: anything urgent in inboxes?
- If it’s daytime, do a lightweight check-in if nothing else is pending.
- If a task is blocked, write down _what is missing_ and ask <NAME> next time.

De heartbeat-timing en andere opties aanpassen

Naast de inhoudelijke heartbeat, kun je ook opties zoals hoe vaak de heartbeat-instructie wordt gecontroleerd aanpassen. Open hiervoor het bestand:

nano ~/.openclaw/openclaw.json

Pas naar wens de volgende opties aan, zie de toelichting onder de code. Dit zijn de meest gebruikte opties; een volledig overzicht vind je hier.

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last",
        directPolicy: "allow",
        to: "+15551234567",
        activeHours: { start: "08:00", end: "24:00" },
        includeReasoning: true,
        prompt: "Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.",
        ackMaxChars: 300,
      },
    },
  },
}