Migrar OpenClaw a Hermes: qué se transfiere y qué se archiva

Migrar OpenClaw a Hermes es un único comando oficial: hermes claw migrate. Lee ~/.openclaw/, muestra una vista previa completa antes de escribir nada y, de forma predeterminada, escribe primero un zip de recuperación; pero no importa tus tareas cron, y esa omisión es el punto en el que una configuración migrada empieza silenciosamente a pagar dos veces. El orden seguro es hacer una copia de seguridad, ejecutar una prueba, aplicar, verificar en una sesión nueva, detener el programador antiguo y después limpiar.

Fija las entidades antes que nada, porque esta consulta entra en conflicto con tres productos no relacionados. Esta página trata sobre Hermes Agent de Nous Research —la CLI y la pasarela, cuya versión más reciente es v0.21.3 (etiqueta v2026.9.14, publicada el 14 de septiembre de 2026)— y sobre OpenClaw de OpenClaw Foundation, cuya versión más reciente es v2026.9.5, publicada el 19 de septiembre de 2026. Ambos repositorios estaban activos y no archivados cuando se volvieron a comprobar sus metadatos el 21 de septiembre de 2026. No es Hermes 4, la familia independiente de modelos de pesos abiertos de Nous Research; ni el motor JavaScript Hermes de Meta; ni la casa de lujo. Si todavía usas ~/.clawdbot/ o ~/.moltbot/, se trata del mismo producto con nombres anteriores, y el importador detecta ambos directorios y los nombres de configuración clawdbot.json / moltbot.json.

Por qué la gente se cambia y quién no debería hacerlo

El precio no es el motivo. Ambos proyectos son software libre: el README de OpenClaw afirma que «no tiene nivel de pago, servicio alojado ni token», y su archivo LICENSE es MIT simple aunque la API de GitHub indique NOASSERTION en el campo de licencia del repositorio; cita el archivo, no el campo. La API de GitHub identifica Hermes Agent como MIT. En ambos casos, pagas los tokens de los modelos y el host donde ejecutas la pasarela.

Conviene corregir algo, porque las páginas de comparación antiguas están desactualizadas: la dirección inversa ya no es solo de memoria. OpenClaw documenta ahora una migración completa con vista previa: openclaw migrate hermes --dry-run y después openclaw migrate apply hermes --yes, importando la configuración de modelos, proveedores y endpoints personalizados, servidores MCP, SOUL.md y AGENTS.md, archivos de memoria (añadidos), configuración de memoria, habilidades con su configuración y credenciales de autenticación con consentimiento. Lo que esa documentación sigue describiendo como una copia solo de memoria son sus importaciones de memoria de incorporación y de la interfaz de control, que colocan MEMORY.md y USER.md bajo memory/imports/hermes/ sin tocar la memoria existente del espacio de trabajo. Por tanto, es una puerta de doble sentido, con una advertencia para el regreso: no dejes que Hermes y OpenClaw compartan el mismo refresh grant.

Qué se migra y qué se archiva en su lugar

Lee esta tabla como la lista de aceptación. Todo lo que aparece en la columna derecha es trabajo que debes hacer manualmente, según el calendario que elijas, y no constituye un fallo de la herramienta: Hermes lo archiva deliberadamente bajo ~/.hermes/migration/openclaw/<timestamp>/archive/.

Dos mapeos son con pérdida de una forma que una lista de comprobación oculta. agents.defaults.timeoutSeconds no se convierte en un tiempo de espera de Hermes, sino en agent.max_turns, calculado como timeoutSeconds / 10 y limitado a 200. Además, el vocabulario de diez valores de OpenClaw para el esfuerzo de razonamiento se reduce a tres: always, high y xhigh terminan en high; auto, medium y adaptive en medium; off, low, none y minimal en low. Ambos son cálculos, no copias, así que comprueba los valores resultantes en lugar de asumir que se conservaron tus ajustes anteriores. Los temporizadores de inactividad de sesión y de restablecimiento diario no se importan: las conversaciones de Hermes persisten hasta un /new o /reset explícito. Todo esto procede de la guía oficial de migración desde OpenClaw, consultada el 19 de septiembre de 2026.

El comando, opción por opción

