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 importa el estado de Hermes mediante un proveedor de migración incluido. El proveedor previsualiza todo antes de cambiar el estado, redacta los secretos en los planes y los informes, y crea una copia de seguridad verificada antes de aplicar los cambios.
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 directamente con --overwrite después de revisar el plan.

​
Dos formas de importar

La ruta más rápida. El asistente detecta Hermes en ~/.hermes y muestra una vista previa antes de aplicar los cambios.
openclaw onboard --flow import
O apunta a una fuente específica:
openclaw onboard --import-from hermes --import-source ~/.hermes

​
Qué se importa

  • Selección de modelo predeterminada 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 basada en 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.
Establece --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 la marca, los secretos nunca se copian.

​
Qué queda solo como archivo

El proveedor copia estos elementos en el directorio del informe 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/
  • auth.json
  • state.db
OpenClaw se niega a ejecutar o confiar automáticamente en este estado porque los formatos y los supuestos de confianza pueden divergir entre sistemas. Mueve manualmente lo que necesites después de revisar el archivo.

​
Flujo recomendado

1

Previsualiza el plan

openclaw migrate hermes --dry-run
El plan enumera todo lo que cambiará, incluidos conflictos, elementos omitidos y cualquier elemento sensible. La salida del plan redacta las claves anidadas que parezcan secretas.
2

Aplica con copia de seguridad

openclaw migrate apply hermes --yes
OpenClaw crea y verifica una copia de seguridad antes de aplicar los cambios. Si necesitas importar claves de API, añade --include-secrets.
3

Ejecuta 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

Reinicia y verifica

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.

​
Manejo de conflictos

La aplicación 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 a nivel de elemento para archivos sobrescritos en el directorio del informe de migración.
En una instalación nueva de OpenClaw, los conflictos son inusuales. Suelen aparecer cuando vuelves a ejecutar la importación en una configuración que ya tiene ediciones del usuario. Si surge un conflicto a mitad de la aplicación (por ejemplo, una condición de 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

Los secretos nunca se importan de forma predeterminada.
  • Ejecuta primero openclaw migrate apply hermes --yes para importar el estado no secreto.
  • Si también quieres copiar las claves .env admitidas, vuelve a ejecutar con --include-secrets.
  • Para credenciales gestionadas por SecretRef, configura la fuente de SecretRef después de que finalice 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, la aplicación imprime el plan y no muta el estado. Este es 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 incorporarlo, o usa openclaw migrate apply hermes directamente, que admite --overwrite y control explícito de copias de seguridad.
--include-secrets es obligatorio, y solo se reconocen las claves enumeradas arriba. Otras variables en .env se ignoran.

​
Relacionado