---
title: "Migração de Servidor"
url: "https://openclaw.ia.br/migracao/servidor/"
markdown_url: "https://openclaw.ia.br/migracao/servidor.MD"
description: "Como migrar seu OpenClaw para um novo servidor. Backup, transferência e validação."
date: ""
author: ""
---

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

### 1. Backup no Servidor Atual

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

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

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

```bash
# 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
```bash
# Precisa escanear QR novamente
openclaw whatsapp login
```

#### Telegram
```bash
# Token funciona em qualquer servidor
# Apenas reinicie
openclaw gateway start
```

#### Discord
```bash
# Token funciona em qualquer servidor
# Apenas reinicie
```

### 6. Validar

```bash
# Testar gateway
openclaw gateway start

# Verificar logs
openclaw logs | tail -20

# Testar conexão
# Envie mensagem de teste pelo canal
```

### 7. Desativar Servidor Antigo

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

```bash
# Reconectar
openclaw whatsapp logout
openclaw whatsapp login
```

### Permissões de Arquivo

```bash
# Corrigir permissões
chmod -R 755 ~/clawd/
chmod 600 ~/clawd/config.yaml  # Proteger config
```

### Path Não Encontrado

```bash
# Verificar se cwd está correto
openclaw config get cwd
openclaw config set cwd /home/usuario/clawd
```

### Variáveis de Ambiente

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

- [Instalação](/instalacao/)
- [Backup e restauração](/guias/backup/)
- [Troubleshooting](/troubleshooting/)