OpenClaw Status: Verbindung per CLI in Sekunden prüfen

Kennst du das? Du hast alles eingerichtet, aber die Nachrichten kommen einfach nicht an. Anstatt im Dunkeln zu tappen und wild in Konfigurationsdateien zu suchen, solltest du direkt prüfen, was Sache ist. Hier ist ein kurzer Guide, wie du die Konnektivität deiner Channels ohne Rätselraten verifizierst.

Health Checks (CLI)

Kurze Anleitung, um die Channel-Konnektivität zu überprüfen, ohne zu raten.

Schnelle Überprüfungen

• openclaw status — lokale Zusammenfassung: Gateway-Erreichbarkeit/Modus, Update-Hinweise, Alter der Channel-Authentifizierung, Sessions + letzte Aktivitäten.
• openclaw status --all — vollständige lokale Diagnose (read-only, farbig, sicher zum Kopieren für das Debugging).
• openclaw status --deep — prüft zusätzlich das laufende Gateway (Probes pro Channel, sofern unterstützt).
• openclaw health --json — fragt das laufende Gateway nach einem vollständigen Health-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: Verfolge /tmp/openclaw/openclaw-*.log mit tail und filtere nach web-heartbeat, web-reconnect, web-auto-reply, web-inbound.

Tiefendiagnose

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

Konfiguration des Health Monitors

• gateway.channelHealthCheckMinutes: Wie oft das Gateway den Channel-Status prüft. Standard: 5. Setze 0, um Health-Monitor-Restarts global zu deaktivieren.
• gateway.channelStaleEventThresholdMinutes: Wie lange ein verbundener Channel inaktiv bleiben darf, bevor der Health Monitor ihn als veraltet betrachtet und neu startet. Standard: 30. Dieser Wert sollte größer oder gleich gateway.channelHealthCheckMinutes sein.
• gateway.channelMaxRestartsPerHour: Rollierendes Limit für Health-Monitor-Restarts pro Channel/Account innerhalb einer Stunde. Standard: 10.
• channels.<provider>.healthMonitor.enabled: Deaktiviert Health-Monitor-Restarts für einen spezifischen Channel, während das globale Monitoring aktiv bleibt.
• channels.<provider>.accounts.<accountId>.healthMonitor.enabled: Override für mehrere Accounts, der die Einstellung auf Channel-Ebene überschreibt.
• Diese Overrides pro Channel gelten für die integrierten Channel-Monitore, die dies aktuell unterstützen: Discord, Google Chat, iMessage, Microsoft Teams, Signal, Slack, Telegram und WhatsApp.

Wenn etwas schiefgeht

• logged out oder Status 409–515 → Relink mit openclaw channels logout, dann openclaw channels login.
• Gateway nicht erreichbar → Starte es: openclaw gateway --port 18789 (nutze --force, falls der Port belegt ist).
• Keine eingehenden Nachrichten → Bestätige, dass das verknüpfte Telefon online ist und der Absender erlaubt ist (channels.whatsapp.allowFrom); stelle bei Gruppen-Chats sicher, dass Allowlist + Mention-Regeln übereinstimmen (channels.whatsapp.groups, agents.list[].groupChat.mentionPatterns).

Der dedizierte “health”-Befehl

openclaw health --json fragt das laufende Gateway nach seinem Health-Snapshot (keine direkten Channel-Sockets über das CLI). Der Befehl meldet verknüpfte Zugangsdaten/Authentifizierungs-Alter (falls verfügbar), Zusammenfassungen der Probes pro Channel, eine Übersicht des Session-Speichers und die Dauer der Prüfung. Er beendet sich mit einem Fehlercode (non-zero), wenn das Gateway nicht erreichbar ist oder die Prüfung fehlschlägt bzw. ein Timeout auftritt.

Optionen:

• --json: Maschinenlesbare JSON-Ausgabe
• --timeout <ms>: Überschreibt das Standard-Timeout von 10s für die Prüfung
• --probe: Erzwingt eine Live-Prüfung aller Channels, anstatt den zwischengespeicherten Health-Snapshot zurückzugeben

Der Health-Snapshot enthält: ok (Boolean), ts (Zeitstempel), durationMs (Dauer der Prüfung), Status pro Channel, Agenten-Verfügbarkeit und eine Zusammenfassung des Session-Speichers.

Nächste Schritte

• Gateway Konfiguration
• Channel Setup

AI Setup Assistant