Health Checks (CLI)

Kurze Anleitung, um die Channel-Verbindung zuverlässig zu prüfen.

Schnelle Checks

  • openclaw status — lokale Zusammenfassung: Gateway-Erreichbarkeit/Modus, Update-Hinweis, Alter der Channel-Authentifizierung, Sessions und letzte Aktivitäten.
  • openclaw status --all — vollständige lokale Diagnose (nur lesend, farbig, sicher zum Teilen beim Debugging).
  • openclaw status --deep — prüft zusätzlich das laufende Gateway (mit Channel-Probes, falls unterstützt).
  • openclaw health --json — fragt das laufende Gateway nach einem vollständigen Health-Snapshot (nur WS; kein direkter Baileys-Socket).
  • Sende /status als einzelne Nachricht in WhatsApp/WebChat, um eine Statusantwort zu bekommen, ohne den Agent aufzurufen.
  • Logs: Schau in /tmp/openclaw/openclaw-*.log und filtere nach web-heartbeat, web-reconnect, web-auto-reply, web-inbound.

Tiefere Diagnose

  • Credentials auf der Festplatte: 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 Config überschrieben werden). Anzahl und letzte Empfänger werden über status angezeigt.
  • Neu verbinden: openclaw channels logout && openclaw channels login --verbose wenn Statuscodes 409–515 oder loggedOut in den Logs erscheinen. (Hinweis: Der QR-Login startet bei Status 515 nach dem Pairing automatisch einmal neu.)

Wenn etwas nicht funktioniert

  • logged out oder Status 409–515 → neu verbinden mit openclaw channels logout und dann openclaw channels login.
  • Gateway nicht erreichbar → starte es: openclaw gateway --port 18789 (nutze --force wenn der Port belegt ist).
  • Keine eingehenden Nachrichten → prüfe, ob das verknüpfte Handy online ist und der Absender erlaubt ist (channels.whatsapp.allowFrom); bei Gruppenchats stelle sicher, dass Allowlist und Mention-Regeln passen (channels.whatsapp.groups, agents.list[].groupChat.mentionPatterns).

Der “health”-Befehl

openclaw health --json fragt das laufende Gateway nach seinem Health-Snapshot (kein direkter Channel-Socket vom CLI). Er zeigt verknüpfte Credentials/Auth-Alter wenn verfügbar, Zusammenfassungen der Channel-Probes, Session-Store-Zusammenfassung und die Probe-Dauer. Der Befehl gibt einen Fehlercode zurück, wenn das Gateway nicht erreichbar ist oder der Probe fehlschlägt/timeoutet. Mit --timeout <ms> kannst du den Standard von 10s überschreiben.