Heartbeat

​

Snel aan de slag (beginner)

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // expliciete bezorging bij het laatste contact (standaard is "none")
        directPolicy: "allow", // standaard: directe/DM-doelen toestaan; stel "block" in om ze te onderdrukken
        lightContext: true, // optioneel: bootstrapbestanden van de werkruimte overslaan voor Heartbeat-runs
        isolatedSession: true, // optioneel: elke run een nieuwe sessie (geen gespreksgeschiedenis)
        // activeHours: { start: "08:00", end: "24:00" },
      },
    },
  },
}

​

Standaardwaarden

• Interval: 30m. Door de standaardwaarden van de Anthropic-provider toe te passen, wordt dit verhoogd naar 1h wanneer de vastgestelde authenticatiemodus OAuth/token is (inclusief hergebruik van de Claude CLI), maar alleen zolang heartbeat.every niet is ingesteld. Stel agents.defaults.heartbeat.every of agents.entries.*.heartbeat.every per agent in; gebruik 0m om dit uit te schakelen.
• Prompttekst (configureerbaar via agents.defaults.heartbeat.prompt): Follow the heartbeat monitor scratch context when provided. Recurring tasks are cron jobs; create or change their schedules with cron tools or the openclaw cron CLI, not heartbeat scratch. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.
• Time-out: Heartbeat-beurten zonder ingestelde waarde gebruiken agents.defaults.timeoutSeconds als die is ingesteld. Anders gebruiken ze het Heartbeat-ritme, met een maximum van 600 seconden. Stel agents.defaults.heartbeat.timeoutSeconds of agents.entries.*.heartbeat.timeoutSeconds per agent in voor langer Heartbeat-werk.
• De Heartbeat-prompt wordt letterlijk als gebruikersbericht verzonden. De systeemprompt bevat een sectie ‘Heartbeats’ wanneer Heartbeats voor de standaardagent zijn ingeschakeld, en de run wordt intern gemarkeerd.
• Wanneer Heartbeats met 0m worden uitgeschakeld, blijft de cron-taak van de monitor bestaan maar wordt deze uitgeschakeld. De kladruimte blijft behouden voor wanneer je het ritme opnieuw inschakelt.
• Wanneer cron zelf is uitgeschakeld, worden geplande Heartbeats niet uitgevoerd, zelfs als het Heartbeat-ritme ingeschakeld blijft.
• Actieve uren (heartbeat.activeHours) worden gecontroleerd in de geconfigureerde tijdzone. Buiten het tijdvenster worden Heartbeats overgeslagen tot de volgende tik binnen het venster.
• Heartbeats worden automatisch uitgesteld zolang cron-werk actief is of in de wachtrij staat, of zolang de sessiesleutelgebonden subagent- of geneste opdrachtbanen van die agent bezet zijn. Parallelle agents pauzeren elkaar niet.

​

Waarvoor de Heartbeat-prompt dient

• Achtergrondtaken: ‘Houd rekening met openstaande taken’ spoort de agent aan om vervolgacties te bekijken (inbox, agenda, herinneringen, werk in de wachtrij) en alles wat dringend is onder de aandacht te brengen.
• Contact met de gebruiker: ‘Vraag overdag soms hoe het met je gebruiker gaat’ spoort aan tot af en toe een kort bericht als ‘heb je iets nodig?’, maar voorkomt berichtenoverlast ‘s nachts door je geconfigureerde lokale tijdzone te gebruiken (zie Tijdzone).

​

Responscontract

• Als niets aandacht nodig heeft, antwoord je met HEARTBEAT_OK.
• Heartbeat-runs kunnen in plaats daarvan heartbeat_respond aanroepen met notify: false voor geen zichtbare update, of notify: true plus notificationText voor een waarschuwing. Wanneer aanwezig, heeft het gestructureerde toolantwoord voorrang op de tekstuele terugvaloptie.
• Een betekenisvol resultaat van heartbeat_respond met notify: false blijft stil, maar wordt onthouden als begrensde interne context voor de volgende gebruikersbeurt in die sessie. Bevestigingen met no_change en zichtbare meldingen worden niet op deze manier opgeslagen.
• Tijdens Heartbeat-runs behandelt OpenClaw HEARTBEAT_OK als een bevestiging wanneer het aan het begin of einde van het antwoord staat. Het token wordt verwijderd en het antwoord wordt verworpen als de resterende inhoud maximaal 300 tekens bevat.
• Als HEARTBEAT_OK in het midden van een antwoord staat, wordt het niet speciaal behandeld.
• Neem bij waarschuwingen HEARTBEAT_OK niet op; retourneer alleen de waarschuwingstekst.

​

Configuratie

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m", // standaard: 30m (0m schakelt uit)
        model: "anthropic/claude-opus-4-6",
        lightContext: false, // standaard: false; true slaat bootstrapbestanden van de werkruimte over voor Heartbeat-runs
        isolatedSession: false, // standaard: false; true voert elke Heartbeat uit in een nieuwe sessie (geen gespreksgeschiedenis)
        target: "last", // standaard: none | opties: last | none | <channel id> (core of Plugin, bijvoorbeeld "imessage")
        to: "+15551234567", // optionele kanaalspecifieke overschrijving
        accountId: "ops-bot", // optionele kanaal-id voor meerdere accounts
        prompt: "Volg de kladcontext van de Heartbeat-monitor wanneer die beschikbaar is. Terugkerende taken zijn cron-taken; maak of wijzig hun schema's met cron-tools of de openclaw cron CLI, niet met de Heartbeat-kladruimte. Leid geen oude taken af uit eerdere chats en herhaal ze niet. Als niets aandacht nodig heeft, antwoord dan HEARTBEAT_OK.",
      },
    },
  },
}

​

Bereik en voorrang

