Zum Hauptinhalt springen

​
FAQ

Kurze Antworten plus vertiefte Fehlerbehebung für reale Setups (lokale Entwicklung, VPS, Multi-Agent, OAuth/API-Schlüssel, Modell-Failover). Für Laufzeitdiagnosen siehe Troubleshooting. Für die vollständige Konfigurationsreferenz siehe Configuration.

​
Inhaltsverzeichnis

​
First 60 seconds if something’s broken

  1. Quick status (first check) 
    openclaw status
    Schnelle lokale Übersicht: OS + Update, Gateway-/Service-Erreichbarkeit, Agenten/Sitzungen, Provider-Konfiguration + Laufzeitprobleme (wenn das Gateway erreichbar ist).
  2. Pastebarer Bericht (sicher zum Teilen) 
    openclaw status --all
    Nur-Lese-Diagnose mit Log-Tail (Tokens redacted).
  3. Daemon + Port-Status 
    openclaw gateway status
    Zeigt Supervisor-Laufzeit vs. RPC-Erreichbarkeit, die Probe-Ziel-URL und welche Konfiguration der Service wahrscheinlich verwendet hat.
  4. Deep probes 
    openclaw status --deep
    Führt Gateway-Health-Checks + Provider-Probes aus (benötigt ein erreichbares Gateway). Siehe Health.
  5. Aktuelles Log verfolgen 
    openclaw logs --follow
    Wenn RPC down ist, fallback: 
    tail -f "$(ls -t /tmp/openclaw/openclaw-*.log | head -1)"
    Dateilogs sind getrennt von Service-Logs; siehe Logging und Troubleshooting.
  6. Doctor ausführen (Reparaturen) 
    openclaw doctor
    Repariert/migriert Config/State + führt Health-Checks aus. Siehe Doctor.
  7. Gateway-Snapshot 
    openclaw health --json
openclaw health --verbose   # zeigt Ziel-URL + Config-Pfad bei Fehlern
    Fragt das laufende Gateway nach einem vollständigen Snapshot (nur WS). Siehe Health.

​
Schnellstart und Ersteinrichtung

​
Im stuck was ist der schnellste Weg wieder weiterzukommen

Benutze einen lokalen KI-Agenten, der deine Maschine sehen kann. Das ist viel effektiver als in Discord zu fragen, weil die meisten „Ich stecke fest“-Fälle lokale Konfigurations- oder Umgebungsprobleme sind, die entfernte Helfer nicht inspizieren können. Diese Tools können das Repo lesen, Befehle ausführen, Logs inspizieren und dir helfen, dein maschinennahes Setup zu reparieren (PATH, Services, Berechtigungen, Auth-Dateien). Gib ihnen den vollständigen Source-Checkout über die hackbare (git) Installation: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
Das installiert OpenClaw aus einem Git-Checkout, sodass der Agent Code + Docs lesen und über die exakte Version nachdenken kann, die du gerade nutzt. Du kannst jederzeit zurück zu stable wechseln, indem du den Installer ohne --install-method git erneut ausführst. Tipp: Bitte den Agenten, den Fix zu planen und zu überwachen (Schritt für Schritt) und dann nur die notwendigen Befehle auszuführen. Das hält Änderungen klein und auditierbar. Wenn du einen echten Bug oder Fix findest, erstelle bitte ein GitHub-Issue oder sende eine PR: Starte mit diesen Befehlen (Ausgaben teilen, wenn du Hilfe suchst): 
openclaw status
openclaw models status
openclaw doctor
Was sie tun:
  • openclaw status: schneller Snapshot von Gateway-/Agent-Health + Basis-Config.
  • openclaw models status: prüft Provider-Auth + Modellverfügbarkeit.
  • openclaw doctor: validiert und repariert häufige Config-/State-Probleme.
Weitere nützliche CLI-Checks: openclaw status --all, openclaw logs --follow, openclaw gateway status, openclaw health --verbose. Schnelle Debug-Schleife: First 60 seconds if something’s broken.