---
title: "Falha ao Atualizar o OpenClaw"
url: "https://openclaw.ia.br/troubleshooting/atualizacao-falhou/"
markdown_url: "https://openclaw.ia.br/troubleshooting/atualizacao-falhou.MD"
description: "Resolva erros de atualização do OpenClaw: permissão negada, cache corrompido, conflitos de versão. Inclui rollback para versão anterior."
date: ""
author: ""
---

# 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.


# 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

```bash
# 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)

```bash
# 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:

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

### Cache Corrompido

```bash
# Limpar cache do npm
npm cache clean --force

# Tentar atualizar novamente
npm update -g openclaw
```

### Conflito de Versão ou Dependências

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

### Verificar Saúde Após Atualização

```bash
# Diagnóstico completo
openclaw doctor

# Reparar problemas automaticamente
openclaw doctor --repair
```

## Rollback: Voltar Para Versão Anterior

Se a nova versão causou problemas:

```bash
# 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](/troubleshooting/erro-permissao/) — Problemas de acesso a arquivos
- [Configuração Inválida](/troubleshooting/configuracao-invalida/) — Config incompatível após update
- [Gateway Não Inicia](/troubleshooting/gateway-nao-inicia/) — Serviço não sobe após atualizar

## Dica: Mantenha Backup

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

```bash
cp -r ~/.openclaw ~/.openclaw.backup
```