Atualização do OpenClaw v2.0: Lista de Verificação Crítica Pré-Atualização para Evitar Mudanças Disruptivas

Atualização Principal do OpenClaw Requer Preparação Prévia

O OpenClaw lançou sua maior atualização em meses com 12 mudanças que quebram compatibilidade, um sistema de plugins completamente novo e mais de 30 correções de segurança. A atualização quebrará silenciosamente as configurações se os usuários executarem npm update sem preparação prévia.

Passo 1: Verifique as Variáveis de Ambiente

As variáveis de ambiente legadas de quando o OpenClaw era chamado de Clawdbot ou Moltbot não funcionarão mais. Não há camada de compatibilidade, fallback ou aviso. Verifique variáveis antigas:

env | grep -i clawdbot
env | grep -i moltbot

Se algo aparecer, renomeie-os:

• CLAWDBOT_* → OPENCLAW_*
• MOLTBOT_* → OPENCLAW_*

Verifique seus arquivos .env, .bashrc, .zshrc, .profile e quaisquer arquivos docker-compose. Variáveis ausentes farão o OpenClaw iniciar com configurações padrão em vez de sua configuração personalizada.

Passo 2: Verifique o Diretório de Estado

A detecção automática para o nome do diretório antigo foi removida. Verifique seu diretório de estado atual:

ls ~/.moltbot 2>/dev/null && echo "VOCÊ PRECISA MOVER ISSO"
ls ~/.openclaw 2>/dev/null && echo "você está bem"

Se você ainda estiver usando ~/.moltbot, mova-o antes de atualizar:

mv ~/.moltbot ~/.openclaw

Ou defina o caminho explicitamente:

export OPENCLAW_STATE_DIR=~/.openclaw

Se você atualizar primeiro, o OpenClaw criará um novo diretório ~/.openclaw com configuração vazia.

Passo 3: Faça Backup da Sua Configuração

Crie um backup antes de atualizar:

cp -r ~/.openclaw ~/.openclaw-backup-$(date +%Y%m%d)

Isso inclui seu SOUL.md, USER.md, MEMORY.md, configuração de agentes, habilidades e tudo mais.

Passo 4: Verifique a Configuração de Automação do Navegador

O relay da extensão do Chrome legado foi completamente removido. Se sua configuração do navegador usar driver: "extension" ou browser.relayBindHost, essas configurações não farão nada agora. Verifique sua configuração:

openclaw config get | grep -i browser

A nova abordagem usa anexação de sessão de navegador existente. O OpenClaw se conecta a um navegador que já está em execução em vez de controlar um através de uma extensão. O OpenClaw agora gerencia seu próprio perfil de navegador (o perfil openclaw) ou se conecta a uma sessão do Chrome existente via CDP.

Passo 5: Entenda a Mudança do Clawhub

O Clawhub agora é a loja padrão de plugins e habilidades. Quando você executa openclaw plugins install ou openclaw skills install, ele verifica o Clawhub primeiro e só recorre ao npm se não encontrar o pacote lá. Isso significa:

• Algumas habilidades instaladas via npm podem precisar ser reinstaladas via Clawhub
• openclaw skills search, openclaw skills install e openclaw skills update são novos comandos que usam o ClawHub nativamente
• Se uma habilidade não estiver no Clawhub, você ainda pode instalar do npm (é um fallback, não uma remoção)

Após atualizar, execute:

openclaw skills update

Para garantir que suas habilidades existentes estejam sincronizadas com o novo sistema.