openclaw doctor – Gateway und Channels schnell reparieren

Du kennst das: Gestern lief noch alles, heute wirft das Gateway plötzlich Fehler. Man sucht ewig in Config-Dateien und Logs, nur um festzustellen, dass eine Kleinigkeit nicht stimmt. Statt manuell zu debuggen, solltest du ein Tool nutzen, das die Fehlerquelle direkt identifiziert und behebt.

Meistens sind es veraltete Token oder falsche Umgebungsvariablen, die den Workflow blockieren. openclaw doctor ist genau für diese Momente gedacht, um dein Setup ohne langes Suchen wieder flott zu machen.

Voraussetzungen

• Installiertes openclaw CLI
• Zugriff auf das Terminal

Schnellstart

Der schnellste Weg zur Problemlösung ist der doctor Befehl. Er führt Health Checks für dein Gateway und deine Channels durch.

openclaw doctor

Wenn du Fehler direkt beheben willst, empfehle ich das --repair Flag. Das Tool korrigiert dann bekannte Probleme automatisch.

openclaw doctor --repair

Für eine detaillierte Analyse nutzt du den Deep-Scan:

openclaw doctor --deep

Wichtige Details zum Ablauf:

• Interaktive Prompts: Fixes für Keychain oder OAuth starten nur, wenn dein Terminal stdin als TTY erkennt und --non-interactive nicht gesetzt ist. In Headless-Umgebungen (Cron, Telegram) werden diese Prompts übersprungen.
• Backups: Wenn du --repair (oder den Alias --fix) nutzt, erstellt das Tool ein Backup unter ~/.openclaw/openclaw.json.bak. Unbekannte Keys in deiner Config werden dabei entfernt und aufgelistet.

Fehlerbehebung

macOS: “unauthorized” Fehler durch launchctl

Falls du trotz korrekter Config dauerhaft “unauthorized” Fehler erhältst, könnten alte Umgebungsvariablen in launchctl die Ursache sein. Diese überschreiben deine Config-Datei.

Prüfe die aktuellen Werte:

launchctl getenv OPENCLAW_GATEWAY_TOKEN
launchctl getenv OPENCLAW_GATEWAY_PASSWORD

Falls dort veraltete Daten stehen, kannst du sie so löschen:

launchctl unsetenv OPENCLAW_GATEWAY_TOKEN
launchctl unsetenv OPENCLAW_GATEWAY_PASSWORD

Hast du weitere Fragen? Nutze unseren AI Setup Assistant.

Nächste Schritte

• Troubleshooting Guide
• Security Audit