A decisão de migrar geralmente vem depois de um desses três momentos. Você leu sobre o CVE-2026-25253 e percebeu que sua instância do OpenClaw ficou exposta na internet. Verificou o uso de memória do servidor e encontrou o OpenClaw ocioso a 1,2 GB numa máquina com 2 GB de RAM. Ou viu o artigo do XDA Developers e decidiu que preferia não esperar para ver como será a próxima vulnerabilidade.
Seja lá o que te trouxe aqui, a migração é tranquila. O ZeroClaw inclui uma ferramenta de migração integrada que faz o trabalho pesado. Veja o que esperar.
O que é transferido
A ferramenta de migração importa seu histórico de conversas para o banco de dados de memória SQLite do ZeroClaw. Suas conexões de canais —tokens do Telegram, Discord, WhatsApp— são transferidas para o formato config.toml. Suas configurações de provedor de IA e chaves de API são transferidas diretamente.
O que muda de verdade
A maior mudança é o sistema de skills. As skills JavaScript do OpenClaw não rodam no ZeroClaw. A maioria das skills integradas comuns tem equivalentes no ZeroClaw —você pode verificar com `zeroclaw tools list`.
A segunda mudança é a interface. O ZeroClaw não vem com interface web. Você interage através de canais de chat ou da CLI.
Antes de começar
Reserve cinco minutos para se preparar antes de rodar qualquer coisa:
```bash openclaw --version openclaw export --format json > openclaw-backup.json cp ~/.openclaw/.env ~/openclaw-env-backup ```
Passo 1: Instalar o ZeroClaw
```bash # macOS brew install zeroclaw
# Linux curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/main/scripts/bootstrap.sh | bash
# Windows curl -fsSLO https://github.com/zeroclaw-labs/zeroclaw/releases/latest/download/zeroclaw-x86_64-pc-windows-msvc.zip ```
Passo 2: Rodar a ferramenta de migração
Sempre faça um dry-run primeiro. Mostra exatamente o que será importado, o que será ignorado e o que precisa de atenção manual, sem fazer nenhuma alteração:
```bash zeroclaw migrate openclaw --dry-run ```
Leia o resultado com cuidado. Quando estiver satisfeito:
```bash zeroclaw migrate openclaw ```
Passo 3: Verificar a configuração
Abra `~/.config/zeroclaw/config.toml` e verifique que a migração pegou tudo corretamente:
```toml [ai] provider = "anthropic" model = "claude-sonnet-4-20250514" api_key = "sk-ant-..."
[channels.telegram] token = "123456:ABC..." allowed_users = [your_user_id]
[channels.discord] token = "MTk..." guild_ids = [your_server_id] ```
Passo 4: Testar antes de trocar
```bash zeroclaw start ```
Mande uma mensagem de teste por cada canal. Não pare o OpenClaw ainda —rode os dois em paralelo até ter certeza que tudo funciona.
Problemas comuns
A bridge do WhatsApp não conecta. O ZeroClaw usa uma biblioteca de bridge do WhatsApp diferente. Reescaneie o QR code: `zeroclaw channel whatsapp pair`.
A skill personalizada não funciona. Verifique se existe um equivalente integrado com `zeroclaw tools list`.
A memória parece incompleta. A migração importa as últimas 10.000 mensagens por padrão. Para o histórico completo: `zeroclaw migrate openclaw --full-history`.
O antes e o depois
| Métrica | OpenClaw | ZeroClaw | |--------|----------|----------| | Uso de RAM | ~1,2 GB | ~4 MB | | Tempo de inicialização | ~8 segundos | <10 ms | | Uso de disco | ~800 MB | ~12 MB | | Dependências | 1.200+ pacotes npm | 0 | | CVEs abertos | 2+ críticos | 0 |
Finalizando
Depois de confirmar que o ZeroClaw está funcionando corretamente, pare o OpenClaw e recupere os recursos:
```bash sudo systemctl stop openclaw npm uninstall -g openclaw ```
A migração leva cerca de 20 minutos. A RAM que você recupera é imediata. A exposição ao CVE termina no momento em que o OpenClaw para de rodar.