tutorial migration

De OpenClaw a ZeroClaw: guía de migración para usuarios frustrados

ZeroClaws.io

ZeroClaws.io

@zeroclaws

February 25, 2026

6 min de lectura

De OpenClaw a ZeroClaw: guía de migración para usuarios frustrados

La decisión de migrar suele llegar después de uno de tres momentos. Leiste sobre CVE-2026-25253 y te diste cuenta de que tu instancia de OpenClaw ha estado expuesta en internet. Revisaste el uso de memoria de tu servidor y encontraste OpenClaw en reposo a 1,2 GB en una máquina con 2 GB de RAM. O viste el artículo de XDA Developers y decidiste que preferías no esperar a ver cómo es la próxima vulnerabilidad.

Sea lo que sea que te trajo aquí, la migración es sencilla. ZeroClaw incluye una herramienta de migración integrada que hace el trabajo pesado. Esto es lo que puedes esperar.

Qué se transfiere

La herramienta de migración importa tu historial de conversaciones a la base de datos de memoria SQLite de ZeroClaw. Tus conexiones de canales —tokens de Telegram, Discord, WhatsApp— se transfieren al formato config.toml. Tu configuración de proveedor de IA y claves API se transfieren directamente. Los prompts del sistema y la configuración de persona se traducen limpiamente.

Qué cambia realmente

El mayor cambio es el sistema de skills. Las skills JavaScript de OpenClaw no corren en ZeroClaw. La mayoría de las skills integradas comunes tienen equivalentes en ZeroClaw —puedes verificarlo con `zeroclaw tools list`. Para skills personalizadas que hayas escrito tú mismo, necesitarás encontrar un equivalente integrado o implementar un trait de Rust.

El segundo cambio es la interfaz. ZeroClaw no incluye una interfaz web. Interactúas a través de canales de chat o la CLI.

Antes de empezar

Tómate cinco minutos para prepararte antes de ejecutar nada:

```bash openclaw --version openclaw export --format json > openclaw-backup.json cp ~/.openclaw/.env ~/openclaw-env-backup ```

Paso 1: Instalar 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 ```

Paso 2: Ejecutar la herramienta de migración

Siempre haz primero un dry-run. Muestra exactamente qué se importará, qué se omitirá y qué necesita atención manual, sin hacer ningún cambio:

```bash zeroclaw migrate openclaw --dry-run ```

Lee el resultado con cuidado. Cuando estés satisfecho:

```bash zeroclaw migrate openclaw ```

Paso 3: Verificar la configuración

Abre `~/.config/zeroclaw/config.toml` y verifica que la migración lo obtuvo todo correctamente:

```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] ```

Paso 4: Probar antes de cambiar

```bash zeroclaw start ```

Envía un mensaje de prueba a través de cada canal. No detengas OpenClaw todavía —ejecuta ambos en paralelo hasta que estés seguro de que todo funciona.

Problemas comunes

El bridge de WhatsApp no se conecta. ZeroClaw usa una biblioteca de bridge de WhatsApp diferente. Vuelve a escanear el código QR: `zeroclaw channel whatsapp pair`.

La skill personalizada no funciona. Verifica si existe un equivalente integrado con `zeroclaw tools list`.

La memoria parece incompleta. La migración importa los últimos 10.000 mensajes por defecto. Para el historial completo: `zeroclaw migrate openclaw --full-history`.

El antes y el después

| Métrica | OpenClaw | ZeroClaw | |--------|----------|----------| | Uso de RAM | ~1,2 GB | ~4 MB | | Tiempo de arranque | ~8 segundos | <10 ms | | Uso de disco | ~800 MB | ~12 MB | | Dependencias | 1.200+ paquetes npm | 0 | | CVEs abiertos | 2+ críticos | 0 |

Para terminar

Una vez que hayas confirmado que ZeroClaw funciona correctamente, detiene OpenClaw y recupera los recursos:

```bash sudo systemctl stop openclaw npm uninstall -g openclaw ```

La migración tarda unos 20 minutos. La RAM que recuperas es inmediata. La exposición al CVE termina en el momento en que OpenClaw deja de correr.

Mantente al Día

Recibe actualizaciones sobre nuevos lanzamientos, integraciones e infraestructura de agentes en Rust. Sin spam, cancela cuando quieras.