Heartbeat

​

Schnellstart (Einsteiger)

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // explizite Zustellung an den letzten Kontakt (Standard ist "none")
        directPolicy: "allow", // Standard: direkte/DM-Ziele zulassen; auf "block" setzen, um sie zu unterdrücken
        lightContext: true, // optional: Workspace-Bootstrap-Dateien für Heartbeat-Ausführungen überspringen
        isolatedSession: true, // optional: neue Sitzung bei jeder Ausführung (kein Gesprächsverlauf)
        // activeHours: { start: "08:00", end: "24:00" },
      },
    },
  },
}

​

Standardwerte

• Intervall: 30m. Durch Anwenden der Anthropic-Provider-Standardwerte wird dies auf 1h erhöht, wenn der ermittelte Authentifizierungsmodus OAuth/Token ist (einschließlich der Wiederverwendung der Claude CLI), jedoch nur, solange heartbeat.every nicht festgelegt ist. Legen Sie agents.defaults.heartbeat.every oder agentenspezifisch agents.entries.*.heartbeat.every fest; verwenden Sie zum Deaktivieren 0m.
• Prompt-Inhalt (über agents.defaults.heartbeat.prompt konfigurierbar): 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.
• Zeitüberschreitung: Heartbeat-Durchläufe ohne festgelegten Wert verwenden agents.defaults.timeoutSeconds, sofern dieser Wert gesetzt ist. Andernfalls verwenden sie den Heartbeat-Takt, begrenzt auf 600 Sekunden. Legen Sie für längere Heartbeat-Arbeiten agents.defaults.heartbeat.timeoutSeconds oder agentenspezifisch agents.entries.*.heartbeat.timeoutSeconds fest.
• Der Heartbeat-Prompt wird unverändert als Benutzernachricht gesendet. Der System-Prompt enthält einen Abschnitt „Heartbeats“, wenn Heartbeats für den Standardagenten aktiviert sind, und die Ausführung wird intern entsprechend gekennzeichnet.
• Wenn Heartbeats mit 0m deaktiviert werden, bleibt der cron-Überwachungsauftrag bestehen, wird jedoch deaktiviert. Seine Notizen bleiben erhalten, bis Sie den Takt wieder aktivieren.
• Wenn cron selbst deaktiviert ist, werden geplante Heartbeats nicht ausgeführt, auch wenn der Heartbeat-Takt weiterhin aktiviert ist.
• Aktive Zeiten (heartbeat.activeHours) werden in der konfigurierten Zeitzone geprüft. Außerhalb des Zeitfensters werden Heartbeats bis zum nächsten Takt innerhalb des Fensters übersprungen.
• Heartbeats werden automatisch zurückgestellt, solange cron-Arbeiten aktiv sind oder sich in der Warteschlange befinden oder solange die sitzungsschlüsselgebundenen Subagenten- oder verschachtelten Befehls-Lanes dieses Agenten ausgelastet sind. Gleichgeordnete Agenten pausieren einander nicht.

​

Zweck des Heartbeat-Prompts

• Hintergrundaufgaben: „Ausstehende Aufgaben berücksichtigen“ fordert den Agenten auf, Folgemaßnahmen zu prüfen (Posteingang, Kalender, Erinnerungen, Arbeiten in der Warteschlange) und auf dringende Punkte hinzuweisen.
• Nachfrage beim Menschen: „Gelegentlich tagsüber nach dem Menschen sehen“ regt zu einer gelegentlichen kurzen Nachricht wie „Benötigen Sie etwas?“ an, vermeidet jedoch durch Verwendung Ihrer konfigurierten lokalen Zeitzone nächtliche Nachrichtenfluten (siehe Zeitzone).

​

Antwortvertrag

