【Loesungs-Log】HTTP 500:404 NOT_FOUND nach OpenClaw-Upgrade? Meine Fehleranalyse und Reparatur-Erfahrung

HTTP 500 500:404 NOT_FOUND nach dem OpenClaw-Upgrade? Mein Loesungs-Log

Hallo zusammen, ich bin der Programmierer, der gerne lokale AI-Tools herumspielt. Kuerzlich habe ich OpenClaw von einer aelteren Version auf die neueste aktualisiert – eigentlich gar nicht so alt, nur von 2026.3.2 auf 2026.3.8. Nach dem Neustart wollte ich einen Chat starten und stand da: Auf der Web UI prangte eine rote Fehlermeldung:

HTTP 500 500:404 NOT_FOUND

Das sah alles andere als gut aus. Vor dem Upgrade lief alles einwandfrei, das Upgrade-Log zeigte keine Fehler, und auf einmal konnte die Gateway nicht mehr erreicht werden – Nachrichten vom Agent blieben einfach stecken.

Meine erste Reaktion: natuerlich der universelle Schluessel aus der offiziellen Doku – openclaw doctor.

openclaw doctor --fix

Zweimal durchlaufen lassen, Ausgabe jedes Mal “Everything looks good!” – nicht mal eine Warnung. Ich dachte, jetzt wirds boese, ist irgendwas in der Konfiguration komplett kaputt? Dann bin ich durch GitHub-Issues, Discord-Gruppen und Dokumentation gegangen und habe alles durchsucht. Ein paar aehnliche 404-Bugs gab es zwar, aber die lagen meistens an Model-Fallbacks oder der OpenAI Responses API – mit meinem “Alles-kaputt-nach-Upgrade”-Problem hatte das nichts zu tun.

Nach fast einer Stunde Herumgewuerge wollte ich fast deinstallieren und neu installieren (aber dann haette ich meine ganzen konfigurierten Channels und Skills verloren). Am Ende habe ich es mit der brutalsten Methode probiert – einfach openclaw onboard ausgefuehrt und die Konfiguration zurueckgesetzt. (Original-Konfigurationsdatei und Skills-Ordner vorher sichern! Wer sich zutraut, kann die alten Dateien danach vergleichen und gezielt uebernehmen.)

Konkret waren es nur zwei Schritte:

1. Zunaechst die aktuelle Gateway stoppen (zur Sicherheit):

   openclaw gateway stop
   # oder systemctl stop openclaw-gateway (je nachdem, wie du den Daemon installiert hast)

2. Reset-Assistenten ausfuehren:

   openclaw onboard --reset

   (Achtung: --reset loescht die alte config + credentials + sessions. Laut Doku ist das das Standardverhalten. Ich hab direkt den Vollreset mit --reset-scope full gemacht – die alten Daten hatte ich ja sowieso gesichert.)

Im Assistenten “Quick Start” durchklicken, API-Token und Channels neu konfigurieren… und dabei gemerkt, dass es wieder mehr Konfigurationspunkte gibt, kompatibel mit dem neuesten ChatGPT-5.4-Modell. Der ganze Prozess dauerte keine 3 Minuten. (Dafuer bin ich halt der Typ, der es ueber 10 Mal installiert hat.)

Am Ende “Web UI” waehlen, die Seite oeffnet sich automatisch, ein “Hello” abgeschickt – und der Chat funktioniert wieder! Dieses verdammte 500:404 war einfach voellig verschwunden.

Warum hat doctor nichts gebracht, aber onboard hat alles gerettet?

Das ist eigentlich ein ganz klassischer “Altconfig-Fehler nach Upgrade”. OpenClaw entwickelt sich rasant weiter (frueher hiess es Clawdbot/Moltbot), Anfang Maerz waren es schon 4 Versionen, und bei jedem Versionsprung kann sich das Config-Schema aendern. In der Doku steht aber nirgends ausdruecklich “Nach Upgrade unbedingt onboard-Reset ausfuehren”. Ich bin da reingefallen, und dieses kleine Erfahrungsstueckchen soll anderen ersparen, denselben Fehler zu machen.

Diese ganze Aktion hat zwar etwas Zeit gekostet, aber ich kenne die Konfigurationsmechanik von OpenClaw jetzt noch eine Ebene besser. So schoen lokale AI-Tools auch sind – bei Upgrades immer vorsichtig bleiben.

Ich hoffe, dieser kleine Beitrag hilft allen, die von 500:404 gequaelt werden! Bis zum naechsten Mal.