Saltar al contenido principal

​
Migrar OpenClaw a una nueva máquina

Esta guía mueve un gateway de OpenClaw a una nueva máquina sin volver a hacer el onboarding.

​
Qué se migra

Cuando copias el directorio de estado (~/.openclaw/ de forma predeterminada) y tu espacio de trabajo, conservas:
  • Configuración — openclaw.json y toda la configuración del gateway
  • Autenticación — auth-profiles.json por agente (claves API + OAuth), además de cualquier estado de canal/proveedor en credentials/
  • Sesiones — historial de conversaciones y estado del agente
  • Estado del canal — inicio de sesión de WhatsApp, sesión de Telegram, etc.
  • Archivos del espacio de trabajo — MEMORY.md, USER.md, Skills 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 establecida mediante OPENCLAW_STATE_DIR.

​
Pasos de migración

1

Detener el gateway y hacer 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

Instalar OpenClaw en la nueva máquina

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

Copiar 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
Asegúrate de que se incluyeron los directorios ocultos y de que la propiedad de los archivos coincida con la persona usuaria que ejecutará el gateway.
4

Ejecutar doctor y verificar

En la nueva máquina, ejecuta Doctor para aplicar migraciones de configuración y reparar servicios:
openclaw doctor
openclaw gateway restart
openclaw status

​
Problemas comunes

Si el gateway antiguo usaba --profile o OPENCLAW_STATE_DIR y el nuevo no, los canales aparecerán como desconectados 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 es suficiente. Los perfiles de autenticación del modelo viven en agents/<agentId>/agent/auth-profiles.json, y el estado del canal/proveedor sigue viviendo en credentials/. Migra siempre el directorio de estado completo.
Si copiaste como root o cambiaste de usuario, el gateway puede fallar al leer las credenciales. Asegúrate de que el directorio de estado y el espacio de trabajo pertenezcan a la persona usuaria que ejecuta el gateway.
Si tu IU apunta a un gateway remoto, el host remoto es propietario de las sesiones y del espacio de trabajo. Migra el propio host del gateway, no tu laptop local. Consulta FAQ.
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 nueva máquina, confirma:
  • openclaw status muestra el gateway en ejecución
  • Los canales siguen conectados (no hace falta volver a emparejar)
  • El panel se abre y muestra las sesiones existentes
  • Los archivos del espacio de trabajo (memoria, configuraciones) están presentes