Migração da Frota OpenClaw 2.0: O Que Realmente Quebrou

Atualizar uma única instância do OpenClaw é uma coisa, mas fazer isso para uma frota de clientes em produção significa que cada quebra se multiplica. Uma equipe passou um dia inteiro migrando para o OpenClaw 2.0 e compartilhou as arestas mais afiadas. Aqui está o que realmente quebrou e como evitar.

Esquema de Configuração Ficou Mais Rigoroso

Na versão 2.0, o esquema de configuração é mais rigoroso e vários campos foram movidos (chaves de ambiente, TTS, modelos de mídia). A maior armadilha: o doctor --fix exclui silenciosamente campos desconhecidos. Se a sua chave de modelo estiver em uma área que agora está obsoleta, ela pode desaparecer junto com esses campos. A equipe reescreveu as configurações manualmente antes de executar o doctor para evitar perder chaves.

Plugins Externos Quebram o Gateway

WhatsApp, Brave, Discord e Perplexity não estão mais na imagem principal; são plugins externos. Se a sua configuração ainda os referencia, o gateway nunca fica pronto, o contêiner entra em um loop de reinicialização e, de fora, parece um erro 502. Simplesmente adicionar os plugins à imagem não é suficiente porque o consentimento de capacidade está vinculado à máquina específica, e o doctor não o aceita. A única abordagem que funciona é executar openclaw plugins install ... --accept-capabilities como uma etapa separada.

Pareamento de Dispositivos: Cabeçalhos Cloudflare Quebram a Localidade

O webchat começou a lançar PAIRING_REQUIRED. A causa raiz: na versão 2.0, apenas solicitações de loopback sem cabeçalhos encaminhados são confiáveis. Não configurá-los no nginx não é suficiente — o Cloudflare envia seus próprios cabeçalhos, então você precisa anulá-los explicitamente no nginx. Isso parecia um token quebrado, mas na verdade era um conflito entre Cloudflare, nginx e a lógica de localidade do OpenClaw.

Perplexity Carrega Automaticamente Indesejado

O Perplexity será carregado automaticamente se detectar uma chave OpenRouter e exigirá consentimento mesmo se você não quiser o plugin. Definir enabled: false não ajuda; você deve usar plugins.deny para bloqueá-lo.

Conclusão: Priorize o Tempo de Atividade em Vez de Recursos

O princípio final: é melhor perder temporariamente a busca na web ou um único canal do que derrubar todo o agente com um erro 502. Planeje múltiplas quebras e teste cada componente individualmente.

Isto é baseado em um relatório de migração real de uma plataforma de nuvem que hospeda OpenClaw para clientes. Se você está planejando uma atualização, leia a fonte para mais detalhes e insights da comunidade.