Lista de Verificação para Atualização do OpenClaw 3.22: Passos Práticos de um Desenvolvedor que Aprendeu na Dor

Antes de Atualizar para o OpenClaw 3.22

Verifique seu arquivo .env em busca de variáveis com prefixo CLAWDBOT_ ou MOLTBOT_. A versão 3.22 removeu todas essas variáveis sem fallback ou compatibilidade. Se você as tiver, seu agente não iniciará e a mensagem de erro não será útil. Renomeie tudo para OPENCLAW_ primeiro. Se você configurou o OpenClaw antes de meados de fevereiro, quase certamente tem pelo menos uma dessas variáveis.

Execute openclaw backup create antes de tocar em qualquer coisa. Considere marcar sua imagem Docker atual como :pre-upgrade para que você possa reverter instantaneamente se necessário.

Depois de Atualizar para o OpenClaw 3.22

Execute openclaw doctor --fix, que detecta a maioria das migrações de configuração automaticamente.

Verifique /tools em qualquer canal para ver quais ferramentas estão realmente disponíveis. A versão 3.22 alterou a superfície do SDK do plugin (mudou de openclaw/extension-api para openclaw/plugin-sdk/*), então plugins de terceiros que usam caminhos de importação antigos simplesmente não carregarão silenciosamente.

Execute openclaw secrets audit para encontrar chaves de API em texto simples em seu espaço de trabalho. O desenvolvedor encontrou duas que estavam completamente esquecidas, em arquivos de configuração de habilidades.

Novos Recursos na 3.22

• Conversas paralelas /btw
• Instalação nativa do ClawHub via CLI (openclaw skills install em vez de baixar manualmente arquivos skill.md)
• Limpeza de sessões mortas
• Backoff de repetição de cron para que um trabalho com falha não esgote seu orçamento de API durante a noite
• Tempo limite do agente de 48 horas em vez de 10 minutos, o que significa que tarefas longas realmente são concluídas agora

O desenvolvedor recomenda reservar 30-45 minutos para uma atualização cuidadosa em vez de assumir que será tranquila, observando que, depois de concluída, "é genuinamente melhor".