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
- Erro de Permissão — Problemas de acesso a arquivos
- Configuração Inválida — Config incompatível após update
- Gateway Não Inicia — Serviço não sobe após atualizar
Dica: Mantenha Backup
Antes de atualizar versões major, faça backup da configuração:
cp -r ~/.clawdbot ~/.clawdbot.backup