Migração de Servidor
Como migrar seu OpenClaw para um novo servidor. Backup, transferência e validação.
⏱️ 2 min de leitura
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 Passo
1. 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
# 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ção
Pré-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 Comuns
WhatsApp “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:
- Configure novo servidor completamente
- Teste tudo no novo
- Mude DNS (se usando domínio)
- Desligue antigo somente após confirmar