Troubleshooting

Die ersten 60 Sekunden

Führe diese Befehle der Reihe nach aus:

openclaw status
openclaw status --all
openclaw gateway probe
openclaw logs --follow
openclaw doctor

Wenn das Gateway erreichbar ist, mach eine tiefere Prüfung:

openclaw status --deep

Häufige Probleme

openclaw: command not found

Fast immer ein Node/npm PATH-Problem. Schau hier:

• Installation (Node/npm PATH-Prüfung)

Installer schlägt fehl (oder du brauchst vollständige Logs)

Führe den Installer im Verbose-Modus aus, um die vollständige Ausgabe und npm-Logs zu sehen:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose

Für Beta-Installationen:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose

Du kannst auch OPENCLAW_VERBOSE=1 statt des Flags setzen.

Gateway “unauthorized”, keine Verbindung, oder ständige Reconnects

• Gateway Troubleshooting
• Gateway Authentifizierung

Control UI schlägt bei HTTP fehl (Device Identity erforderlich)

• Gateway Troubleshooting
• Control UI

docs.openclaw.ai zeigt SSL-Fehler (Comcast/Xfinity)

Manche Comcast/Xfinity-Verbindungen blockieren docs.openclaw.ai über Xfinity Advanced Security. Deaktiviere Advanced Security oder füge docs.openclaw.ai zur Allowlist hinzu und versuch es nochmal.

• Xfinity Advanced Security Hilfe: https://www.xfinity.com/support/articles/using-xfinity-xfi-advanced-security
• Schnelle Checks: Probier einen mobilen Hotspot oder VPN aus, um zu prüfen, ob es am ISP liegt

Service läuft angeblich, aber RPC-Probe schlägt fehl

• Gateway Troubleshooting
• Background Process / Service

Model/Auth-Fehler (Rate Limit, Billing, “all models failed”)

• Models
• OAuth / Auth-Konzepte

/model sagt model not allowed

Das bedeutet normalerweise, dass agents.defaults.models als Allowlist konfiguriert ist. Wenn die Liste nicht leer ist, können nur diese Provider/Model-Keys ausgewählt werden.

• Prüf die Allowlist: openclaw config get agents.defaults.models
• Füge das gewünschte Model hinzu (oder leere die Allowlist) und versuch /model nochmal
• Nutze /models, um die erlaubten Provider/Models zu durchsuchen

Wenn du ein Issue erstellst

Füge einen sicheren Report ein:

openclaw status --all

Falls möglich, füge die relevanten Log-Ausgaben von openclaw logs --follow hinzu.