Saltar al contenido principal
OpenClaw admite tres rutas de migración: importar desde otro sistema de agentes, mover una instalación existente a una máquina nueva y actualizar un plugin en el lugar.

​
Importar desde otro sistema de agentes

Los proveedores de migración incluidos llevan instrucciones, servidores MCP, habilidades, configuración de modelos y claves de API (opcionales) a OpenClaw. Los planes se previsualizan antes de cualquier cambio, los secretos se redactan en los informes y la aplicación está respaldada por una copia de seguridad verificada.

Migrar desde Claude

Importa el estado de Claude Code y Claude Desktop, incluidos CLAUDE.md, servidores MCP, habilidades y comandos de proyecto.

Migrar desde Hermes

Importa la configuración de Hermes, proveedores, servidores MCP, memoria, habilidades y claves .env compatibles.
El punto de entrada de la CLI es openclaw migrate. La incorporación también puede ofrecer migración cuando detecta un origen conocido (openclaw onboard --flow import).

​
Mover OpenClaw a una máquina nueva

Copia el directorio de estado (~/.openclaw/ de forma predeterminada) y tu espacio de trabajo para conservar:
  • Configuración — openclaw.json y todos los ajustes del gateway.
  • Autenticación — auth-profiles.json por agente (claves de API más OAuth), además de cualquier estado de canal o proveedor bajo credentials/.
  • Sesiones — historial de conversaciones y estado del agente.
  • Estado de canales — inicio de sesión de WhatsApp, sesión de Telegram y similares.
  • Archivos del espacio de trabajo — MEMORY.md, USER.md, habilidades y prompts.
Ejecuta openclaw status en la máquina antigua para confirmar la ruta de tu directorio de estado. Los perfiles personalizados usan ~/.openclaw-<profile>/ o una ruta definida mediante OPENCLAW_STATE_DIR.

​
Pasos de migración

1

Detén el gateway y haz una copia de seguridad

En la máquina antigua, detén el gateway para que los archivos no cambien durante la copia y luego archiva:
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
Si usas varios perfiles (por ejemplo ~/.openclaw-work), archiva cada uno por separado.
2

Instala OpenClaw en la máquina nueva

Instala la CLI (y Node si es necesario) en la máquina nueva. No pasa nada si la incorporación crea un ~/.openclaw/ nuevo; lo sobrescribirás a continuación.
3

Copia el directorio de estado y el espacio de trabajo

Transfiere el archivo mediante scp, rsync -a o una unidad externa y luego extráelo:
cd ~
tar -xzf openclaw-state.tgz
Confirma que se incluyeron los directorios ocultos y que la propiedad de los archivos coincide con el usuario que ejecutará el gateway.
4

Ejecuta doctor y verifica

En la máquina nueva, ejecuta Doctor para aplicar migraciones de configuración y reparar servicios:
openclaw doctor
openclaw gateway restart
openclaw status
Si Telegram o Discord usa el fallback de entorno predeterminado (TELEGRAM_BOT_TOKEN o DISCORD_BOT_TOKEN), verifica que el .env del directorio de estado migrado contenga esas claves sin imprimir los valores secretos: 
awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env
openclaw doctor también advierte cuando una cuenta predeterminada de Telegram o Discord habilitada no tiene ningún token configurado y la variable de entorno correspondiente no está disponible para el proceso de doctor.

​
Errores comunes

Si el gateway antiguo usaba --profile o OPENCLAW_STATE_DIR y el nuevo no, los canales aparecerán con sesión cerrada y las sesiones estarán vacías. Inicia el gateway con el mismo perfil o directorio de estado que migraste y luego vuelve a ejecutar openclaw doctor.
El archivo de configuración por sí solo no basta. Los perfiles de autenticación de modelos viven bajo agents/<agentId>/agent/auth-profiles.json, y el estado de canales y proveedores vive bajo credentials/. Migra siempre el directorio de estado completo.
Si copiaste como root o cambiaste de usuario, puede que el gateway no pueda leer las credenciales. Asegúrate de que el directorio de estado y el espacio de trabajo pertenezcan al usuario que ejecuta el gateway.
Si tu IU apunta a un gateway remoto, el host remoto posee las sesiones y el espacio de trabajo. Migra el propio host del gateway, no tu portátil local. Consulta las Preguntas frecuentes.
El directorio de estado contiene perfiles de autenticación, credenciales de canales y otro estado de proveedores. Guarda las copias de seguridad cifradas, evita canales de transferencia inseguros y rota las claves si sospechas exposición.

​
Lista de verificación

En la máquina nueva, confirma:
  • openclaw status muestra que el gateway está en ejecución.
  • Los canales siguen conectados (no hace falta volver a emparejarlos).
  • El panel se abre y muestra las sesiones existentes.
  • Los archivos del espacio de trabajo (memoria, configuraciones) están presentes.

​
Actualizar un plugin en el lugar

Las actualizaciones de plugins en el lugar conservan el mismo id de plugin y las claves de configuración, pero pueden mover el estado en disco al diseño actual. Las guías de actualización específicas de cada plugin viven junto a sus canales:
  • Migración de Matrix: límites de recuperación de estado cifrado, comportamiento de instantáneas automáticas y comandos de recuperación manual.

​
Relacionado