Migrar desde Hermes

OpenClaw importa el estado de Hermes a través de un proveedor de migración incluido. El proveedor previsualiza todo antes de cambiar el estado, redacta secretos en los planes e informes, y crea una copia de seguridad verificada antes de aplicar.

Note

Las importaciones requieren una configuración fresca de OpenClaw. Si ya tienes un estado local de OpenClaw, restablece primero la configuración, las credenciales, las sesiones y el espacio de trabajo, o usa

openclaw migrate

directamente con

--overwrite

después de revisar el plan.

Dos formas de importar

Asistente de incorporaciónCLI

La ruta más rápida. El asistente detecta Hermes en ~/.hermes y muestra una vista previa antes de aplicar.

openclaw onboard --flow import

O apunta a una fuente específica:

openclaw onboard --import-from hermes --import-source ~/.hermes

Use openclaw migrate para ejecuciones con script o repetibles. Consulte openclaw migrate para obtener la referencia completa.

openclaw migrate hermes --dry-run    # preview only
openclaw migrate apply hermes --yes  # apply with confirmation skipped

Agregue `—from

cuando Hermes se encuentre fuera de~/.hermes`.

Qué se importa

Configuración del modelo

• Selección del modelo predeterminado de Hermes config.yaml.
• Proveedores de modelo configurados y endpoints personalizados compatibles con OpenAI de providers y custom_providers.

Servidores MCP

Definiciones de servidores MCP desde mcp_servers o mcp.servers.

Archivos del espacio de trabajo

• SOUL.md y AGENTS.md se copian en el espacio de trabajo del agente OpenClaw.
• memories/MEMORY.md y memories/USER.md se añaden a los archivos de memoria de OpenClaw correspondientes en lugar de sobrescribirlos.

Configuración de memoria

Valores predeterminados de configuración de memoria para la memoria de archivos de OpenClaw. Los proveedores de memoria externos como Honcho se registran como elementos de archivo o de revisión manual para que pueda moverlos deliberadamente.

Habilidades

Las habilidades con un archivo SKILL.md bajo `skills/

/se copian, junto con los valores de configuración por habilidad deskills.config`.

Auth credentials

El modo interactivo openclaw migrate pregunta antes de importar las credenciales de autenticación, con “sí” seleccionado por defecto. Las importaciones aceptadas incluyen las credenciales OAuth de OpenAI de OpenCode desde OpenCode auth.json, las entradas de OpenCode y GitHub Copilot desde OpenCode auth.json y las claves .env compatibles. Las entradas OAuth de Hermes auth.json son un estado heredado y se presentan como trabajo de reautenticación manual o reparación (doctor) en lugar de importarse a la autenticación en vivo. Use --include-secrets para la importación de credenciales no interactiva openclaw migrate, --no-auth-credentials para omitirla, o la incorporación (onboarding) --import-secrets al importar desde el asistente de incorporación.

Lo que permanece solo en el archivo

El proveedor copia estos elementos en el directorio del informe de migración para su revisión manual, pero no los carga en la configuración o las credenciales en vivo de OpenClaw:

• plugins/
• sessions/
• logs/
• cron/
• mcp-tokens/
• state.db

OpenClaw se niega a ejecutar o confiar en este estado automáticamente porque los formatos y las suposiciones de confianza pueden derivar entre sistemas. Mueva manualmente lo que necesite después de revisar el archivo.

Flujo recomendado

1. Vista previa del plan

   openclaw migrate hermes --dry-run

   El plan enumera todo lo que cambiará, incluidos los conflictos, los elementos omitidos y cualquier elemento sensible. La salida del plan oculta las claves anidadas que parezcan secretos.

2. Aplicar con copia de seguridad

   openclaw migrate apply hermes --yes

   OpenClaw crea y verifica una copia de seguridad antes de aplicar. Este ejemplo no interactivo importa el estado que no es secreto. Ejecute sin --yes para responder al indicador de credenciales, o añada --include-secrets para incluir las credenciales compatibles en ejecuciones desatendidas.

3. Ejecutar doctor

   openclaw doctor

   Doctor vuelve a aplicar cualquier migración de configuración pendiente y comprueba si hay problemas introducidos durante la importación.

4. Reiniciar y verificar

   openclaw gateway restart
   openclaw status

   Confirme que la puerta de enlace está sana y que su modelo, memoria y habilidades importados están cargados.

Manejo de conflictos

Apply se niega a continuar cuando el plan reporta conflictos (un archivo o valor de configuración ya existe en el destino).

Warning

Vuelva a ejecutar con

--overwrite

solo cuando reemplazar el destino existente sea intencional. Los proveedores aún pueden escribir copias de seguridad a nivel de elemento para los archivos sobrescritos en el directorio de informes de migración.

Para una instalación fresca de OpenClaw, los conflictos son inusuales. Típicamente aparecen cuando vuelves a ejecutar la importación en una configuración que ya tiene ediciones de usuario.

Si surge un conflicto durante la aplicación (por ejemplo, una carrera inesperada en un archivo de configuración), Hermes marca los elementos de configuración dependientes restantes como skipped con la razón blocked by earlier apply conflict en lugar de escribirlos parcialmente. El informe de migración registra cada elemento bloqueado para que puedas resolver el conflicto original y volver a ejecutar la importación.

Secretos

El openclaw migrate interactivo pregunta si se deben importar las credenciales de autenticación detectadas, con sí seleccionado de forma predeterminada.

• Aceptar el aviso importa las credenciales OAuth de OpenAI de OpenCode desde OpenCode auth.json, las entradas de OpenCode y GitHub Copilot desde OpenCode auth.json y las claves .env compatibles. Las entradas OAuth de Hermes auth.json se reportan para la reautenticación manual de OpenAI o la reparación mediante doctor.
• Use --no-auth-credentials o elija no en la sugerencia para importar solo el estado que no sea secreto.
• Use --include-secrets cuando se ejecute desatendido con --yes.
• Use el --import-secrets de incorporación al importar credenciales desde el asistente de incorporación.
• Para las credenciales administradas por SecretRef, configure el origen de SecretRef después de que se complete la importación.

Salida JSON para automatización

openclaw migrate hermes --dry-run --json
openclaw migrate apply hermes --json --yes

Con --json y sin --yes, apply imprime el plan y no muta el estado. Este es el modo más seguro para CI y scripts compartidos.

Solución de problemas

Apply se niega con conflictos

Inspeccione la salida del plan. Cada conflicto identifica la ruta de origen y el destino existente. Decida por elemento si omitir, editar el destino o volver a ejecutar con --overwrite.

Hermes reside fuera de ~/.hermes

Pase --from /actual/path (CLI) o --import-source /actual/path (incorporación).

Onboarding se niega a importar en una configuración existente

La importación de Onboarding requiere una configuración nueva. Restablezca el estado y vuelva a realizar el onboarding, o use openclaw migrate apply hermes directamente, que admite --overwrite y control explícito de copias de seguridad.

Las claves de API no se importaron

openclaw migrate interactivo importa las claves de API solo cuando acepta el aviso de credenciales. Las ejecuciones no interactivas de --yes requieren --include-secrets; las importaciones de onboarding requieren --import-secrets. Solo se reconocen las claves .env compatibles; se ignoran otras variables en .env.

Relacionado

• openclaw migrate: referencia completa de la CLI, contrato del complemento y formas JSON.
• Onboarding: flujo del asistente y marcas no interactivas.
• Migrating: mover una instalación de OpenClaw entre máquinas.
• Doctor: verificación de salud posterior a la migración.
• Agent workspace: donde residen SOUL.md, AGENTS.md y los archivos de memoria.