Fehlerbehebung
Etwas kaputt? Keine Panik. Zuerst diese Befehle in Reihenfolge ausführen:
Erste 60 Sekunden
openclaw status
openclaw status --all
openclaw gateway probe
openclaw logs --follow
openclaw doctorWenn das Gateway erreichbar ist, tiefere Probes:
openclaw status --deepHäufige „es ist kaputt“-Fälle
openclaw: command not found
Fast immer ein Node-/npm-PATH-Problem. Hier anfangen:
Installer schlägt fehl (oder du brauchst vollständige Logs)
Installer im Verbose-Modus erneut ausführen, um die vollständige Spur und npm-Ausgabe zu sehen:
curl -fsSL https://molt.bot/install.sh | bash -s -- --verboseFür Beta-Installationen:
curl -fsSL https://molt.bot/install.sh | bash -s -- --beta --verboseDu kannst auch CLAWDBOT_VERBOSE=1 statt der Option setzen.
Gateway „unauthorized“, verbindet nicht oder verbindet ständig neu
Control UI schlägt über HTTP fehl (Geräteidentität erforderlich)
docs.molt.bot zeigt SSL-Fehler (Comcast/Xfinity)
Einige Comcast-/Xfinity-Verbindungen blockieren docs.molt.bot über Xfinity Advanced Security. Advanced Security deaktivieren oder docs.molt.bot zur Allowlist hinzufügen, dann erneut versuchen.
- Xfinity Advanced Security Hilfe: https://www.xfinity.com/support/articles/using-xfinity-xfi-advanced-security
- Schnelle Prüfung: Mobil-Hotspot oder VPN testen, um ISP-Filterung zu bestätigen
Service meldet „running“, aber RPC-Probe schlägt fehl
Modell-/Auth-Fehler (Rate Limit, Abrechnung, „all models failed“)
/model meldet model not allowed
Das bedeutet meist, dass agents.defaults.models als Allowlist konfiguriert ist. Wenn sie nicht leer ist, können nur diese Provider-/Modell-Keys gewählt werden.
- Allowlist prüfen:
openclaw config get agents.defaults.models - Das gewünschte Modell hinzufügen (oder Allowlist leeren) und
/modelerneut versuchen /modelsnutzen, um die erlaubten Provider/Modelle anzuzeigen
Beim Melden eines Issues
Einen sicheren Report einfügen:
openclaw status --allWenn möglich, den relevanten Log-Tail von openclaw logs --follow mit angeben.