OpenClaw Automatisierung: Fehler beheben in 5 Minuten

Kennst du das Gefühl, wenn deine Automatisierungen einfach im digitalen Nichts verschwinden? Es gibt kaum etwas Frustrierenderes, als einen cron Job zu debuggen, der lautlos scheitert oder einen Heartbeat, der nie gesendet wird.

Diese Anleitung hilft dir dabei, Probleme mit dem Scheduler und der Zustellung (cron + heartbeat) gezielt zu finden und zu beheben.

Fehlerbehebung bei Automatisierungen

Verwende diese Seite bei Problemen mit dem Scheduler oder der Zustellung (cron + heartbeat).

Die Befehlskette

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Führe danach die Automatisierungs-Checks aus:

openclaw cron status
openclaw cron list
openclaw system heartbeat last

Cron wird nicht ausgelöst

openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw logs --follow

Ein korrektes Ergebnis sieht so aus:

• cron status meldet “enabled” sowie ein zukünftiges nextWakeAtMs, wobei der Job aktiviert ist und einen gültigen Zeitplan sowie die richtige Timezone besitzt.
• cron runs zeigt ok oder einen expliziten Grund für das Überspringen an.

Häufige Fehlermuster:

• cron: scheduler disabled; jobs will not run automatically → Cron ist in der Config oder den Umgebungsvariablen deaktiviert.
• cron: timer tick failed (Scheduler-Tick abgestürzt; prüfe den Stack- und Log-Kontext) oder reason: not-due in der Ausgabe (manueller Aufruf ohne --force, obwohl der Job noch nicht fällig ist).

Cron ausgelöst, aber keine Zustellung

openclaw cron runs --id <jobId> --limit 20
openclaw cron list
openclaw channels status --probe
openclaw logs --follow

Ein korrektes Ergebnis sieht so aus:

• Der Run-Status ist ok und der Channel-Probe meldet, dass der Ziel-Channel verbunden ist.
• Delivery Mode und Target sind für isolierte Jobs korrekt gesetzt.

Häufige Fehlermuster:

• Run war erfolgreich, aber der Delivery Mode steht auf none → es wird keine externe Nachricht erwartet.
• Das Delivery Target fehlt oder ist ungültig (channel/to), oder es liegen Channel-Auth-Fehler vor (unauthorized, missing_scope, Forbidden), die die Zustellung blockieren.

Heartbeat unterdrückt oder übersprungen

openclaw system heartbeat last
openclaw logs --follow
openclaw config get agents.defaults.heartbeat
openclaw channels status --probe

Ein korrektes Ergebnis sieht so aus:

• Heartbeat ist mit einem Intervall größer als Null aktiviert.
• Das letzte Heartbeat-Ergebnis ist ran (oder der Grund für das Überspringen ist nachvollziehbar).

Häufige Fehlermuster:

• heartbeat skipped mit reason=quiet-hours (außerhalb der activeHours) oder requests-in-flight (Hauptleitung belegt; Heartbeat verzögert).
• empty-heartbeat-file (HEARTBEAT.md existiert, hat aber keinen verwertbaren Inhalt) oder alerts-disabled (Sichtbarkeitseinstellungen unterdrücken ausgehende Heartbeat-Nachrichten).

Fallstricke bei Timezone und activeHours

openclaw config get agents.defaults.heartbeat.activeHours
openclaw config get agents.defaults.heartbeat.activeHours.timezone
openclaw config get agents.defaults.userTimezone || echo "agents.defaults.userTimezone not set"
openclaw cron list
openclaw logs --follow

Schnelle Regeln:

• Config path not found: agents.defaults.userTimezone bedeutet, dass der Key nicht gesetzt ist; der Heartbeat nutzt dann die Timezone des Hosts (oder activeHours.timezone, falls definiert).
• Cron ohne --tz nutzt die Timezone des Gateway-Hosts, während Heartbeat activeHours die konfigurierte Timezone-Auflösung nutzt (user, local oder explizite IANA-TZ).
• ISO-Zeitstempel ohne Zeitzone werden für cron at Zeitpläne als UTC behandelt.

Häufige Fehlermuster:

• Jobs laufen nach einer Änderung der Host-Zeitzone zur falschen Uhrzeit.
• Der Heartbeat wird tagsüber immer übersprungen, weil activeHours.timezone falsch konfiguriert ist.

Nächste Schritte

• /automation/cron-jobs
• /gateway/heartbeat
• /automation/cron-vs-heartbeat
• /concepts/timezone

Hast du weitere Fragen? Frag den AI Setup Assistant.