Un orden de trabajo que sigue la lista de comprobación oficial posterior a la migración sin inventar pasos. Primero, detén la programación de OpenClaw: openclaw cron list; después, ejecuta openclaw cron disable <job-id> para cualquier elemento que pudiera duplicarse (openclaw automations es un alias documentado para cualquiera de los dos). Segundo, ejecuta la prueba. Tercero, aplica, dejando que se escriba el zip de recuperación predeterminado. Cuarto, lee el informe de migración y todo lo que haya dentro del directorio de archivo. Quinto —este paso atrapa a mucha gente— inicia una sesión nueva; las habilidades y entradas de memoria importadas no surten efecto en la sesión en la que ya estabas, y /skills confirma qué se cargó. Sexto, ejecuta hermes status para la autenticación de proveedores, reinicia la pasarela si moviste tokens de plataforma y vuelve a emparejar WhatsApp si lo utilizabas. Solo cuando todo eso haya pasado, ejecuta hermes claw cleanup, que cambia el nombre de los directorios restantes de OpenClaw a .pre-migration/ para que dos agentes no puedan leer el mismo estado. Es un subcomando independiente, no una opción de migrate; la guía no documenta opciones propias para él.

La salvedad sobre el orden es honesta, aunque incómoda: la documentación de Hermes coloca la limpieza en el paso 8 y no indica qué ocurre si un servicio de pasarela de OpenClaw sigue instalado cuando se cambia el nombre de su directorio. Detener primero el programador y la pasarela de OpenClaw es defendible según la documentación de ambos proyectos; no es una secuencia que ninguno de los dos proyectos exponga explícitamente.

La factura de la programación duplicada, calculada

Las tareas cron se archivan, no se importan. Por tanto, el fallo natural es este: recreas cuatro tareas en Hermes, la pasarela de OpenClaw sigue instalada y cada aviso programado se ejecuta dos veces contra tu proveedor. Aquí se calcula el coste como aritmética de tokens, no como coste medido de una tarea ni como límite de facturación. Supón que una ejecución programada envía 25,000 tokens de entrada sin caché y devuelve 1,500 tokens de salida, y que cuatro tareas ejecutándose cada dos horas producen 48 ejecuciones duplicadas al día. Las tarifas son los precios activos del catálogo de Kunavo por millón de tokens.

Sustituye tus propios parámetros de ejecución y cadencia; lo importante es el multiplicador, no la fila. Si ya se están ejecutando trabajos duplicados, Hermes documenta un único mecanismo: hermes pause es una parada de emergencia global; no se inicia ninguna nueva ejecución cron, despacho kanban ni turno de la pasarela hasta hermes resume, y el trabajo en curso no se cancela. Úsalo para detener la pérdida y después desactiva el lado correcto. Observa el límite de permisos en OpenClaw: su referencia de automatizaciones indica que add/create, edit, remove y run requieren operator.admin. No indica si disable queda dentro de ese conjunto, así que presupuesta que podrías necesitar el rol.

Conviene mencionar otras dos fuentes más silenciosas de costes posteriores a la migración. La página de configuración de modelos de Hermes advierte que las cachés de prompts están vinculadas al modelo que atiende la solicitud, por lo que un cambio de /model a mitad de una conversación hace que el siguiente mensaje vuelva a leer la conversación completa al precio íntegro de tokens de entrada; su página de proveedores de reserva dice lo mismo sobre una reserva automática, y su página de grupos de credenciales indica que las cachés del proveedor están vinculadas a la cuenta o clave que realizó la solicitud, por lo que una rotación del grupo también cuesta una pasada completa a precio normal. En Claude Sonnet 4.6 a las tarifas del catálogo, volver a leer una conversación de 200,000 tokens cuesta aproximadamente $0.420 a la $2.10 tarifa de entrada, frente a aproximadamente $0.042 a la $0.21 tarifa de lectura de caché; de nuevo, es aritmética ilustrativa basada en las suposiciones indicadas. Hermes ofrece model.switch_context_confirm_tokens como protección. Por separado, la misma página indica que las ranuras auxiliares —visión, resumen web, compresión y demás— toman como valor predeterminado provider: auto con un model vacío, lo que interpreta como usar el modelo principal para esa tarea; por tanto, una configuración recién migrada puede facturar tarifas de modelo insignia por tareas de fondo hasta que las sustituyas.

Dirigir el Hermes migrado a tu propio endpoint

