Saltar al contenido principal
El proveedor de migración de Hermes incluido detecta el estado en ~/.hermes, previsualiza cada cambio antes de aplicarlo, redacta los secretos en planes e informes y escribe una copia de seguridad verificada de OpenClaw antes de tocar nada.
Las importaciones requieren una configuración nueva de OpenClaw. Si ya tienes estado local de OpenClaw, restablece primero la configuración, las credenciales, las sesiones y el espacio de trabajo, o usa openclaw migrate apply hermes directamente con --overwrite después de revisar el plan.

​
Dos formas de importar

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

​
Qué se importa

  • Selección del modelo predeterminado desde config.yaml de Hermes.
  • Proveedores de modelos configurados y endpoints personalizados compatibles con OpenAI desde providers y custom_providers.
Definiciones de servidores MCP desde mcp_servers o mcp.servers.
  • SOUL.md y AGENTS.md se copian en el espacio de trabajo del agente de OpenClaw.
  • memories/MEMORY.md y memories/USER.md se añaden a los archivos de memoria correspondientes de OpenClaw en lugar de sobrescribirlos.
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 puedas moverlos deliberadamente.
Las Skills con un archivo SKILL.md bajo skills/<name>/ se copian, junto con los valores de configuración por Skill desde skills.config.
openclaw migrate interactivo pregunta antes de importar credenciales de autenticación, con sí seleccionado de forma predeterminada. Al aceptar, se importan las entradas de OAuth de OpenAI de OpenCode y GitHub Copilot desde auth.json de OpenCode, además de las claves .env de Hermes compatibles. Las entradas OAuth del propio auth.json de Hermes son estado heredado: aparecen como un elemento de reautenticación manual o doctor en lugar de importarse en la autenticación activa. Usa --include-secrets para importar credenciales en una ejecución no interactiva, --no-auth-credentials para omitir por completo la importación de credenciales, o la marca --import-secrets del asistente de incorporación.

​
Qué queda solo como archivo

El proveedor copia estos elementos en el directorio de informes de migración para revisión manual, pero no los carga en la configuración ni en las credenciales activas de OpenClaw:
  • plugins/
  • sessions/
  • logs/
  • cron/
  • mcp-tokens/
  • state.db
OpenClaw se niega a ejecutar o confiar automáticamente en este estado porque los formatos y los supuestos de confianza pueden variar entre sistemas. Mueve manualmente lo que necesites después de revisar el archivo.

​
Flujo recomendado

1

Previsualizar el plan

openclaw migrate hermes --dry-run
El plan enumera todo lo que cambiará, incluidos conflictos, elementos omitidos y elementos sensibles. Las claves anidadas que parecen secretas se redactan en la salida.
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 solo estado no secreto. Ejecuta sin --yes para responder al aviso de credenciales de forma interactiva, o añade --include-secrets para incluir credenciales compatibles en una ejecución desatendida.
3

Ejecutar doctor

openclaw doctor
Doctor vuelve a aplicar cualquier migración de configuración pendiente y comprueba si se introdujeron problemas durante la importación.
4

Reiniciar y verificar

openclaw gateway restart
openclaw status
Confirma que el Gateway está en buen estado y que el modelo, la memoria y las Skills importados están cargados.

​
Gestión de conflictos

Apply se niega a continuar cuando el plan informa conflictos (un archivo o valor de configuración ya existe en el destino).
Vuelve a ejecutar con --overwrite solo cuando reemplazar el destino existente sea intencional. Los proveedores aún pueden escribir copias de seguridad por elemento para archivos sobrescritos en el directorio de informes de migración.
Los conflictos son inusuales en una instalación nueva. Normalmente aparecen cuando vuelves a ejecutar la importación contra una configuración que ya tiene ediciones del usuario. Si aparece 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 el motivo 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

openclaw migrate interactivo pregunta si se deben importar las credenciales de autenticación detectadas, con sí seleccionado de forma predeterminada.
  • Al aceptar, se importan las entradas de OAuth de OpenAI de OpenCode y GitHub Copilot desde auth.json de OpenCode, además de las claves .env compatibles. Las entradas OAuth del propio auth.json de Hermes se informan para reautenticación manual de OpenAI o reparación de doctor en su lugar.
  • Usa --no-auth-credentials, o responde no en el aviso, para importar solo estado no secreto.
  • Usa --include-secrets para importar credenciales en una ejecución --yes desatendida.
  • Usa la marca --import-secrets del asistente de incorporación para importar credenciales desde el asistente.

​
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: el modo más seguro para CI y scripts compartidos.

​
Solución de problemas

Inspecciona la salida del plan. Cada conflicto identifica la ruta de origen y el destino existente. Decide por elemento si omitirlo, editar el destino o volver a ejecutar con --overwrite.
Pasa --from /actual/path (CLI) o --import-source /actual/path (incorporación).
Las importaciones de incorporación requieren una configuración nueva. Restablece el estado y vuelve a incorporarte, o usa openclaw migrate apply hermes directamente, que admite --overwrite y control explícito de copias de seguridad.
openclaw migrate interactivo importa claves de API solo cuando aceptas el aviso de credenciales. Las ejecuciones no interactivas con --yes necesitan --include-secrets; las importaciones de incorporación necesitan --import-secrets. Solo se reconocen las claves .env compatibles; otras variables .env se ignoran.

​
Relacionado