Health-Checks (CLI)

Kurze Anleitung, um die Kanalverbindung zu prüfen, ohne zu raten.

Schnellprüfungen

openclaw status — lokale Zusammenfassung: Gateway-Erreichbarkeit/Modus, Update-Hinweis, Alter der verknüpften Kanal-Auth, Sitzungen + aktuelle Aktivität.
openclaw status --all — vollständige lokale Diagnose (nur lesend, farbig, zum Einfügen bei der Fehlersuche geeignet).
openclaw status --deep — prüft zusätzlich den laufenden Gateway (pro Kanal, wenn unterstützt).
openclaw health --json — fordert vom laufenden Gateway einen vollständigen Health-Snapshot an (nur WS; kein direkter Baileys-Socket).
/status als eigenständige Nachricht in WhatsApp/WebChat senden, um eine Statusantwort ohne Aufruf des Agenten zu erhalten.
Logs: tail /tmp/openclaw/openclaw-*.log und nach web-heartbeat, web-reconnect, web-auto-reply, web-inbound filtern.

Tiefere Diagnose

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

Wenn etwas fehlschlägt

logged out oder Status 409–515 → erneut verknüpfen mit openclaw channels logout, danach openclaw channels login.
Gateway nicht erreichbar → starten: openclaw gateway --port 18789 (bei belegtem Port --force verwenden).
Keine eingehenden Nachrichten → prüfen, ob das verknüpfte Telefon online ist und der Absender erlaubt ist (channels.whatsapp.allowFrom); bei Gruppenchats Allowlist- und Erwähnungsregeln prüfen (channels.whatsapp.groups, agents.list[].groupChat.mentionPatterns).

Eigenständiger Befehl „health“

openclaw health --json fordert vom laufenden Gateway seinen Health-Snapshot an (keine direkten Kanal-Sockets vom CLI). Es meldet verknüpfte Credentials/Auth-Alter (falls vorhanden), pro-Kanal-Probe-Zusammenfassungen, Sitzungsspeicher-Zusammenfassung und Probendauer. Beendet sich mit Exitcode ungleich null, wenn der Gateway nicht erreichbar ist oder die Probe fehlschlägt/zeitüberschreitet. --timeout <ms> überschreibt den Standard von 10s.