Fehlerbehebung
Lösungen für die häufigsten Probleme bei der Einrichtung und im täglichen Gebrauch.
Beginnen Sie hier: Führen Sie den Befehl erneut mit aktivierter Debug-Ausgabe aus. Die zusätzlichen Details zeigen meist, was schiefgelaufen ist.
OFFICECLAWS_DEBUG=1 officeclaws <command>Konto und Abo
This account has no active subscription
Führen Sie officeclaws subscribe aus und schließen Sie die Zahlung ab. Warten Sie eine Minute und führen Sie dann officeclaws onboard erneut aus. Wenn Sie auf der Website mit einer anderen E-Mail-Adresse bezahlt haben, wenden Sie sich an den Support, damit wir die Zahlung mit Ihrem Konto verknüpfen können.
not logged in — run: officeclaws login
Führen Sie officeclaws login aus.
Contabo
contabo: … nach Eingabe der Zugangsdaten
Einer der vier Werte ist falsch. Der häufigste Fehler ist, das Website-Passwort statt des separaten API-Passworts zu verwenden. Siehe Schritt 4.
no VPSes found on your account
Der Server wurde noch nicht ausgeliefert, oder die Zugangsdaten gehören zu einem anderen Contabo-Konto. Prüfen Sie unter my.contabo.com, ob der Server als laufend angezeigt wird.
Die Einrichtung hängt schon lange bei „Waiting for the VPS“ Während der Einrichtung hinterlegt Office Claws seinen SSH-Schlüssel über Contabo, und Contabo startet den Server anschließend neu. Das kann bis zu 30 Minuten dauern. Unterbrechen Sie den Vorgang nicht. Wenn Sie ihn mittendrin abbrechen, kann Contabo den Server für weitere 5–15 Minuten sperren.
Tailscale
Tailscale daemon is not running
Öffnen Sie die Tailscale-App, stellen Sie die Verbindung her und versuchen Sie es erneut.
Auth-Key-Fehler (invalid key, API key does not exist)
Der Key ist abgelaufen, wurde widerrufen oder war nur einmal verwendbar und wurde bereits benutzt. Erstellen Sie einen neuen wiederverwendbaren Key und führen Sie officeclaws onboard --tailscale-authkey tskey-auth-… aus.
Der Agent wird als offline angezeigt, oder der Chat meldet, dass keine Verbindung möglich ist
- Prüfen Sie, ob Tailscale auf Ihrem Computer verbunden ist:
tailscale status. - Prüfen Sie, ob der Server des Agenten in Ihrem Tailnet erscheint. Er wird unter login.tailscale.com/admin/machines aufgeführt.
- Ihr Computer und der Agent müssen sich im selben Tailnet befinden.
- Prüfen Sie im Contabo-Panel, ob der VPS läuft.
- Hat es monatelang funktioniert und dann plötzlich nicht mehr? Wahrscheinlich ist der Tailscale-Key des Servers abgelaufen. Melden Sie sich über die VNC-Konsole von Contabo als
rootam VPS an, mit dem Root-Passwort, das Sie bei der Bestellung festgelegt haben (der Benutzeropenclawkann dort keinsudoverwenden), und führen Sietailscale upaus. Oder beginnen Sie mit einem sauberen Server, siehe Agenten verwalten. Damit das nicht wieder passiert, schalten Sie den Key-Ablauf ab.
Agent und Chat
Der Agent antwortet nicht, oder Sie sehen rpc final event had no text bzw. Verbindungsabbrüche
Höchstwahrscheinlich haben Sie das Codex-Nutzungslimit Ihres ChatGPT-Tarifs erreicht. Warten Sie, bis es zurückgesetzt wird, oder wechseln Sie zu einem höheren ChatGPT-Tarif. Wenn gemeldet wird, dass der Agent mit keinem Modell verbunden ist, führen Sie officeclaws connect-codex aus.
1008 pairing required
Führen Sie officeclaws pairing repair aus.
Die Codex-Anmeldung läuft in ein Timeout
Schließen Sie die Anmeldung innerhalb von 5 Minuten ab, in einem Browser auf demselben Computer. Führen Sie dann officeclaws connect-codex erneut aus.
Der Telegram-Bot antwortet nicht
- Führen Sie
officeclaws telegram showaus und prüfen Sie, ob dortenabled : truesteht. - Im Modus
pairingmüssen Sie Ihr Konto zuerst freigeben. Siehe Telegram. - Stellen Sie sicher, dass kein anderes Programm dasselbe Bot-Token verwendet.
Kommen Sie nicht weiter?
- Sammeln Sie die Logs:
- Ihr Agent:
officeclaws logs --lines 500 - Einrichtung: die neueste Datei in
~/.openclaw/logsauf Ihrem Computer
- Ihr Agent:
- Schreiben Sie uns auf Telegram: t.me/getfrontendeddm. Geben Sie den ausgeführten Befehl, den Fehler und die Logs an. Entfernen Sie vorher alle Keys, Tokens und Passwörter.