Cómo migrar OpenClaw a una nueva máquina

Configurar tu entorno de desarrollo desde cero es una pérdida de tiempo. Pasar horas reingresando API keys, vinculando cuentas de nuevo y tratando de recordar cómo tenías configurado cada agente corta tu ritmo de trabajo.

Lo que quieres es mover tus herramientas y que simplemente funcionen. Nadie quiere perder el historial de sesiones o tener que repetir procesos de autenticación tediosos solo por cambiar de hardware. Esta guía te muestra cómo hacerlo de forma directa.

Requisitos previos

Para que la migración funcione, necesitas acceso a estos elementos de tu máquina antigua:

1. El State directory ($OPENCLAW_STATE_DIR, por defecto ~/.openclaw/).
2. Tu Workspace (por defecto ~/.openclaw/workspace/).
3. Node.js instalado en la nueva máquina.
4. La CLI de OpenClaw instalada en el nuevo equipo.

Inicio rápido

Sigue estos pasos para mover tu Gateway en menos de 5 minutos:

1. Detén y prepara los archivos (Máquina vieja)

Primero, detén el Gateway para evitar que los archivos cambien mientras los copias:

openclaw gateway stop

Ahora, crea archivos comprimidos de tu configuración y tu workspace:

# Ajusta las rutas si usas un perfil o ubicaciones personalizadas
cd ~
tar -czf openclaw-state.tgz .openclaw
tar -czf openclaw-workspace.tgz .openclaw/workspace

2. Instala OpenClaw (Máquina nueva)

Instala la CLI en tu nueva máquina. No te preocupes si el proceso de onboarding crea una carpeta ~/.openclaw/ vacía; la vas a sobrescribir ahora.

3. Copia y restaura

Mueve los archivos .tgz a la nueva máquina y extráelos en el mismo directorio (normalmente el home ~). Asegúrate de que se incluyan los directorios ocultos y que los permisos de los archivos pertenezcan a tu usuario actual.

4. Repara y arranca

Ejecuta el comando de diagnóstico para aplicar migraciones de configuración y reparar servicios:

openclaw doctor

Finalmente, inicia el Gateway y verifica el estado:

openclaw gateway restart
openclaw status

Solución de problemas

El perfil o state-dir no coincide

Si usabas un perfil específico (con --profile) en la máquina vieja y no lo indicas en la nueva, verás que faltan canales o que el historial está vacío. Ejecuta el Gateway usando el mismo perfil que migraste y vuelve a correr openclaw doctor.

Solo copiaste el archivo openclaw.json

Muchos proveedores guardan credenciales y estados de agentes en subcarpetas como credentials/ o agents/. Si solo mueves el archivo JSON, la migración fallará. Debes copiar siempre la carpeta $OPENCLAW_STATE_DIR completa.

Problemas de permisos

Si copiaste los archivos usando el usuario root, es posible que el Gateway no pueda leer tus sesiones. Asegúrate de que tu usuario tenga los permisos correctos sobre la carpeta del estado y el workspace.

Migración entre modos local y remoto

Si tu UI apunta a un Gateway remoto, los datos viven en ese servidor, no en tu laptop. Migrar los archivos de tu computadora local no moverá el estado del Gateway remoto. En este caso, debes realizar la migración en el host donde reside el Gateway.

Seguridad y secretos

El directorio $OPENCLAW_STATE_DIR contiene API keys y tokens de sesión de WhatsApp. Trata tus backups como datos sensibles: cífra los archivos y evita compartirlos por canales inseguros.

Verification checklist

Confirma que todo esté en orden en la nueva máquina:

• openclaw status muestra que el Gateway está corriendo.
• Los canales siguen conectados (ej. WhatsApp no pide vincularse de nuevo).
• El dashboard muestra tus sesiones previas.
• Tus archivos del workspace (memoria, configuraciones) están presentes.

¿Necesitas ayuda personalizada con tu configuración? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Instalación de OpenClaw
• Uso de OpenClaw Doctor
• Solución de problemas del Gateway
• ¿Dónde guarda OpenClaw sus datos?