Ir al contenido
OpenClaw Docs

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.

Dos formas de importar

Sección titulada «Dos formas de importar»

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

Ventana de terminal
openclaw onboard --flow import

O apunta a una fuente específica:

Ventana de terminal
openclaw onboard --import-from hermes --import-source ~/.hermes

Qué se importa

Sección titulada «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`.

Claves de API (opcional)

Establezca --include-secrets para importar las claves .env admitidas: OPENAI_API_KEY, ANTHROPIC_API_KEY, OPENROUTER_API_KEY, GOOGLE_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, XAI_API_KEY, MISTRAL_API_KEY, DEEPSEEK_API_KEY. Sin el indicador, los secretos nunca se copian.

Lo que permanece solo en el archivo

Sección titulada «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/
  • auth.json
  • state.db

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

Flujo recomendado

Sección titulada «Flujo recomendado»

  1. Vista previa del plan

    Ventana de terminal
    openclaw migrate hermes --dry-run

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

  2. Aplicar con copia de seguridad

    Ventana de terminal
    openclaw migrate apply hermes --yes

    OpenClaw crea y verifica una copia de seguridad antes de aplicar. Si necesitas que se importen las claves de API, añade --include-secrets.

  3. Ejecutar doctor

    Ventana de terminal
    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

    Ventana de terminal
    openclaw gateway restart
    openclaw status

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

Manejo de conflictos

Sección titulada «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).

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 a mitad de la aplicación (por ejemplo, una condición 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 reporte de migración registra cada elemento bloqueado para que puedas resolver el conflicto original y volver a ejecutar la importación.

Secretos

Sección titulada «Secretos»

Los secretos nunca se importan de manera predeterminada.

  • Ejecuta openclaw migrate apply hermes --yes primero para importar el estado que no es secreto.
  • Si también quieres que las claves .env compatibles se copien, vuelve a ejecutar con --include-secrets.
  • Para las credenciales administradas por SecretRef, configura la fuente de SecretRef después de que la importación se complete.

Salida JSON para automatización

Sección titulada «Salida JSON para automatización»
Ventana de terminal
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

Sección titulada «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 se encuentra fuera de ~/.hermes

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

La incorporación se niega a importar en una configuración existente

Las importaciones de incorporación requieren una configuración nueva. Restablezca el estado y vuelva a realizar la incorporación, o use openclaw migrate apply hermes directamente, que admite --overwrite y control explícito de copias de seguridad.

Las claves API no se importaron

Se requiere --include-secrets y solo se reconocen las claves enumeradas anteriormente. Otras variables en .env se ignoran.

Relacionado

Sección titulada «Relacionado»