• agents.defaults.heartbeat stelt het algemene Heartbeat-gedrag in.
• agents.entries.*.heartbeat wordt daar bovenop samengevoegd; als een agent een heartbeat-blok heeft, voeren alleen die agents Heartbeats uit.
• channels.defaults.heartbeatVisibility stelt de standaardinstellingen voor zichtbaarheid voor alle kanalen in.
• channels.<channel>.heartbeatVisibility overschrijft de standaardinstellingen van het kanaal.
• channels.<channel>.accounts.<id>.heartbeatVisibility (kanalen met meerdere accounts) overschrijft de instellingen per kanaal.

​

Heartbeats per agent

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // expliciete bezorging bij het laatste contact (standaard is "none")
      },
    },
    list: [
      { id: "main", default: true },
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "whatsapp",
          to: "+15551234567",
          timeoutSeconds: 45,
          prompt: "Volg de kladcontext van de Heartbeat-monitor wanneer die beschikbaar is. Terugkerende taken zijn cron-taken; maak of wijzig hun schema's met cron-tools of de openclaw cron CLI, niet met de Heartbeat-kladruimte. Leid geen oude taken af uit eerdere chats en herhaal ze niet. Als niets aandacht nodig heeft, antwoord dan HEARTBEAT_OK.",
        },
      },
    ],
  },
}

​

Voorbeeld van actieve uren

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // expliciete bezorging bij het laatste contact (standaard is "none")
        activeHours: {
          start: "09:00",
          end: "22:00",
          timezone: "America/New_York", // optioneel; gebruikt je userTimezone indien ingesteld, anders de tijdzone van de host
        },
      },
    },
  },
}

​

Configuratie voor 24/7

• Laat activeHours volledig weg (geen beperking door een tijdvenster; dit is het standaardgedrag).
• Stel een venster voor de hele dag in: activeHours: { start: "00:00", end: "24:00" }.

​

Voorbeeld met meerdere accounts

{
  agents: {
    list: [
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "telegram",
          to: "12345678:topic:42", // optioneel: routeren naar een specifiek onderwerp/thread
          accountId: "ops-bot",
        },
      },
    ],
  },
  channels: {
    telegram: {
      accounts: {
        "ops-bot": { botToken: "YOUR_TELEGRAM_BOT_TOKEN" },
      },
    },
  },
}

​

Opmerkingen bij velden

​

Aflevergedrag

​

Zichtbaarheidsinstellingen

channels:
  defaults:
    heartbeat:
      showOk: false # HEARTBEAT_OK verbergen (standaard)
      showAlerts: true # Waarschuwingsberichten tonen (standaard)
      useIndicator: true # Indicatorgebeurtenissen uitzenden (standaard)
  telegram:
    heartbeat:
      showOk: true # OK-bevestigingen tonen op Telegram
  whatsapp:
    accounts:
      work:
        heartbeat:
          showAlerts: false # Aflevering van waarschuwingen voor dit account onderdrukken

​

Wat elke vlag doet

• showOk: verzendt een HEARTBEAT_OK-bevestiging wanneer het model een antwoord retourneert dat alleen uit OK bestaat.
• showAlerts: verzendt de waarschuwingsinhoud wanneer het model een antwoord retourneert dat niet alleen uit OK bestaat.
• useIndicator: zendt indicatorgebeurtenissen uit voor UI-statusweergaven.

​

Voorbeelden per kanaal en per account

channels:
  defaults:
    heartbeat:
      showOk: false
      showAlerts: true
      useIndicator: true
  slack:
    heartbeat:
      showOk: true # alle Slack-accounts
    accounts:
      ops:
        heartbeat:
          showAlerts: false # waarschuwingen alleen voor het ops-account onderdrukken
  telegram:
    heartbeat:
      showOk: true

​

Veelvoorkomende patronen

​

Monitorkladblok (optioneel)

openclaw cron scratch <jobId>                 # het huidige kladblok weergeven
openclaw cron scratch <jobId> --set "..."     # vervangen door exact deze tekst
openclaw cron scratch <jobId> --file notes.md # vervangen vanuit een bestand (- voor stdin)
openclaw cron scratch <jobId> --unset         # verwijderen

# Heartbeat-checklist

- Snelle controle: staat er iets dringends in de inboxen?
- Als het overdag is, neem dan kort contact op als er verder niets openstaat.
- Als een taak geblokkeerd is, noteer dan _wat er ontbreekt_ en vraag het de volgende keer aan Peter.

​

Terugkerende controles plannen met Cron

​

Kan de agent zijn kladblok bijwerken?

​

Handmatige activering (op aanvraag)

openclaw system event --text "Controleer op dringende vervolgacties" --mode now

openclaw system heartbeat last     # toon de laatste heartbeat-gebeurtenis
openclaw system heartbeat enable   # schakel heartbeats in
openclaw system heartbeat disable  # schakel heartbeats uit

​

Kostenbewustzijn

• Gebruik isolatedSession: true om te voorkomen dat de volledige gespreksgeschiedenis wordt verzonden (van ~100K tokens naar ~2-5K per uitvoering).
• Gebruik lightContext: true om bootstrapbestanden van de werkruimte over te slaan bij heartbeat-uitvoeringen.
• Stel een goedkoper model in (bijv. ollama/llama3.2:1b).
• Houd het kladgebied van de monitor klein.
• Gebruik target: "none" als je alleen interne statusupdates wilt.

​

Contextoverloop na een heartbeat

​

Gerelateerd

• Automatisering - alle automatiseringsmechanismen in één oogopslag
• Achtergrondtaken - hoe losgekoppeld werk wordt bijgehouden
• Tijdzone - hoe de tijdzone de heartbeat-planning beïnvloedt
• Problemen oplossen - automatiseringsproblemen opsporen