Falha ao Atualizar o OpenClaw
Resolva erros de atualização do OpenClaw: permissão negada, cache corrompido, conflitos de versão. Inclui rollback para versão anterior.
⏱️ 2 min de leitura
Falha ao Atualizar o OpenClaw
A atualização do OpenClaw falhou? Não se preocupe — veja como resolver os problemas mais comuns.
# Verificar versão atual
openclaw --version
# Ver qual erro ocorreu
npm update -g openclaw 2>&1 | tail -20
# 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
# Limpar cache do npm
npm cache clean --force
# Tentar atualizar novamente
npm update -g openclaw
# Reinstalar do zero (mais seguro)
npm uninstall -g openclaw
npm install -g openclaw@latest
# Diagnóstico completo
openclaw doctor
# Reparar problemas automaticamente
openclaw doctor --repair
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
- 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
Antes de atualizar versões major, faça backup da configuração:
cp -r ~/.openclaw ~/.openclaw.backup