• Wenn nichts beachtet werden muss, antworten Sie mit HEARTBEAT_OK.
• Heartbeat-Ausführungen können stattdessen heartbeat_respond mit notify: false aufrufen, wenn keine sichtbare Aktualisierung erfolgen soll, oder notify: true zusammen mit notificationText für eine Warnung. Falls vorhanden, hat die strukturierte Tool-Antwort Vorrang vor dem textbasierten Rückfall.
• Ein aussagekräftiges heartbeat_respond-Ergebnis mit notify: false bleibt unsichtbar, wird jedoch als begrenzter interner Kontext für den nächsten Benutzerdurchlauf in dieser Sitzung gespeichert. no_change-Bestätigungen und sichtbare Benachrichtigungen werden nicht auf diese Weise gespeichert.
• Während Heartbeat-Ausführungen behandelt OpenClaw HEARTBEAT_OK als Bestätigung, wenn es am Anfang oder Ende der Antwort erscheint. Das Token wird entfernt und die Antwort verworfen, wenn der verbleibende Inhalt höchstens 300 Zeichen umfasst.
• Wenn HEARTBEAT_OK in der Mitte einer Antwort erscheint, wird es nicht besonders behandelt.
• Fügen Sie bei Warnungen HEARTBEAT_OK nicht ein; geben Sie ausschließlich den Warntext zurück.

​

Konfiguration

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m", // Standard: 30m (0m deaktiviert)
        model: "anthropic/claude-opus-4-6",
        lightContext: false, // Standard: false; true überspringt Workspace-Bootstrap-Dateien für Heartbeat-Ausführungen
        isolatedSession: false, // Standard: false; true führt jeden Heartbeat in einer neuen Sitzung aus (kein Gesprächsverlauf)
        target: "last", // Standard: none | Optionen: last | none | <channel id> (Kern oder Plugin, z. B. "imessage")
        to: "+15551234567", // optionale kanalspezifische Überschreibung
        accountId: "ops-bot", // optionale Kanal-ID bei mehreren Konten
        prompt: "Befolgen Sie den Kontext der Heartbeat-Überwachungsnotizen, sofern er bereitgestellt wird. Wiederkehrende Aufgaben sind cron-Aufträge; erstellen oder ändern Sie deren Zeitpläne mit cron-Tools oder der openclaw cron CLI, nicht mit Heartbeat-Notizen. Leiten Sie keine alten Aufgaben aus früheren Chats ab und wiederholen Sie diese nicht. Wenn nichts beachtet werden muss, antworten Sie mit HEARTBEAT_OK.",
      },
    },
  },
}

​

Geltungsbereich und Rangfolge

• agents.defaults.heartbeat legt das globale Heartbeat-Verhalten fest.
• agents.entries.*.heartbeat wird darübergelegt; wenn ein Agent einen heartbeat-Block besitzt, führen nur diese Agenten Heartbeats aus.
• channels.defaults.heartbeatVisibility legt die Sichtbarkeitsstandards für alle Kanäle fest.
• channels.<channel>.heartbeatVisibility überschreibt die Kanalstandards.
• channels.<channel>.accounts.<id>.heartbeatVisibility (Kanäle mit mehreren Konten) überschreibt die kanalspezifischen Einstellungen.

​

Agentenspezifische Heartbeats

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // explizite Zustellung an den letzten Kontakt (Standard ist "none")
      },
    },
    list: [
      { id: "main", default: true },
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "whatsapp",
          to: "+15551234567",
          timeoutSeconds: 45,
          prompt: "Befolgen Sie den Kontext der Heartbeat-Überwachungsnotizen, sofern er bereitgestellt wird. Wiederkehrende Aufgaben sind cron-Aufträge; erstellen oder ändern Sie deren Zeitpläne mit cron-Tools oder der openclaw cron CLI, nicht mit Heartbeat-Notizen. Leiten Sie keine alten Aufgaben aus früheren Chats ab und wiederholen Sie diese nicht. Wenn nichts beachtet werden muss, antworten Sie mit HEARTBEAT_OK.",
        },
      },
    ],
  },
}

​

Beispiel für aktive Zeiten

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m",
        target: "last", // explizite Zustellung an den letzten Kontakt (Standard ist "none")
        activeHours: {
          start: "09:00",
          end: "22:00",
          timezone: "America/New_York", // optional; verwendet userTimezone, falls festgelegt, andernfalls die Zeitzone des Hosts
        },
      },
    },
  },
}

​

Einrichtung von 24/7

• Lassen Sie activeHours vollständig weg (keine Zeitfensterbeschränkung; dies ist das Standardverhalten).
• Legen Sie ein ganztägiges Zeitfenster fest: activeHours: { start: "00:00", end: "24:00" }.

​

Beispiel mit mehreren Konten

{
  agents: {
    list: [
      {
        id: "ops",
        heartbeat: {
          every: "1h",
          target: "telegram",
          to: "12345678:topic:42", // optional: an ein bestimmtes Thema/einen bestimmten Thread weiterleiten
          accountId: "ops-bot",
        },
      },
    ],
  },
  channels: {
    telegram: {
      accounts: {
        "ops-bot": { botToken: "YOUR_TELEGRAM_BOT_TOKEN" },
      },
    },
  },
}

​

Feldhinweise

​

Zustellungsverhalten

​

Sichtbarkeitssteuerung

channels:
  defaults:
    heartbeat:
      showOk: false # HEARTBEAT_OK ausblenden (Standard)
      showAlerts: true # Alarmmeldungen anzeigen (Standard)
      useIndicator: true # Indikatorereignisse ausgeben (Standard)
  telegram:
    heartbeat:
      showOk: true # OK-Bestätigungen auf Telegram anzeigen
  whatsapp:
    accounts:
      work:
        heartbeat:
          showAlerts: false # Alarmzustellung für dieses Konto unterdrücken

​

Funktion der einzelnen Flags

• showOk: sendet eine HEARTBEAT_OK-Bestätigung, wenn das Modell eine reine OK-Antwort zurückgibt.
• showAlerts: sendet den Alarminhalt, wenn das Modell eine andere als eine OK-Antwort zurückgibt.
• useIndicator: gibt Indikatorereignisse für UI-Statusoberflächen aus.

​

Beispiele für Einstellungen pro Kanal und pro Konto

channels:
  defaults:
    heartbeat:
      showOk: false
      showAlerts: true
      useIndicator: true
  slack:
    heartbeat:
      showOk: true # alle Slack-Konten
    accounts:
      ops:
        heartbeat:
          showAlerts: false # Alarme nur für das ops-Konto unterdrücken
  telegram:
    heartbeat:
      showOk: true

​

Häufige Muster

​

Monitor-Notizen (optional)

openclaw cron scratch <jobId>                 # aktuelle Notizen ausgeben
openclaw cron scratch <jobId> --set "..."     # durch den exakten Text ersetzen
openclaw cron scratch <jobId> --file notes.md # durch den Inhalt einer Datei ersetzen (- für stdin)
openclaw cron scratch <jobId> --unset         # entfernen

# Heartbeat-Checkliste

- Kurz prüfen: Gibt es etwas Dringendes in den Posteingängen?
- Wenn es Tag ist und sonst nichts ansteht, kurz und unaufwendig nachfragen.
- Wenn eine Aufgabe blockiert ist, notieren, _was fehlt_, und Peter beim nächsten Mal fragen.

​

Wiederkehrende Prüfungen mit Cron planen

​

Kann der Agent seine Notizen aktualisieren?

​

Manuelle Aktivierung (bei Bedarf)

openclaw system event --text "Auf dringende Nachfassaktionen prüfen" --mode now

openclaw system heartbeat last     # letztes Heartbeat-Ereignis anzeigen
openclaw system heartbeat enable   # Heartbeats aktivieren
openclaw system heartbeat disable  # Heartbeats deaktivieren

​

Kostenbewusstsein

• Verwenden Sie isolatedSession: true, damit nicht der vollständige Konversationsverlauf gesendet wird (~100K Token werden auf ~2-5K pro Ausführung reduziert).
• Verwenden Sie lightContext: true, um Workspace-Bootstrap-Dateien bei Heartbeat-Ausführungen zu überspringen.
• Legen Sie ein kostengünstigeres model fest (z. B. ollama/llama3.2:1b).
• Halten Sie den temporären Monitorbereich klein.
• Verwenden Sie target: "none", wenn Sie nur interne Statusaktualisierungen wünschen.

​

Kontextüberlauf nach einem Heartbeat

​

Verwandte Themen

• Automatisierung – alle Automatisierungsmechanismen auf einen Blick
• Hintergrundaufgaben – wie abgekoppelte Arbeiten nachverfolgt werden
• Zeitzone – wie sich die Zeitzone auf die Heartbeat-Planung auswirkt
• Fehlerbehebung – Fehler bei der Automatisierung diagnostizieren