Notas de migración de OpenClaw 2026.9.6: fragmentos con replace:true, claves de configuración retiradas y modelos de sesión estrictos

Un desarrollador que mantiene un cliente WebSocket personalizado contra la pasarela de OpenClaw documentó tres cambios disruptivos entre las versiones 2026.9.1 y 2026.9.6. Cada uno costó tiempo, así que aquí está la extracción.

1. replace:true en el fragmento final del asistente

Los modelos de OpenAI ahora se ejecutan a través del plugin codex. Después de transmitir la respuesta bajo el elemento msg_…, la pasarela envía un fragmento más de stream=assistant bajo un nuevo itemId con replace:true y el texto completo idéntico.

Si tu cliente trata cada nuevo itemId como un párrafo nuevo, cada respuesta se renderiza dos veces. La solución: respeta la marca replace — reemplaza el contenido del elemento anterior en lugar de añadirlo.

2. agents.defaults.compaction.reserveTokensFloor retirado

Esta clave de configuración fue eliminada. Si permanece en openclaw.json, la configuración se reporta como inválida: todos los comandos de la CLI se niegan a ejecutarse y la pasarela no volverá después de su próximo reinicio.

Comandos de recuperación:

openclaw config validate
openclaw doctor --fix

validate nombra la clave infractora; doctor --fix la elimina. El autor señala que la volvió a añadir a mano y rompió las cosas de nuevo — no lo hagas.

3. Los modelos de sesión son estrictos con los respaldos

agents.defaults.model.fallbacks solo protege el modelo predeterminado configurado. Un modelo elegido por sesión a través de sessions.patch es estricto: si ese proveedor devuelve un 503, la ejecución falla visiblemente en lugar de pasar por la cadena de respaldo. Este es el comportamiento documentado.

Cambios menores

• models.list devuelve entradas en agents.defaults.models, no el catálogo completo.
• chat.startup ahora llama al campo del proveedor modelProvider de forma predeterminada.

El autor pregunta si alguien ha visto otros cambios orientados al cliente en 9.7 o 9.8.