Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw admite tres rutas de migración: importar desde otro sistema de agente, mover una instalación existente a una máquina nueva y actualizar un Plugin en el lugar.

​
Importar desde otro sistema de agente

Usa los proveedores de migración incluidos para llevar instrucciones, servidores MCP, Skills, configuración de modelo 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.

Migración desde Claude

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

Migración desde Hermes

Importa la configuración, proveedores, servidores MCP, memoria, Skills y claves .env admitidas de Hermes.
El punto de entrada de la CLI es openclaw migrate. La incorporación también puede ofrecer migración cuando detecta una fuente conocida (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 en credentials/.
  • Sesiones — historial de conversación y estado del agente.
  • Estado del canal — inicio de sesión de WhatsApp, sesión de Telegram y similares.
  • Archivos del espacio de trabajo — MEMORY.md, USER.md, Skills e instrucciones.
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 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

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 hayan incluido los directorios ocultos y de que la propiedad de los archivos coincida con el usuario que ejecutará el Gateway.
4

Ejecutar doctor y verificar

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 la alternativa de entorno predeterminada (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 habilitada de Telegram o Discord no tiene ningún token configurado y la variable de entorno correspondiente no está disponible para el proceso de doctor.

​
Problemas comunes

Si el Gateway antiguo usaba --profile u OPENCLAW_STATE_DIR y el nuevo no, los canales aparecerán con la 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 es suficiente. Los perfiles de autenticación de modelo están en agents/<agentId>/agent/auth-profiles.json, y el estado de canales y proveedores está en credentials/. Migra siempre el directorio de estado completo.
Si copiaste como root o cambiaste de usuario, es posible 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 interfaz de usuario apunta a un Gateway remoto, el host remoto es el propietario de 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. Almacena 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 se necesita volver a emparejar).
  • 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 Plugin 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 Plugin se encuentran 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