Atualização Quebrou a Configuração

Sintomas

Após atualizar o OpenClaw, o sistema não inicia ou se comporta de forma inesperada.

Se você está enfrentando esse problema, siga as soluções abaixo em ordem de probabilidade.

Diagnóstico Rápido

Antes de tentar as soluções, colete informações:

# Status geral do OpenClaw
openclaw status

# Logs recentes
openclaw logs --tail 50

# Versão atual
openclaw --version

Soluções🔴 Backup do config antes de atualizar

Prioridade: Alta

Sempre: cp config.yaml config.yaml.bak antes de openclaw update.

🔴 Migration automática

Prioridade: Alta

Execute: openclaw migrate. Converte config antigo para formato novo automaticamente.

🟡 Reverter atualização

Prioridade: Média

Se urgente: openclaw rollback volta para versão anterior.

🟡 Changelog de breaking changes

Prioridade: Média

Consulte: openclaw changelog ou docs.openclaw.ai/changelog para ver o que mudou.

Ainda Com Problemas?

Se nenhuma solução acima resolveu:

Colete logs detalhados: openclaw logs --level debug --tail 200 > debug.log
Verifique a versão: openclaw --version — considere atualizar para a última versão
Busque na comunidade: Discord do OpenClaw — outros usuários podem ter resolvido
Abra uma issue: GitHub Issues com logs e passos para reproduzir

📄 Mais em Troubleshooting