OpenClaw 2.0 Flottenmigration: Was wirklich kaputtging

Ein einzelnes OpenClaw zu aktualisieren ist eine Sache, aber bei einer Flotte von Live-Clients potenzieren sich alle Probleme. Ein Team verbrachte einen ganzen Tag mit der Migration auf OpenClaw 2.0 und teilte die größten Stolpersteine. Hier ist, was wirklich kaputtging und wie man es vermeidet.

Konfigurationsschema wurde strenger

In 2.0 ist das Konfigurationsschema strenger und einige Felder wurden verschoben (Env-Keys, TTS, Medienmodelle). Die größte Falle: doctor --fix löscht unbekannte Felder stillschweigend. Wenn Ihr Model-Key in einem Bereich liegt, der jetzt veraltet ist, kann er zusammen mit diesen Feldern verschwinden. Das Team schrieb die Konfigurationen von Hand um, bevor es doctor ausführte, um den Verlust von Keys zu vermeiden.

Externe Plugins blockieren das Gateway

WhatsApp, Brave, Discord und Perplexity sind nicht mehr im Kern-Image enthalten; sie sind externe Plugins. Wenn Ihre Konfiguration sie weiterhin referenziert, wird das Gateway nie bereit, der Container startet in einer Endlosschleife neu, und von außen sieht es wie ein 502 aus. Das bloße Hinzufügen der Plugins zum Image reicht nicht aus, da die Zustimmung zur Funktionsfähigkeit an die spezifische Maschine gebunden ist und doctor sie nicht akzeptiert. Der einzige funktionierende Ansatz ist, openclaw plugins install ... --accept-capabilities als separaten Schritt auszuführen.

Gerätekopplung: Cloudflare-Header brechen Lokalität

Der Webchat begann, PAIRING_REQUIRED zu werfen. Die Ursache: 2.0 vertraut nur Anfragen von Loopback ohne weitergeleitete Header. Sie in nginx nicht zu setzen, reicht nicht – Cloudflare sendet eigene Header, also müssen Sie sie in nginx explizit auf null setzen. Das sah wie ein defektes Token aus, war aber ein Konflikt zwischen Cloudflare, nginx und OpenClaws Lokalitätslogik.

Perplexity lädt unerwünscht automatisch

Perplexity wird automatisch geladen, wenn es einen OpenRouter-Key erkennt, und verlangt dann Zustimmung, selbst wenn Sie das Plugin nicht wollen. Das Setzen von enabled: false hilft nicht; Sie müssen plugins.deny verwenden, um es zu blockieren.

Fazit: Verfügbarkeit über Features

Das Grundprinzip: Es ist besser, vorübergehend Websuche oder einen einzelnen Kanal zu verlieren, als den gesamten Agenten mit einem 502 lahmzulegen. Planen Sie mehrere Ausfälle ein und testen Sie jede Komponente einzeln.

Dies basiert auf einem echten Migrationsbericht einer Cloud-Plattform, die OpenClaw für Kunden hostet. Wenn Sie ein Upgrade planen, lesen Sie die Quelle für weitere Details und Community-Einblicke.