Ich habe gesehen, dass OpenClaw seltsame Dinge tut. Es stürzt ohne Fehlermeldungen ab. Reagiert aus unerklärlichen Gründen in der falschen Sprache. Weigert sich anzuerkennen, dass ein perfekt konfigurierteter Slack-Kanal existiert. Einmal hat es auf jede Nachricht mit einem Haiku geantwortet. Ich habe nicht um den Haiku-Modus gebeten. Es gibt keinen Haiku-Modus.
Nach acht Monaten und ungefähr 400 „Was zur Hölle?“-Momenten habe ich die 10 Probleme zusammengestellt, die ich am häufigsten gesehen habe – basierend auf meinen eigenen Erfahrungen und der Hilfe für Menschen im Community-Discord. Dies sind keine theoretischen Probleme aus Randfällen der Dokumentation. Das sind die Dinge, die auf echten Installationen tatsächlich kaputtgehen.
1. „Es hat gestern noch funktioniert“ Syndrom
Das häufigste OpenClaw-Problem ist kein Bug – es ist ein API-Schlüssel, der abgelaufen ist, ein Modell, das veraltet ist, oder ein Dienstendpunkt, der sich geändert hat. Du hast nichts geändert, aber etwas am Datenfluss hat es getan.
Diagnose: Überprüfe zuerst die Statusseite deines Modellanbieters. Überprüfe dann die Gültigkeit deines API-Schlüssels. Überprüfe anschließend, ob der Modellname in deiner Konfiguration noch existiert. Neun von zehn Mal ist das Problem extern.
Behebung: Aktualisiere den Schlüssel, den Modellnamen oder den Endpunkt. Setze dir eine Kalendererinnerung, um dies monatlich zu überprüfen, denn Anbieter ändern Dinge, ohne dich zu informieren.
2. Der Speicherleck, der deinen Server auffrisst
Nach ein paar Tagen Laufzeit wird OpenClaw langsam, dann langsamer und stürzt schließlich ab. Die Speichernutzung steigt stetig an, bis das Betriebssystem den Prozess beendet.
Diagnose: Fast immer ist es ein Gesprächskontext, der ohne Grenzen wächst. Jede Nachricht fügt dem Kontext hinzu, und wenn alte Nachrichten nicht entfernt werden, verbraucht der Kontext schließlich den gesamten verfügbaren Speicher.
Behebung: Konfiguriere die Kontextkompression. Setze eine maximale Kontextgröße. Aktiviere die automatische Bereinigung alter Nachrichten. Starte den Dienst nach der Behebung neu und beobachte die Speichernutzung 24 Stunden lang, um zu bestätigen, dass sie stabilisiert.
3. Slack/Discord Bot antwortet nicht
Du hast alles eingerichtet, der Bot zeigt „online“ in Slack/Discord an, aber er antwortet auf keine Nachrichten.
Diagnose: In der Regel ein Berechtigungsproblem. Der Bot benötigt spezifische Berechtigungen (Nachrichten lesen, Nachrichten schreiben, Kanäle lesen) und muss explizit zu jedem Kanal eingeladen werden. Ein weiterer häufiger Grund: Die Webhook-URL ist von außen nicht erreichbar.
Behebung: Überprüfe die Bot-Berechtigungen in der Entwicklerkonsole der Plattform. Vergewissere dich, dass der Bot Mitglied des Kanals ist, in dem du testest. Teste die Webhook-URL von einer externen Quelle (verwende einen Dienst wie httpbin oder requestbin, um zu überprüfen, ob dein Endpunkt erreichbar ist).
4. Cron-Jobs laufen, erzeugen aber leere Ausgaben
Dein geplanter Job läuft pünktlich (du kannst es in den Protokollen sehen), aber die Ausgabe ist leer oder unsinnig.
Diagnose: Der Prompt ist wahrscheinlich zu vage oder bezieht sich auf Daten, auf die der Agent nicht zugreifen kann. „Fasse die heutigen Kennzahlen zusammen“ schlägt fehl, wenn der Agent keinen Zugriff auf die Kennzahlen-Datenbank hat. Der Job läuft, die KI hat nichts, womit sie arbeiten kann, und produziert Müll.
Behebung: Teste den genauen Prompt zuerst als manuelle einmalige Aufgabe. Stelle sicher, dass alle Datenquellen zugänglich sind. Füge explizite Anweisungen hinzu, wo die Daten zu finden sind.
5. Antworten sind schmerzhaft langsam
Jede Antwort dauert 15-30 Sekunden statt der erwarteten 2-3 Sekunden.
Diagnose: Drei häufige Ursachen. Erstens: Dein Gesprächskontext ist zu groß (das Modell muss Tausende von Tokens der Historie verarbeiten, bevor es eine Antwort generiert). Zweitens: Die Modell-API ist langsam (überprüfe den Status des Anbieters). Drittens: Netzwerklatenz zwischen deinem Server und dem API-Endpunkt.
Behebung: Für die Kontextgröße: Aktiviere die Kompression, beschränke die Länge der Historie. Für API-Langsame: Warte, wechsle vorübergehend die Anbieter oder verwende eine zwischengespeicherte Antwort, wenn möglich. Für Netzwerk: Überlege, näher an der Region des API-Anbieters zu hosten.
6. „Rate Limited“ Fehler
Plötzliche Spikes von 429-Fehlern oder der Bot wird während der Hauptnutzung stumm.
Diagnose: Du überschreitest das Nutzungslimit deines API-Anbieters. Dies passiert, wenn mehrere Benutzer gleichzeitig interagieren oder wenn ein Workflow viele API-Aufrufe schnell hintereinander auslöst.
Behebung: Implementiere eine Anfragewarteschlange mit einer planmäßigen Limitierung. Upgrade deine API-Stufe, wenn die kostenlose Stufe zu restriktiv ist. Für Burst-Szenarien füge exponentielles Backoff hinzu (warte und versuche es mit zunehmenden Verzögerungen erneut).
7. Der Agent sagt Dinge, die er nicht sagen sollte
Der Agent gibt Details des System-Prompts preis, reagiert unangemessen oder weicht vom Thema ab in einer Weise, die wie Prompt-Injektion aussieht.
Diagnose: Wenn der Agent untrusted Input ausgesetzt ist (öffentliche Kanäle, Benutzernachrichten), ist eine Prompt-Injektion wahrscheinlich. Jemand hat eine Eingabe erstellt, die deine Systemanweisungen überschreibt.
Behebung: Füge eine Ausgabefilterung für sensible Muster hinzu (API-Schlüssel, Fragmente von System-Prompts). Implementiere eine Eingangsvalidierung für bekannte Injektionsmuster. Für Hochsicherheits-Setups bearbeite untrusted Input in einem separaten Kontext von den Systemanweisungen.
8. Datenbankverbindungsfehler
Der Agent kann keine Verbindung zu deiner Datenbank herstellen oder die Verbindungen brechen intermittierend ab.
Diagnose: Erschöpfung des Verbindungs-Pools (zu viele Verbindungen offen), Authentifizierungsprobleme (Passwort geändert, SSL-Zertifikat abgelaufen) oder Netzwerkprobleme (Firewall blockiert, DNS-Auflösung schlägt fehl).
Behebung: Überprüfe die Einstellungen des Verbindungs-Pools und erhöhe sie, falls erforderlich. Überprüfe die Anmeldeinformationen. Teste die Verbindung unabhängig (verwende einen Datenbank-Client, um zu bestätigen, dass du mit den gleichen Anmeldeinformationen von demselben Server aus verbinden kannst).
9. Dateisystemberechtigungen
Der Agent kann Dateien nicht lesen oder schreiben, obwohl die Pfade korrekt aussehen.
Diagnose: Der OpenClaw-Prozess läuft unter einem spezifischen Benutzerkonto. Dieses Benutzerkonto benötigt Lese-/Schreibberechtigungen für die Verzeichnisse, auf die der Agent zugreifen möchte.
Behebung: Überprüfe, unter welchem Benutzer OpenClaw läuft. Vergewissere dich, dass dieser Benutzer die entsprechenden Berechtigungen für die Zielverzeichnisse hat. Unter Linux: ls -la zur Überprüfung, chown oder chmod zur Behebung. Verwende keine 777-Berechtigungen – gewähre nur den minimal nötigen Zugriff.
10. Updates brechen alles
Du aktualisierst OpenClaw, und deine sorgfältig konfigurierte Einrichtung funktioniert nicht mehr.
Diagnose: Änderungen im Konfigurationsformat zwischen Versionen, entfernte veraltete Funktionen oder Abhängigkeitskonflikte. Dies ist das frustrierendste Problem, weil du deinen Code nicht geändert hast – du wolltest nur die neuesten Funktionen.
Behebung: Lies das Änderungsprotokoll vor dem Update. Sichere deine Konfiguration vor dem Update. Teste das Update zuerst auf einer Entwicklungsinstanz. Wenn etwas kaputtgeht, ermöglicht dir dein Backup, sofort zurückzurollen. Aktualisiere niemals die Produktion ohne ein verifiziertes Backup und einen Rollback-Plan.
Der universelle Debugging-Ansatz
Wenn etwas kaputtgeht und du nicht weißt warum:
1. Überprüfe die Protokolle (90% der Antworten sind in den Protokollen)
2. Überprüfe externe Dienste (API-Status, Datenbankverbindung, Netzwerk)
3. Überprüfe, was sich geändert hat (hast du etwas aktualisiert? Hat der Anbieter etwas geändert?)
4. Reproduziere das Problem (kannst du es konsistent auslösen?)
5. Suche im Community-Discord (jemand anderes hat wahrscheinlich schon darauf gestoßen)
Und wenn alles andere fehlschlägt: Starte den Dienst neu und sieh nach, ob das Problem verschwindet. Es sollte nicht der erste Schritt sein, aber es ist ein gültiges letztes Mittel. Manchmal verhalten sich Computer einfach wie Computer.
🕒 Published: