OpenClaw 2026.9.1 Migração: Notas de Atualização de Agentes Múltiplos Legados do r/openclaw

Atualizar o OpenClaw entre versões principais pode parecer assustador, mas um post recente no r/openclaw mostra uma configuração multiagente legada migrando de 2026.7.1-2 para 2026.9.1 sem grandes problemas — especialmente quando você deixa um agente de codificação de IA cuidar das etapas.

A Configuração Legada

A migração começou a partir desta configuração:

• Instalação global do OpenClaw via npm
• Versão 2026.7.1-2
• Serviço systemd de gateway do usuário
• Múltiplos agentes configurados com workspaces específicos
• Canal do WhatsApp com roteamento específico por grupo
• Perfis de navegador e vários plugins gerenciados

Problemas Encontrados

Somente após a atualização você realmente vê o que mudou. Os problemas identificados incluíram:

• Várias chaves de configuração legadas rejeitadas pelo 2026.9.1
• A propriedade multiagente precisava de declaração explícita
• O banco de dados de estado SQLite compartilhado exigia migrações de esquema
• O estado de configuração do workspace legado precisava de migração
• Vários plugins oficiais ainda estavam na versão antiga
• O WhatsApp não tinha um agente de fallback para mensagens não correspondidas
• O proxy reverso da interface web precisava de atribuição de cliente encaminhado confiável
• A definição do serviço tinha metadados desatualizados ou não padronizados

O Que Corrigiu

A atualização foi delegada ao Codex (via extensão do VS Code, conectada remotamente à máquina do OpenClaw). O processo completo levou cerca de 30 minutos. Etapas principais do resumo gerado:

• Criou um backup de rollback datado da configuração, segredos, arquivos de serviço, metadados do pacote e status de execução.
• Atualizou o OpenClaw para 2026.9.1 usando o atualizador integrado.
• Migrou a configuração removendo chaves aposentadas e convertendo configurações de tempo limite suportadas.
• Definiu a propriedade multiagente como explícita.
• Executou o Doctor com a política de reparo de serviço externo para permitir que as migrações de estado do SQLite, workspace, dispositivo e plugin fossem concluídas.
• Atualizou a definição do serviço systemd do gateway.
• Atualizou os plugins oficiais para 2026.9.1.
• Definiu main como o proprietário padrão do heartbeat e o agente de roteamento para mensagens não correspondidas do WhatsApp.
• Adicionou uma entrada de proxy confiável com escopo restrito para o proxy reverso local.

Resultado e Lição

Após a migração, o gateway executa o 2026.9.1, a configuração é validada, o serviço está ativo, o listener HTTP/RPC local responde, o WhatsApp relata que está ouvindo mensagens recebidas e o processamento de heartbeat começa normalmente.

A principal lição: para um salto grande de versão, faça backup primeiro, espere migrações de esquema e estado e verifique tanto a propriedade do gateway quanto o roteamento multiagente.