Notas de migração do OpenClaw 2026.9.6: chunks replace:true, chaves de configuração descontinuadas e modelos de sessão estritos

Um desenvolvedor que mantém um cliente WebSocket personalizado contra o gateway OpenClaw documentou três mudanças disruptivas entre as versões 2026.9.1 e 2026.9.6. Cada uma custou tempo, então aqui está a extração.

1. replace:true no chunk final do assistente

Os modelos OpenAI agora rodam através do plugin codex. Depois de transmitir a resposta sob o item msg_…, o gateway envia mais um chunk stream=assistant sob um novo itemId com replace:true e o texto completo idêntico.

Se seu cliente trata cada novo itemId como um novo parágrafo, toda resposta é renderizada duas vezes. A correção: respeite a flag replace — substitua o conteúdo do item anterior em vez de anexar.

2. agents.defaults.compaction.reserveTokensFloor foi aposentada

Essa chave de configuração foi removida. Se ela permanecer em openclaw.json, a configuração é reportada como inválida: todo comando da CLI se recusa a rodar, e o gateway não volta após o próximo reinício.

Comandos de recuperação:

openclaw config validate
openclaw doctor --fix

validate nomeia a chave ofensora; doctor --fix a remove. O autor observa que re-adicionou-a à mão e quebrou as coisas de novo — não faça isso.

3. Modelos de sessão são estritos quanto a fallbacks

agents.defaults.model.fallbacks só protege o modelo padrão configurado. Um modelo escolhido por sessão via sessions.patch é estrito: se aquele provedor retornar um 503, a execução falha visivelmente em vez de cair na cadeia de fallback. Esse é o comportamento documentado.

Mudanças menores

• models.list retorna entradas em agents.defaults.models, não o catálogo completo.
• Os padrões de chat.startup agora chamam o campo do provedor de modelProvider.

O autor está perguntando se alguém viu outras mudanças voltadas ao cliente nas versões 9.7 ou 9.8.