Mudanças Frequentes de Quebra no OpenClaw: Procedimentos de Atualização e Problemas Atuais

Procedimentos de Atualização para as Lançamentos Frequentes da OpenClaw

A OpenClaw está lançando mudanças disruptivas a cada 2-3 semanas, com 13 lançamentos pontuais apenas em março de 2026. A fonte fornece procedimentos específicos para atualizar com segurança.

Antes de Atualizar

• Crie um backup: openclaw backup create --name "pre-update-$(date +%Y%m%d)"
• Se estiver usando Docker, fixe sua tag de imagem em vez de usar :latest: image: openclaw/openclaw:2026.3.28

Após Atualizar

• Execute: openclaw doctor --fix
• Teste manualmente seus canais, crons e habilidades antes de sair
• A flag --fix detecta a maioria das migrações de configuração, mas não todas

Se Algo Quebrar

• Reverta para seu backup
• Verifique a página de issues do GitHub para sua versão específica antes de tentar novamente

Problemas da Versão Atual (Abril 2026, Versão 3.28)

• Autenticação localhost alterada: conexões locais agora exigem tokens
• Instalações de habilidades falham fechadas em detecções de código perigoso
• Feishu tem uma regressão na validação de configuração (#56942)
• A substituição do modelo de heartbeat está quebrada (#58137): a detecção LiveSessionModelSwitch força seu heartbeat de volta ao modelo primário
• isolatedSession: true no heartbeat não isola realmente (#56941)

Recomendações de Versão

• Se você está no Feishu, mantenha-se na versão 3.23-2
• Se a economia de custos do heartbeat é importante para você, a 3.23-2 também pode ser mais segura até que a regressão da substituição do modelo seja corrigida

A fonte observa que esses tipos de regressões tornam a hospedagem gerenciada atraente no BetterClaw, pois são detectadas durante os testes antes que o lançamento atinja seu agente, embora a auto-hospedagem permaneça válida.