English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Maintenance

Guía de migración

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.

Pasos de migración

  • 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.

  • 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.

  • 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.

  • 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

    Discrepancia de perfil o directorio de estado

    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.

    Copiar solo openclaw.json

    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.

    Permisos y propiedad

    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.

    Modo remoto

    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.

    Secretos en copias de seguridad

    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