A atualização do OpenClaw v2.0 requer verificações manuais antes da instalação.

O OpenClaw lançou uma grande atualização com alterações disruptivas significativas que exigem intervenção manual antes da instalação. A atualização inclui 12 alterações disruptivas, um sistema de plugins completamente novo e mais de 30 correções de segurança.

Verificações obrigatórias antes da atualização

Antes de atualizar, os usuários devem realizar estas verificações para evitar problemas de configuração:

Passo 1: Verificar variáveis de ambiente

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

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

Se alguma variável aparecer, renomeie-as:

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

Verifique .env, .bashrc, .zshrc, .profile e arquivos docker-compose. Variáveis ausentes farão o OpenClaw iniciar com configurações padrão em vez das configurações do usuário.

Passo 2: Verificar diretório de estado

Se os dados do OpenClaw estiverem armazenados em ~/.moltbot, não serão detectados após a atualização. Verifique seu diretório atual:

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

Se ainda estiver usando ~/.moltbot, mova-o:

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, fazendo parecer que todos os dados foram perdidos.

Passo 3: Fazer backup da sua configuração

Crie um backup antes de atualizar:

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

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

Passo 4: Verificar configuração de automação do navegador

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

openclaw config get | grep -i browser

Se você vir referências a extension, relay ou relayBindHost, precisa reconfigurar para o novo sistema de controle do navegador. O OpenClaw agora gerencia seu próprio perfil do navegador (o perfil openclaw) ou se conecta a uma sessão existente do Chrome via CDP.

Passo 5: Entender 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 as habilidades existentes estejam sincronizadas com o novo sistema.