Migração OpenClaw — Entre Versões e Sistemas

Guias de migração para OpenClaw: atualização de versões, mudança de servidor, backup e restauração de dados.

Migração

Mude de sistema ou versão sem perder dados.


Guias de Migração

CenárioGuia
v0.x → v1.xMigração v0 para v1
PC → VPSMigrar para servidor
Mac → LinuxEntre sistemas

Backup Antes de Migrar

Sempre faça backup do seu workspace:

# Backup completo
tar -czvf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw ~/clawd

# Ou copie manualmente:
# - ~/.openclaw/config.yaml
# - ~/clawd/ (seu workspace)

🔄 Migração Básica

1. Backup no sistema antigo

tar -czvf backup.tar.gz ~/.openclaw ~/clawd

2. Transferir para novo sistema

scp backup.tar.gz user@novo-servidor:~

3. Restaurar no novo sistema

# Instalar OpenClaw
npm install -g openclaw

# Extrair backup
tar -xzvf backup.tar.gz

# Iniciar
openclaw gateway start

⚠ Cuidados

  • API keys precisam ser reconfiguradas se usava variáveis de ambiente
  • Canais podem precisar reconexão (especialmente WhatsApp)
  • Caminhos absolutos no config podem precisar ajuste

Problemas Comuns

ProblemaSolução
Config não encontradoVerificar caminhos no backup
Canal desconectadoReconectar: openclaw channel reconnect
Permissõeschmod -R 755 ~/.openclaw

Veja também Backup e Troubleshooting.