Zum Inhalt springen
Ratgeber

OpenClaw antwortet nicht

Die Zwei-Minuten-Triage, dann die üblichen Verdächtigen

5 Min. Lesezeit

Ein OpenClaw-Agent, der einfach nichts tut, ist nach den Kosten die häufigste Beschwerde, und die Diagnose ist fast immer eines von acht Dingen. Das Projekt liefert inzwischen einen Triage-Ablauf, der Sie in etwa zwei Minuten zu einer Diagnose bringt. Hier ist er in klarer Sprache, gefolgt von den Ursachen, die die Foren füllen, und davon, was sich ändert, wenn jemand anderes das Gateway für Sie betreibt.

Die ersten sechzig Sekunden

Gehen Sie die Leiter der Reihe nach durch: triage, status, gateway probe, gateway status, doctor, channels probe, danach verfolgen Sie die Logs. Gesund sieht so aus: erreichbar, Runtime läuft, Konnektivitätsprobe ok, keine blockierenden doctor-Fehler, und jeder Kanal meldet einen aktiven Transport. Der triage-Befehl schreibt eine bereinigte Diagnose, die Sie einem Agenten, einem Forum oder dem Support übergeben können.

Die üblichen Verdächtigen

  • Kopplung ausstehend: Ein unbekannter Absender hat ihm geschrieben, und niemand hat die Anfrage freigegeben, also ignoriert er den Absender absichtlich. Die Produktionsvariante davon ist ein Gateway, das in einer Reconnect-Schleife wegen pairing required feststeckt.
  • Erwähnungsfilter in einer Gruppe: Er verwirft Gruppennachrichten, bis er erwähnt wird, und sagt das auch in den Logs.
  • Eine Zulassungsliste, die nicht passt: Der Absender, der Kanal oder das Modell wird durch eine Richtlinie gefiltert. Ein Modell, das nicht auf der Zulassungsliste steht, lässt Cron-Jobs und Sub-Agenten still scheitern.
  • Das Tool-Profil: Ein minimales Profil erlaubt fast nichts, also antwortet er, kann aber nicht handeln.
  • Der Anbieter: ein Rate-Limit, abgelaufene Zugangsdaten wie ein Google-OAuth-Testtoken oder eine Ablehnung, in den Logs als 429 oder 403 sichtbar.
  • Ein Zustellfehler, der wie ein Job-Fehler aussieht: ein Cron-Job, der mit einem 401 auf Telegram- oder Gateway-Seite als fehlgeschlagen markiert ist, obwohl die Arbeit selbst gelungen ist.
  • Ein Plugin oder Kanal, der nach einem Upgrade deaktiviert wurde: Der Assistent läuft, aber die Tür, über die er früher geantwortet hat, ist zu.
  • Das Gateway selbst: ausgefallen, im Neustart oder auf einem kleinen Host wegen Speichermangels beendet.
Er hing einfach 2 Stunden lang rum und hat nichts getan.

Langsam ist nicht dasselbe wie festgefahren

Eine Antwort, die Minuten zu spät kommt, ist meist ein ausgelastetes Modell, ein langer Kontext, der neu gelesen wird, oder ein Heartbeat-Durchlauf, der die Sitzung belegt. Der OpenClaw-Heartbeat erklärt den letzten Punkt und warum er auch der Grund dafür ist, dass ein untätiger Agent nie ganz untätig ist.

Was sich bei einem verwalteten Host ändert

Die Leiter oben setzt eine Shell auf der Maschine voraus. Bei Diali gibt es keine Maschine: Der Aktivitäts-Feed zeigt Bereitstellung, Updates und Kanalereignisse, das Dashboard bietet Pausieren, Neustarten und Neu installieren, und das Gateway wird für Sie überwacht. Kopplung, Zulassungslisten und das Tool-Profil legen weiterhin Sie fest, denn das sind Richtlinienfragen, keine Infrastruktur. Gehostetes OpenClaw bei Diali beschreibt den Rest.

Bevor Sie in einem Forum posten

  • Führen Sie triage aus und hängen Sie die Ausgabe an; das ist das Erste, wonach jeder Helfer fragen wird.
  • Prüfen Sie Kopplung und Erwähnungsfilter, bevor Sie irgendetwas neu verbinden.
  • Suchen Sie in den Logs nach den drei Signaturen: mention required, pairing request, blocked.
  • Wenn er langsam statt stumm ist, schauen Sie zuerst auf den Anbieter und den Heartbeat.

Und wenn das Wort Gateway in all dem der Teil ist, den Sie nie verstanden haben, hilft unsere Erklärung des OpenClaw-Gateways weiter.

Jetzt starten

Genug gelesen, bauen Sie selbst einen

Richten Sie einen Agenten ein, wählen Sie einen Kanal und lassen Sie ihn in der App arbeiten, die Sie ohnehin geöffnet haben.