Heartbeat-Automatisierung einrichten

Du hast OpenClaw am Laufen. Vielleicht verarbeitet es deine Nachrichten, führt Automatisierungen aus oder betreibt deine Workflows. Aber was passiert, wenn um 3 Uhr nachts etwas kaputtgeht? Ohne Überwachung merkst du es vielleicht nicht, bis Benutzer sich beschweren.

Heartbeat-Automatisierung löst dieses Problem. Sie führt periodische Health Checks durch und alarmiert dich, wenn etwas Aufmerksamkeit braucht.

OpenClaw Heartbeats verstehen

OpenClaws Heartbeat-System basiert auf Cron-Jobs, die Health Checks nach Zeitplan ausführen. Jeder Heartbeat kann verschiedene Aspekte deines Systems verifizieren:

• Gateway-Konnektivität und Authentifizierungsstatus
• Memory-Index-Gesundheit und Coverage-Prozentsatz
• Cron-Job-Erfolgsraten und kürzliche Fehler
• System-Gesundheits-Warnungen und Fehlerprotokolle
• Festplattenplatz und Ressourcennutzung

Der Heartbeat-State wird in einer JSON-Datei verfolgt, die zwischen den Checks persistiert. So kannst du Trends über die Zeit sehen und Probleme erkennen, die sich allmählich entwickeln.

Heartbeat-Checks konfigurieren

Heartbeat-Jobs werden im Cron-Bereich deiner OpenClaw-Konfiguration definiert. Jeder Job braucht einen Zeitplan, ein Target-Session und ein Payload, das beschreibt, was zu prüfen ist.

{
  "name": "System Health Check",
  "enabled": true,
  "schedule": {
    "kind": "cron",
    "expr": "0 */30 * * * *",
    "tz": "Europe/Berlin"
  },
  "sessionTarget": "isolated",
  "payload": {
    "kind": "agentTurn",
    "message": "Führe Health Check durch: verifiziere Gateway-Status, Memory-Index, Cron-Jobs und System-Warnungen. Berichte über gefundene Probleme."
  }
}

Dieses Beispiel läuft alle 30 Minuten einen Health Check. Der Cron-Ausdruck `0 */30 * * * *` bedeutet \"in Sekunde 0 jeder 30. Minute\".

Cron-Ausdruck-Grundlagen

OpenClaw verwendet die Standard-Cron-Syntax mit sechs Feldern:

┌───────────── Sekunde (0-59) │ ┌───────────── Minute (0-59) │ │ ┌───────────── Stunde (0-23) │ │ │ ┌───────────── Tag des Monats (1-31) │ │ │ │ ┌───────────── Monat (1-12) │ │ │ │ │ ┌───────────── Wochentag (0-6) │ │ │ │ │ │ * * * * * *

Übliche Muster:

• 0 * * * * * - Jede Stunde zur Minute 0
• 0 0 * * * * - Jeden Tag um Mitternacht
• 0 0 */3 * * * - Alle 3 Tage um Mitternacht
• 0 10 * * * * - Jeden Tag um 10:00

Notification-Channels

Wenn ein Heartbeat ein Problem erkennt, muss er die Alert irgendwohin senden. Konfiguriere Delivery-Einstellungen in deinem Cron-Job:

"delivery": {
  "mode": "announce",
  "channel": "telegram",
  "to": "421928930"
}

Dies sendet Benachrichtigungen an einen bestimmten Telegram-Chat. Du kannst verschiedene Channels für verschiedene Check-Typen konfigurieren oder den last-Channel verwenden, um dorthin zu senden, wo die ursprüngliche Anfrage herkam.

Was zu prüfen ist

Ein gutes Heartbeat-Setup deckt die kritischen Pfade deines OpenClaw-Deployments ab:

Gateway-Gesundheit

Verifiziere, dass das Gateway läuft und ansprechbar ist. Prüfe, ob Authentifizierung aktiviert und Tokens gültig sind. Wenn sich die Loopback-Only-Einstellung des Gateways unerwartet geändert hat, ist das ein Sicherheits-Flag.

Memory-System

OpenClaw verwaltet einen Memory-Index. Prüfe, ob der Prozentsatz der indizierten Dateien vernünftig ist und die Coverage nicht sinkt. Ein plötzlicher Abfall der Coverage könnte auf ein Indexierungsproblem hinweisen.

Cron-Jobs

Überwache kürzliche Cron-Job-Läufe. Achte auf aufeinanderfolgende Fehler, fehlgeschlagene Deliveries oder Jobs, die nicht wie erwartet gelaufen sind. Ein Cron-Job, der still scheitert, ist schlimmer als kein Cron-Job.

System-Ressourcen

Für Deployments mit schweren Workloads, prüfe Festplattenplatz, Speichernutzung und CPU-Last. OpenClaw kann Scripts ausführen, die System-Stats abfragen und Alert senden, wenn Schwellenwerte überschritten werden.

Heartbeat-State-Datei

OpenClaw verfolgt den Heartbeat-State in ~/.openclaw/memory/heartbeat-state.json. Diese Datei zeichnet auf:

• Zeitstempel der letzten Checks für jeden Monitor
• Gateway-Konnektivitätsstatus
• Memory-Index-Gesundheit
• Cron-Job-Statistiken
• System-Gesundheits-Warnungen

Bearbeite diese Datei nicht manuell. OpenClaw verwaltet sie automatisch während der Heartbeat-Läufe.

Best Practices

Halte dein Heartbeat-Setup wartbar:

• Starte einfach - Ein stündlicher Check ist besser als keine Checks
• Alerts für Symptome - Prüfe auf Probleme, die Benutzer bemerken würden, nicht auf interne Zustände
• Escalation nutzen - Kritische Probleme bekommen sofortige Alerts, Warnungen können auf stündliche Summen warten
• Teste deine Alerts - Löse periodisch einen Test-Alert aus, um zu verifizieren, dass Notifications funktionieren
• Überprüfe Fehlalarme - Wenn du Alerts ignorierst, stimmt etwas mit deinen Schwellenwerten nicht