Migração de Servidor

Como migrar seu OpenClaw para um novo servidor. Backup, transferência e validação.

Migração de Servidor

Mude seu OpenClaw para um novo servidor sem perder nada.

Visão Geral
Backup → Preparar Novo → Transferir → Validar → Ativar
Passo a Passo1. Backup no Servidor Atual
# Parar o gateway
openclaw gateway stop

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

# Verificar backup
tar -tzvf clawd-backup-*.tar.gz | head

Arquivos importantes:

  • ~/clawd/ - Workspace completo
  • ~/.config/openclaw/ - Configuração
  • Chats do WhatsApp (se aplicável)
2. Preparar Novo Servidor
# Instalar Node.js
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# Instalar OpenClaw
npm install -g openclaw

# Verificar instalação
openclaw --version
3. Transferir Arquivos
# Do servidor antigo para o novo
scp clawd-backup-*.tar.gz usuario@novo-servidor:~/

# No novo servidor
cd ~
tar -xzvf clawd-backup-*.tar.gz

# Transferir config
scp -r ~/.config/openclaw usuario@novo-servidor:~/.config/
4. Configurar no Novo Servidor
# Verificar config.yaml
cat ~/clawd/config.yaml

# Ajustar paths se necessário
nano ~/clawd/config.yaml

# Configurar variáveis de ambiente
nano ~/.bashrc
# export ANTHROPIC_API_KEY="sua-key"
# export TELEGRAM_BOT_TOKEN="seu-token"
source ~/.bashrc
5. Reconectar Canais

WhatsApp

# Precisa escanear QR novamente
openclaw whatsapp login

Telegram

# Token funciona em qualquer servidor
# Apenas reinicie
openclaw gateway start

Discord

# Token funciona em qualquer servidor
# Apenas reinicie
6. Validar
# Testar gateway
openclaw gateway start

# Verificar logs
openclaw logs | tail -20

# Testar conexão
# Envie mensagem de teste pelo canal
7. Desativar Servidor Antigo
# No servidor antigo
openclaw gateway stop

# Opcional: backup final
tar -czvf clawd-final-backup-$(date +%Y%m%d).tar.gz ~/clawd/
Checklist de MigraçãoPré-migração
  • Backup completo do workspace
  • Backup da configuração
  • Anotar variáveis de ambiente
  • Anotar integrações ativas
Durante migração
  • Novo servidor preparado
  • OpenClaw instalado
  • Arquivos transferidos
  • Configuração ajustada
  • Variáveis de ambiente configuradas
Pós-migração
  • Gateway iniciando sem erros
  • Canais reconectados
  • Teste de mensagem enviada/recebida
  • Memória acessível
  • Integrações funcionando
Limpeza
  • Servidor antigo desativado
  • Backups guardados
  • DNS atualizado (se aplicável)
Problemas ComunsWhatsApp “Session Expired”
# Reconectar
openclaw whatsapp logout
openclaw whatsapp login
Permissões de Arquivo
# Corrigir permissões
chmod -R 755 ~/clawd/
chmod 600 ~/clawd/config.yaml  # Proteger config
Path Não Encontrado
# Verificar se cwd está correto
openclaw config get cwd
openclaw config set cwd /home/usuario/clawd
Variáveis de Ambiente
# Verificar
env | grep -E "ANTHROPIC|TELEGRAM|OPENAI"

# Se faltando, adicionar ao shell
echo 'export ANTHROPIC_API_KEY="sua-key"' >> ~/.bashrc
Migração Zero-Downtime

Para migração sem interrupção:

  1. Configure novo servidor completamente
  2. Teste tudo no novo
  3. Mude DNS (se usando domínio)
  4. Desligue antigo somente após confirmar
Próximos Passos