La documentación de proveedores de Hermes indica que funciona con cualquier endpoint de API compatible con OpenAI. La trampa específica de la migración está en dónde termina el proveedor importado: una entrada models.providers.* de OpenClaw se escribe en custom_providers, y solo se convierte en una entrada del diccionario canónico providers: durante la siguiente migración de configuración hermes update. Una guía que te indique buscar en providers: justo después de migrar te está enviando a una clave vacía.

# What `hermes claw migrate` writes FIRST. An OpenClaw
# `models.providers.*` entry lands under `custom_providers`,
# not under `providers:` — so check here right after migrating.
custom_providers:
  - name: kunavo
    base_url: https://api.kunavo.com/v1
    api_key: sk-your-kunavo-key
    model: claude-sonnet-4-6

# The providers doc says the legacy list is auto-migrated to the
# canonical `providers:` dict on `hermes update` (config v12). The
# documented keys of that dict are `api`, `key_env`, `transport`
# and `default_model` (`base_url`/`url` are accepted aliases of `api`).
providers:
  kunavo:
    api: https://api.kunavo.com/v1
    key_env: KUNAVO_API_KEY
    transport: chat_completions
    default_model: claude-sonnet-4-6

Tres notas sobre ese bloque. El importador asigna tanto los valores de API cortos (openai, anthropic) como los separados por guiones (openai-completions, anthropic-messages, google-generative-ai) de OpenClaw. La propia documentación de Hermes discrepa sobre el nombre del transporte: la referencia de proveedores enumera chat_completions, anthropic_messages y codex_responses, mientras que la página de configuración de modelos escribe transport: openai_chat; usa chat_completions, que es el valor proporcionado por la referencia específica de proveedores, y considera openai_chat no confirmado. Los endpoints personalizados compatibles con OpenAI no reciben en Hermes ningún límite automático de salida del tamaño del catálogo, así que establece context_length tú mismo o proporciona una lista explícita models: con discover_models: false si la detección contra tu endpoint no funciona como esperas.

Para dejar claros los límites de esta página: Kunavo publica referencias de configuración para varios clientes, pero Hermes Agent no se ha probado aquí en tiempo de ejecución, no se ejecutó ningún hermes claw migrate para este artículo y no se ha probado si el transporte anthropic_messages de Hermes o su detección de modelos funcionan correctamente contra el endpoint de Kunavo. Mantén disponible una ruta operativa mientras lo pruebas. A las tarifas del catálogo, Claude Sonnet 4.6 enumera $2.10 por millón de tokens de entrada y $10.50 por millón de tokens de salida; el importe del catálogo de Kunavo es un mínimo de facturación, no un límite, porque cuando el upstream informa de su cargo, la factura es el mayor entre el coste del catálogo y el coste del upstream multiplicado por el margen aplicable. La recarga mínima es de $10 en crédito prepagado: un mínimo de financiación, no una tarifa por tarea ni una suscripción. Consulta los detalles de facturación y crea una cuenta de Kunavo cuando estés listo para financiar una clave.

Después del primer día, concilia los datos. Hermes incluye hermes insights, que la referencia de su CLI describe únicamente como «mostrar análisis de tokens/coste/actividad» y documenta sin opciones, así que lee hermes insights --help para saber qué acepta realmente tu compilación y compáralo con el uso que haya registrado tu cuenta del proveedor. Si no coinciden, busca una programación duplicada antes de buscar un error de precios. Para conocer el contexto de este método, consulta optimización de costes de IA; para la visión de los planes de cada lado, precios de Hermes Agent y precios de OpenClaw; y Hermes frente a OpenClaw si aún no te has comprometido con el cambio.

Preguntas frecuentes

Documentación de Hermes Agent y OpenClaw, referencias de CLI y metadatos de repositorios comprobados el 19 de septiembre de 2026, con Hermes v0.21.3 (v2026.9.14) y OpenClaw v2026.9.5; los metadatos de los repositorios se volvieron a comprobar el 21 de septiembre de 2026. Todos los comandos, indicadores y rutas de esta página se leyeron en esas fuentes oficiales; no se ejecutó ninguna migración ni se dirigió ninguna clave de Kunavo a ninguno de los dos agentes, por lo que esto no constituye una prueba de compatibilidad. Las tarifas de tokens de Kunavo proceden del catálogo activo, y todas las cifras en dólares son cálculos ilustrativos de tokens, no un coste medido.