Fehlerbehebung

Etwas funktioniert nicht? Keine Panik! Folge der Anleitung unten Schritt für Schritt — die meisten Probleme lassen sich selbst beheben.

🔍 Diagnose-Leiter (der Reihe nach vorgehen)

Wenn OpenClaw Probleme macht, gehe in dieser Reihenfolge vor:

Laufstatus prüfen

openclaw status

Prüfe, ob OpenClaw noch läuft. Wenn "stopped" angezeigt wird oder ein Fehler auftritt, versuche zuerst einen Neustart.

Gateway-Status prüfen

openclaw gateway status

Das Gateway ist die Brücke zwischen OpenClaw und den Chat-Plattformen. Wenn der Gateway-Status nicht in Ordnung ist, können keine Nachrichten gesendet oder empfangen werden.

Protokolle einsehen

openclaw logs

In den Protokollen werden alle Details zum Betrieb von OpenClaw aufgezeichnet. Bei Fehlern findest du dort normalerweise rote Fehlermeldungen, die dir sagen, was schiefgelaufen ist.

Gesundheitscheck durchführen

openclaw doctor

Ein umfassender Gesundheitscheck, der dir zeigt, welche Komponenten in Ordnung sind und welche Probleme haben.

Kanalverbindungen prüfen

openclaw channels status

Zeigt den Verbindungsstatus der einzelnen Chat-Kanäle an, um festzustellen, ob ein Kanal getrennt wurde.

🐛 Häufige Fehler und Lösungen

Fehler: "openclaw: command not found"

Ursache: Das System kann den Befehl openclaw nicht finden, meistens ein Problem mit der PATH-Umgebungsvariable.

Lösung:

# Installationsort von openclaw prüfen
npm list -g openclaw

# Globales npm-Verzeichnis zum PATH hinzufügen
export PATH="$(npm config get prefix)/bin:$PATH"

# Den obigen Befehl in die Shell-Konfigurationsdatei eintragen, damit er dauerhaft gilt
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Fehler: Port-Konflikt (EADDRINUSE: address already in use :::18789)

Ursache: Port 18789 wird bereits von einem anderen Programm belegt.

Lösung:

# Prozess finden, der den Port belegt
lsof -i :18789

# Alten OpenClaw-Prozess stoppen
openclaw stop

# Falls es kein OpenClaw-Prozess ist, kannst du den Port in der Konfiguration ändern
# Bearbeite ~/.openclaw/openclaw.json und ändere den port-Wert

Fehler: 429 Too Many Requests (Ratenbegrenzung)

Ursache: Du hast zu viele Anfragen in kurzer Zeit gesendet. KI-Modellanbieter haben Frequenzlimits für API-Aufrufe.

Lösung:

Warte ein paar Minuten und versuche es erneut
Reduziere die Häufigkeit deiner Nachrichten
Stufe deinen API-Tarif hoch, um höhere Ratenlimits zu erhalten
Wechsle zu einem Modellanbieter mit großzügigeren Limits

Fehler: Gateway lässt sich nicht starten

Ursache: Möglicherweise ist der Bot-Token ungültig, es gibt Netzwerkprobleme oder die Chat-Plattform-API hat sich geändert.

Lösung:

# Gateway-Protokolle prüfen
openclaw gateway logs

# Bot-Token auf Gültigkeit prüfen
openclaw channels verify

# Gateway neu starten
openclaw gateway restart

Fehler: Nachrichten können nicht gesendet werden

Ursache: Möglicherweise ist die Kanalkonfiguration fehlerhaft, es gibt Netzwerkprobleme oder der Bot hat unzureichende Berechtigungen.

Lösung:

Kanalstatus prüfen: openclaw channels status
Sicherstellen, dass der Bot auf der entsprechenden Plattform Sendeberechtigungen hat
Netzwerkverbindung prüfen
In den Protokollen nach konkreten Fehlermeldungen suchen

Fehler: Dashboard öffnet sich nicht

Ursache: Der OpenClaw-Dienst läuft möglicherweise nicht, oder die Portkonfiguration ist falsch.

Lösung:

# Prüfen, ob OpenClaw läuft
openclaw status

# Falls nicht, starte es
openclaw start

# Dann versuche, das Dashboard zu öffnen
openclaw dashboard

# Oder rufe direkt im Browser auf
# http://127.0.0.1:18789/

🆘 Problem immer noch nicht gelöst?

Wenn die oben genannten Methoden nicht helfen, kannst du:

Auf GitHub Issues nach deinem Problem suchen oder ein neues Issue erstellen
Der OpenClaw Discord-Community beitreten und um Hilfe bitten
Bitte füge bei Fragen die Ausgabe von openclaw doctor und openclaw logs bei