ClawHosters
von Daniel Samer
6 Min. Lesezeit
Dein Bot zeigt sich als online. Du schickst eine Nachricht. Keine Antwort. Du wartest. Immer noch nichts.
Wenn dein AI Agent nicht funktioniert und du deshalb um 2 Uhr nachts hier gelandet bist, dann bist du richtig. Die meisten OpenClaw-Probleme fallen in eine Handvoll bekannter Muster, und fast alle lassen sich in unter fünf Minuten lösen. Hier ist die Diagnose-Leiter, die dich schnell weiterbringt.
Erster Schritt: Die Diagnose-Befehle
Bevor du irgendetwas anderes anfasst, führe diese Befehle der Reihe nach aus:
openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw doctor findet nach meiner Erfahrung etwa 78% aller Probleme von alleine. Wenn der Befehl einen Fix vorschlägt, probier den zuerst. Falls nicht, lies weiter.
Bot online, aber keine Antworten
Das ist mit Abstand das häufigste Problem. Dein Bot erscheint in Telegram (oder welchem Messenger auch immer) als online, ignoriert aber jede Nachricht.
In neun von zehn Fällen liegt es am Pairing. OpenClaw verlangt eine explizite Freigabe, bevor es auf Nachrichten antwortet. Schau in die Logs:
openclaw logs --follow
Achte auf Zeilen mit drop dm (pairing required). Wenn du die siehst, funktioniert dein Bot einwandfrei. Er wartet nur darauf, dass du die Konversation freigibst.
openclaw pairing pending
Das zeigt alle offenen Pairing-Anfragen. Genehmige sie und die Nachrichten fließen.
Aber wenn Pairing nicht das Problem ist, prüfe deine dmPolicy-Einstellung. Steht die auf einem restriktiven Wert, verwirft der Bot Nachrichten ohne einen offensichtlichen Fehler ins Log zu schreiben. Prüfe auch, ob der Group-Privacy-Modus den Bot daran hindert, Nachrichten in Gruppenchats zu sehen.
Gateway startet nicht
Du führst openclaw gateway start aus und der Befehl bricht mit einem Fehler ab oder hängt. Das liegt meistens an einem von zwei Dingen.
Port-Konflikt. Etwas anderes belegt bereits Port 9090 oder 18789:
ss -tlnp | grep -E '9090|18789'
Falls ein anderer Prozess die Ports blockiert, beende ihn oder konfiguriere um.
Veraltete PID-Datei. Das Gateway glaubt, es läuft bereits:
rm ~/.openclaw/gateway.pid
openclaw gateway start
Wenn beides nicht hilft, hast du wahrscheinlich einen Config-Schema-Fehler nach einem Update. openclaw doctor --fix versucht dann, deine Konfiguration auf das aktuelle Schema zu migrieren.
401 API-Key-Fehler
Deine Logs sind voll mit 401 Unauthorized vom LLM-Provider. Das bedeutet, dein API Key ist falsch, gesperrt oder wird überschrieben.
Prüfe zuerst, welchen Key OpenClaw tatsächlich verwendet. Ein häufiger Stolperstein: Du hast den Key in der Config-Datei gesetzt, aber eine alte Shell-Umgebungsvariable wie ANTHROPIC_API_KEY überschreibt ihn. Prüfe das mit env | grep -i anthropic (oder dem jeweiligen Provider).
Wenn die Umgebung sauber aussieht, authentifiziere dich neu:
openclaw models auth login --provider anthropic
Und kontrolliere, ob der Key-Prefix zu deinem Provider passt. Anthropic-Keys beginnen mit sk-ant-, OpenAI mit sk-. Klingt offensichtlich, aber ich habe schon öfter gesehen, dass Keys vom falschen Provider eingefügt werden, als man denken würde.
429 Rate-Limit-Fehler
Dieser Fehler verwirrt viele, weil er wie ein Key-Problem aussieht. Ist er aber nicht. Ein 429 bedeutet, dass du das Anfragen-pro-Minute oder Token-pro-Minute-Kontingent deines Providers überschritten hast.
Schnelle Lösungen, sortiert nach Aufwand:
- Deaktiviere
context1m, falls du es verwendest. Dieses Feature schickt pro Anfrage viele Tokens. - Füge ein Fallback-Modell in deiner Config hinzu. Wenn Claude rate-limited ist, wird der Traffic auf ein günstigeres Modell umgeleitet.
- Upgrade dein API-Tier beim Provider.
Wenn du regelmäßig auf 429er läufst, behandelt unser Leitfaden zur Token-Kostenoptimierung Strategien, um Verbrauch (und Kosten) im Griff zu behalten.
Docker Container startet immer wieder neu
Nach einem Update gerät dein Container in eine Restart-Schleife. Die Logs zeigen Config-bezogene Fehler.
Das bedeutet fast immer, dass die neue Version Breaking Changes in der Konfiguration eingeführt hat. Führe aus:
openclaw doctor
Der Befehl sagt dir genau, welche Config-Felder sich geändert haben. Vielleicht musst du einen Key umbenennen, eine veraltete Einstellung entfernen oder eine Sektion umstrukturieren. Der doctor-Befehl erledigt das meiste automatisch, wenn du --fix anhängst.
Ein versions-spezifischer Hinweis: Das Upgrade von v2026.4.24 auf v2026.4.29+ verursachte CPU-Auslastung und RPC-Latenz-Spitzen (bis zu 144 Sekunden in manchen Fällen). Wenn du darauf stößt, stelle deine Config- und State-Verzeichnisse aus dem Backup wieder her, bevor du erneut aktualisierst.
Langsame Antwortzeiten
Dein Bot antwortet, aber es dauert 15, 20, manchmal 30 Sekunden. Die Frage ist, ob der Engpass beim LLM-Provider liegt oder bei deinem Gateway.
openclaw diagnostics
Das schlüsselt die Latenz nach Komponente auf. Wenn die LLM-Antwortzeit dominiert, ist dein Provider langsam, und da kannst du wenig machen außer das Modell zu wechseln. Wenn der Gateway-Overhead hoch ist, hast du wahrscheinlich ein Netzwerkproblem zwischen deinem Server und dem API-Endpoint, oder dein Server ist unterdimensioniert.
Managed Hosting: Was dich nicht betrifft
Wenn du OpenClaw auf ClawHosters betreibst, sind Docker-Neustarts, Port-Konflikte und Config-Migrations-Probleme für dich kein Thema. Das wird automatisch erledigt. Die Probleme, die du tatsächlich haben wirst, betreffen API-Key-Konfiguration, Channel-Pairing und Modellauswahl. Details zum Einrichten findest du im Setup Guide.
Unabhängig davon, wie du hostest: Der Security Hardening Guide behandelt die wichtigsten Sicherheitsaspekte.
