Falha ao Atualizar o OpenClaw

Falha ao Atualizar o OpenClaw

A atualização do OpenClaw falhou? Não se preocupe — veja como resolver os problemas mais comuns.

Diagnóstico Rápido

# Verificar versão atual
openclaw --version

# Ver qual erro ocorreu
npm update -g openclaw 2>&1 | tail -20

Soluções Por Tipo de Erro

Permissão Negada (EACCES)

# Se você instalou SEM sudo (recomendado)
npm update -g openclaw

# Se instalou COM sudo
sudo npm update -g openclaw

Melhor solução: Configure o npm para não precisar de sudo:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Cache Corrompido

# Limpar cache do npm
npm cache clean --force

# Tentar atualizar novamente
npm update -g openclaw

Conflito de Versão ou Dependências

# Reinstalar do zero (mais seguro)
npm uninstall -g openclaw
npm install -g openclaw@latest

Verificar Saúde Após Atualização

# Diagnóstico completo
openclaw doctor

# Reparar problemas automaticamente
openclaw doctor --repair

Rollback: Voltar Para Versão Anterior

Se a nova versão causou problemas:

# Ver versões disponíveis
npm view openclaw versions

# Instalar versão específica
npm install -g openclaw@1.2.3

Problemas Relacionados

Dica: Mantenha Backup

Antes de atualizar versões major, faça backup da configuração:

cp -r ~/.clawdbot ~/.clawdbot.backup