Notes de migration OpenClaw 2026.9.6 : chunks replace:true, clés de configuration retirées et modèles de session stricts

Un développeur qui maintient un client WebSocket personnalisé connecté à la passerelle OpenClaw a documenté trois changements majeurs entre les versions 2026.9.1 et 2026.9.6. Chacun a coûté du temps, voici donc l'essentiel.

1. replace:true sur le chunk assistant final

Les modèles OpenAI passent désormais par le plugin codex. Après avoir diffusé la réponse sous l'élément msg_…, la passerelle envoie un chunk supplémentaire stream=assistant sous un nouvel itemId avec replace:true et le texte intégral identique.

Si votre client traite chaque nouveau itemId comme un nouveau paragraphe, chaque réponse s'affiche deux fois. La solution : respecter le drapeau replace — remplacer le contenu de l'élément précédent au lieu de l'ajouter.

2. agents.defaults.compaction.reserveTokensFloor supprimée

Cette clé de configuration a été retirée. Si elle reste dans openclaw.json, la configuration est signalée comme invalide : chaque commande CLI refuse de s'exécuter, et la passerelle ne redémarrera pas après son prochain redémarrage.

Commandes de récupération :

openclaw config validate
openclaw doctor --fix

validate nomme la clé fautive ; doctor --fix la supprime. L'auteur note qu'il l'a rajoutée à la main et a tout recassé — ne le faites pas.

3. Les modèles de session sont stricts sur les fallbacks

agents.defaults.model.fallbacks ne protège que le modèle par défaut configuré. Un modèle choisi par session via sessions.patch est strict : si ce fournisseur renvoie une 503, l'exécution échoue visiblement au lieu de passer par la chaîne de fallback. C'est un comportement documenté.

Changements mineurs

• models.list renvoie les entrées de agents.defaults.models, pas le catalogue complet.
• Les valeurs par défaut de chat.startup appellent désormais le champ fournisseur modelProvider.

L'auteur demande si quelqu'un a vu d'autres changements côté client dans les versions 9.7 ou 9.8.