Gesundheitschecks (CLI)

Kurze Anleitung zur Überprüfung der Kanal-Konnektivität, ohne raten zu müssen.

Schnellprüfungen

openclaw status — lokale Zusammenfassung: Gateway-Erreichbarkeit/Modus, Update-Hinweis, verknüpftes Kanal-Auth-Alter, Sessions + aktuelle Aktivität.
openclaw status --all — vollständige lokale Diagnose (nur lesend, farbig, sicher zum Einfügen beim Debugging).
openclaw status --deep — fragt zusätzlich das laufende Gateway ab (Kanal-Probes, wenn unterstützt).
openclaw health --json — fragt das laufende Gateway nach einem vollständigen Gesundheits-Snapshot (nur WS; kein direkter Baileys-Socket).
Sende /status als eigenständige Nachricht in WhatsApp/WebChat, um eine Status-Antwort zu erhalten, ohne den Agenten aufzurufen.
Logs: Tail /tmp/openclaw/openclaw-*.log und filtere nach web-heartbeat, web-reconnect, web-auto-reply, web-inbound.

Tiefgehende Diagnose

Credentials auf Disk: ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json (mtime sollte aktuell sein).
Session-Store: ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json (Pfad kann in der Konfiguration überschrieben werden). Anzahl und aktuelle Empfänger werden über status angezeigt.
Relink-Flow: openclaw channels logout && openclaw channels login --verbose, wenn Statuscodes 409–515 oder loggedOut in den Logs erscheinen. (Hinweis: Der QR-Login-Flow startet bei Status 515 nach dem Pairing automatisch einmal neu.)

Wenn etwas fehlschlägt

logged out oder Status 409–515 → Neu verknüpfen mit openclaw channels logout dann openclaw channels login.
Gateway nicht erreichbar → Starten: openclaw gateway --port 18789 (verwende --force, wenn der Port belegt ist).
Keine eingehenden Nachrichten → Bestätige, dass das verknüpfte Telefon online ist und der Absender erlaubt ist (channels.whatsapp.allowFrom); für Gruppenchats stelle sicher, dass Allowlist- + Mention-Regeln passen (channels.whatsapp.groups, agents.list[].groupChat.mentionPatterns).

Dedizierter “health”-Befehl

openclaw health --json fragt das laufende Gateway nach seinem Gesundheits-Snapshot (keine direkten Kanal-Sockets von der CLI). Es meldet verknüpfte Credentials/Auth-Alter wenn verfügbar, Zusammenfassungen pro Kanal-Probe, Session-Store-Zusammenfassung und eine Probe-Dauer. Es beendet sich mit Nicht-Null, wenn das Gateway nicht erreichbar ist oder der Probe fehlschlägt/zeitlich ausläuft. Verwende --timeout <ms>, um den 10s-Standard zu überschreiben.