Skip to main content

​
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)
    Schnelle lokale Übersicht: OS + Update, Gateway-/Service-Erreichbarkeit, Agenten/Sitzungen, Provider-Konfiguration + Laufzeitprobleme (wenn das Gateway erreichbar ist).
  2. Pastebarer Bericht (sicher zum Teilen)
    Nur-Lese-Diagnose mit Log-Tail (Tokens redacted).
  3. Daemon + Port-Status
    Zeigt Supervisor-Laufzeit vs. RPC-Erreichbarkeit, die Probe-Ziel-URL und welche Konfiguration der Service wahrscheinlich verwendet hat.
  4. Deep probes
    Führt Gateway-Health-Checks + Provider-Probes aus (benötigt ein erreichbares Gateway). Siehe Health.
  5. Aktuelles Log verfolgen
    Wenn RPC down ist, fallback:
    Dateilogs sind getrennt von Service-Logs; siehe Logging und Troubleshooting.
  6. Doctor ausführen (Reparaturen)
    Repariert/migriert Config/State + führt Health-Checks aus. Siehe Doctor.
  7. Gateway-Snapshot
    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:
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):
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.