OpenClaw 2026.9.6 Migrationshinweise: replace:true-Chunks, entfernte Konfigurationsschlüssel und strikte Sitzungsmodelle

Ein Entwickler, der einen eigenen WebSocket-Client gegen das OpenClaw-Gateway betreibt, hat drei Breaking Changes zwischen den Releases 2026.9.1 und 2026.9.6 dokumentiert. Jede einzelne hat Zeit gekostet, daher hier die Essenz.

1. replace:true beim letzten Assistant-Chunk

OpenAI-Modelle laufen jetzt über das Codex-Plugin. Nachdem die Antwort unter dem Item msg_… gestreamt wurde, sendet das Gateway einen weiteren stream=assistant-Chunk unter einer neuen itemId mit replace:true und dem identischen Volltext.

Wenn dein Client jede neue itemId als neuen Absatz behandelt, wird jede Antwort doppelt gerendert. Die Lösung: das replace-Flag beachten – den Inhalt des vorherigen Items ersetzen statt anzuhängen.

2. agents.defaults.compaction.reserveTokensFloor entfernt

Dieser Config-Key wurde entfernt. Bleibt er in openclaw.json stehen, meldet die Konfiguration sich als ungültig: Jeder CLI-Befehl verweigert den Dienst, und das Gateway kommt nach dem nächsten Neustart nicht mehr hoch.

Befehle zur Wiederherstellung:

openclaw config validate
openclaw doctor --fix

validate nennt den störenden Key; doctor --fix entfernt ihn. Der Autor merkt an, dass er ihn manuell wieder eingefügt und damit erneut alles kaputt gemacht hat – also nicht nachmachen.

3. Session-Modelle sind strikt bei Fallbacks

agents.defaults.model.fallbacks schützt nur das konfigurierte Standardmodell. Ein pro Session über sessions.patch gewähltes Modell ist strikt: Liefert der Provider einen 503, schlägt der Run sichtbar fehl, statt auf die Fallback-Kette auszuweichen. Das ist dokumentiertes Verhalten.

Kleinere Änderungen

• models.list liefert Einträge aus agents.defaults.models zurück, nicht den vollständigen Katalog.
• chat.startup-Defaults nennen das Provider-Feld jetzt modelProvider.

Der Autor fragt, ob jemand in 9.7 oder 9.8 weitere clientrelevante Änderungen gesehen hat.