MemoryLake
Volver a todos los artículos
Tutorial9 de octubre de 2026·10 min de lectura

Cómo migrar de OpenClaw a Hermes Agent sin perder el contexto (2026)

OpenClaw y Hermes Agent son primos cercanos. Ambos son agentes autoalojados a los que se accede desde aplicaciones de chat y la terminal, ambos definen al agente con unos pocos archivos Markdown y ambos conservan la memoria entre sesiones. Hermes incluso incluye un comando dedicado para el traslado: "hermes claw migrate importa tu configuración de OpenClaw (o de los legados Clawdbot/Moldbot) a Hermes".

Eso facilita la mecánica. La parte que merece tu atención es lo que ocurre con la memoria durante el trayecto, porque ambos proyectos conciben la memoria de forma diferente. OpenClaw trata sus notas diarias como una capa de trabajo que se mantiene fuera del prompt. Hermes, durante la migración, fusiona esas notas diarias en un único archivo de memoria que inyecta en cada sesión y limita con un máximo de caracteres.

Esta guía cubre lo que transfiere la migración, dónde aterriza tu contexto y cómo preparar tu memoria de OpenClaw para que las partes importantes lleguen intactas. Para obtener información sobre cómo funciona internamente la memoria de OpenClaw, consulta dentro del sistema de memoria de OpenClaw.

Qué se transfiere realmente

Persona, instrucciones y habilidades

Hermes publica una tabla de mapeo para la migración. Tu persona se traslada como una "Copia directa" de workspace/SOUL.md a ~/.hermes/SOUL.md. Las instrucciones del espacio de trabajo se trasladan a un AGENTS.md, pero la tabla señala que esto "Requiere la bandera --workspace-target", así que indícale a la migración dónde vive tu proyecto cuando la ejecutes.

Las habilidades provienen de cuatro ubicaciones de OpenClaw, incluyendo habilidades del espacio de trabajo, habilidades gestionadas y habilidades personales entre proyectos, y todas ellas aterrizan en ~/.hermes/skills/openclaw-imports/. Si ya existe una habilidad con el mismo nombre en Hermes, el modo de conflicto predeterminado es skip, lo que deja la habilidad existente de Hermes en su lugar.

Memoria y el perfil de usuario

Esta es la parte que debes leer con atención. La memoria a largo plazo de OpenClaw se traslada de workspace/MEMORY.md a ~/.hermes/memories/MEMORY.md, donde es "Analizada en entradas, fusionada con la existente y duplicados eliminados". Tu perfil de usuario sigue la "Misma lógica de fusión de entradas que la memoria".

Luego viene la línea que cambia la forma de tu memoria. Los archivos de memoria diaria de workspace/memory/*.md también van a ~/.hermes/memories/MEMORY.md, con la nota: "Todos los archivos diarios se fusionan en la memoria principal".

Para ver por qué esto importa, compara cómo describe cada proyecto estos archivos.

En OpenClaw, "MEMORY.md es la capa compacta y depurada para hechos duraderos que no son del perfil, decisiones permanentes y resúmenes cortos que deben estar disponibles al inicio de una sesión. No es una transcripción sin procesar, un registro diario o un archivo exhaustivo". Las notas diarias son diferentes: "Los archivos memory/YYYY-MM-DD.md son la capa de trabajo: notas diarias detalladas, observaciones, resúmenes de sesiones y contexto sin procesar que aún puede ser útil más adelante". OpenClaw los mantiene listos para búsqueda en lugar de cargados siempre. "Estos están indexados para memory_search y memory_get, pero no se inyectan en el prompt de arranque en cada turno". Con el tiempo, "el material útil de las notas diarias se destila en MEMORY.md mediante el barrido de ensueño (dreaming sweep) predeterminado".

En Hermes, MEMORY.md contiene las notas personales del agente y tiene un límite de caracteres de 2,200 caracteres. "Ambos se almacenan en ~/.hermes/memories/ y se inyectan en el prompt del sistema como una instantánea congelada al inicio de la sesión". Y Hermes es explícito sobre lo que sucede al llegar al límite: "La memoria no se autocompacta: cuando una escritura supera el límite, la herramienta memory devuelve un error en lugar de descartar entradas silenciosamente".

Así que una capa de trabajo que OpenClaw mantenía fuera del prompt se fusiona en un archivo pequeño y siempre cargado en Hermes. La guía de migración describe la fusión y la eliminación de duplicados. No describe qué sucede cuando las entradas fusionadas superan el límite de memoria, razón por la cual el paso de preparación a continuación es importante. El límite se puede configurar a través de memory_char_limit en el config.yaml de Hermes, pero aumentarlo significa un prompt del sistema más grande en cada sesión.

Por el contrario, la propia importación de OpenClaw desde Hermes adopta el enfoque opuesto para las importaciones de solo memoria: los archivos importados "no se fusionan en el MEMORY.md de arranque del agente" y permanecen separados para la recuperación indexada. Ninguna de las dos opciones es incorrecta. Son dos diseños, y saber a cuál te estás trasladando te indica qué debes depurar.

Qué se archiva para revisión manual

Algunas configuraciones de OpenClaw no tienen un equivalente directo y se guardan para que las manejes tú mismo. Hermes dice: "Estas se guardan en ~/.hermes/migration/openclaw/<timestamp>/archive/ para revisión manual". La lista incluye IDENTITY.md, con el consejo "Fusionar en SOUL.md"; HEARTBEAT.md, con "Usar tareas cron para tareas periódicas"; tareas cron, complementos (plugins), ganchos (hooks), vinculaciones de canales y la configuración de tu backend de memoria, que Hermes dice que se debe "Configurar a través de hermes honcho".

Los tiempos de sesión también cambian. "Los temporizadores de inactividad y de reinicio diario no se importan: las conversaciones de Hermes persisten hasta un /new o /reset explícito". Si dependías de los reinicios diarios para darle a tu agente un nuevo comienzo cada mañana, tendrás que crear esos límites tú mismo. Hermes recomienda exactamente ese hábito, porque la memoria solo se vuelve a leer cuando comienza una sesión: "ejecuta /new en límites naturales: una tarea terminada, un cambio de tema, el comienzo de un día".

Proveedores de memoria externa

Si utilizabas un backend de memoria externa en OpenClaw, este se archiva en lugar de migrarse. En Hermes, "Solo puede haber un proveedor externo activo a la vez; la memoria integrada siempre está activa junto a él". Hermes describe el proveedor externo como aditivo: "La memoria integrada (MEMORY.md / USER.md) continúa funcionando exactamente como antes". Planifica reconfigurar tu proveedor deliberadamente después del traslado.

La migración manual

Paso 1: Depura tu memoria de OpenClaw antes de migrar

Comienza con un simulacro. La migración admite --dry-run, que muestra el plan sin escribir nada, y por defecto "se escribe un único archivo de punto de restauración antes de aplicar". Lee el plan, especialmente la sección de memoria.

Luego depura en el lado de OpenClaw, donde tus herramientas aún funcionan.

Abre workspace/MEMORY.md y asegúrate de que contenga lo que desearías que se cargara al inicio de cada sesión: decisiones permanentes, hechos duraderos, convenciones. Elimina cualquier cosa obsoleta.

Revisa workspace/memory/. Estos archivos diarios están a punto de fusionarse en el archivo que siempre se carga. Para cada uno, pregúntate si contiene algo duradero. Si es así, destílalo en una línea corta en MEMORY.md, con tus propias palabras. Si es un registro de lo que sucedió un martes, no pertenece a una memoria de 2,200 caracteres. En su lugar, mantén los archivos diarios sin procesar en tu propio archivo.

Algunos detalles son duraderos pero solo importan para un trabajo recurrente, como la ruta de un archivo que una tarea semanal siempre necesita. Hermes sugiere un hogar diferente para ellos: "Para una ubicación que el agente necesita en cada ejecución de una tarea recurrente, una habilidad suele ser un mejor hogar que una entrada de memoria; se carga solo cuando es relevante y no compite por el presupuesto de 2,200 caracteres". Toma nota de esos elementos ahora para que puedas convertirlos en habilidades después del traslado en lugar de meterlos a la fuerza en la memoria.

Revisa USER.md de la misma manera. Debería describirte a ti, no a tus proyectos. La documentación de Hermes es clara en que SOUL.md y USER.md "son sistemas separados que nunca se alimentan entre sí", por lo que los hechos sobre ti pertenecen al perfil, mientras que el tono y la identidad pertenecen a SOUL.md.

Finalmente, toma nota de cualquier cosa en IDENTITY.md y HEARTBEAT.md que desees recrear, ya que se archivarán en lugar de aplicarse. Si tu agente de OpenClaw seguía perdiendo el rastro de las ejecuciones anteriores antes del traslado, por qué OpenClaw olvida las ejecuciones anteriores es una lista de verificación útil de lo que debes capturar.

Paso 2: Ejecuta la migración y luego verifica lo que llegó

Ejecuta la migración con el objetivo del espacio de trabajo configurado para que se coloque AGENTS.md. Por defecto, la migración se niega a aplicarse cuando el plan tiene conflictos, lo que protege una configuración existente de Hermes; revisa los conflictos en lugar de recurrir a la opción de sobrescribir.

Cuando termine, comienza con el paso uno de la lista de verificación de Hermes: "Verifica el informe de migración, impreso al finalizar con el recuento de elementos migrados, omitidos y en conflicto". Luego lee ~/.hermes/memories/MEMORY.md y USER.md directamente. Compáralos con lo que depuraste. Si faltan entradas, vuelve a agregar las más importantes a través del agente, un hecho a la vez.

Revisa la carpeta de archivo y recrea lo que necesites: fusiona las notas de identidad en SOUL.md, convierte las tareas de latido (heartbeat) en tareas cron y reconfigura cualquier proveedor de memoria externa.

Luego inicia una nueva sesión. Hermes señala que "las habilidades importadas y las entradas de memoria surten efecto en las nuevas sesiones, no en la actual". Pregúntale al agente algo que dependa de tu memoria, como una convención del proyecto o una decisión permanente, y verifica la respuesta.

Por último, verifica las instrucciones del proyecto. Hermes carga un tipo de contexto de proyecto por sesión, y "Solo se carga un tipo de contexto de proyecto por sesión (el primer acierto gana)", con .hermes.md por delante de AGENTS.md. Si un proyecto tiene ambos, el archivo específico de Hermes gana.

Cuando todo funcione, Hermes ofrece hermes claw cleanup para renombrar los directorios restantes de OpenClaw para que las dos configuraciones no se confundan.

La mejor manera: Mantén el contexto duradero fuera del archivo de memoria de cualquier agente

La migración manual funciona, y la depuración en el Paso 1 es lo que hace que funcione. Pero también muestra el problema subyacente. Cada agente tiene su propia idea de dónde vive la memoria, qué tan grande puede ser y qué se carga. Cada vez que te trasladas, remodelaciones tu conocimiento para adaptarlo al siguiente contenedor.

La parte duradera, es decir, las decisiones, las convenciones y las razones detrás de ellas, no necesita vivir dentro del archivo de memoria de ningún agente. Manténla en un solo lugar que tú administres y deja que la memoria integrada de cada agente haga aquello para lo que es buena: notas a corto plazo específicas del agente.

MemoryLake está diseñado para eso: una capa de memoria que mantienes una vez y conectas a los agentes que utilizas.

Tú mismo escribes las entradas, con tus propias palabras. No se lee, escribe ni elimina nada de tu espacio de trabajo de OpenClaw, de tus archivos de memoria de Hermes ni de la tienda de ningún proveedor.

Paso 1: Crea una clave API

Inicia sesión y genera una clave desde el panel de control. La clave pertenece a tu espacio de trabajo de MemoryLake, independiente de tus instalaciones de OpenClaw y Hermes.

La consola de MemoryLake mostrando la pantalla de claves API, donde se crea y copia una nueva clave para usar en un agente
La consola de MemoryLake mostrando la pantalla de claves API, donde se crea y copia una nueva clave para usar en un agente

Paso 2: Sube tus primeras memorias

Comienza con las líneas duraderas que destilaste de tus notas diarias en el Paso 1 y las decisiones permanentes de tu MEMORY.md depurado. Un hecho por entrada, con fecha.

El espacio de trabajo de MemoryLake con los primeros documentos subidos, listando cada archivo a medida que se convierte en memoria con capacidad de búsqueda
El espacio de trabajo de MemoryLake con los primeros documentos subidos, listando cada archivo a medida que se convierte en memoria con capacidad de búsqueda

Paso 3: Conecta tu IA y agentes

Conecta Hermes y los demás agentes que utilices. Hermes puede conectarse a servidores de herramientas externos a través de MCP, por lo que tu contexto estará disponible sin saturar su memoria integrada.

La pantalla de integraciones de MemoryLake que enumera los clientes de IA y los marcos de agentes que se pueden conectar a la capa de memoria
La pantalla de integraciones de MemoryLake que enumera los clientes de IA y los marcos de agentes que se pueden conectar a la capa de memoria

Qué cambia esto en la práctica

La primera diferencia es que nada importante depende de una fusión. Tu contexto duradero llega porque lo depuraste, no porque casualmente cupo dentro de un límite de caracteres.

La segunda es una memoria integrada ligera. El MEMORY.md de Hermes se mantiene pequeño y actualizado, que es lo que su diseño espera.

La tercera es que el detalle diario sigue disponible. Las notas sin procesar viven en tu archivo, y Hermes mantiene su propio historial de sesiones con capacidad de búsqueda: "Todas las sesiones de CLI y mensajería se almacenan en SQLite (~/.hermes/state.db) con búsqueda de texto completo FTS5".

La cuarta es que los futuros traslados serán más sencillos. Si más adelante agregas otro agente, o regresas a OpenClaw, el mismo contexto te acompaña. Los equipos que comparan opciones pueden comenzar desde las mejores configuraciones de memoria para agentes de OpenClaw, y el argumento más amplio para una capa compartida se presenta en MCP y memoria: la capa que falta.

Mejores prácticas para trasladarse de OpenClaw a Hermes Agent

Haz un simulacro primero. Lee la sección de memoria del plan antes de aplicar cualquier cosa.

Depura las notas diarias antes de la fusión. Destila los puntos duraderos en MEMORY.md; archiva el resto.

Configura el objetivo del espacio de trabajo. Hermes lo enumera como obligatorio para colocar AGENTS.md.

Mantén USER.md sobre ti y SOUL.md sobre el tono. Son sistemas separados en Hermes.

Recrea las tareas archivadas deliberadamente. Los latidos (heartbeats) se convierten en tareas cron; las notas de identidad se fusionan en SOUL.md.

Inicia una nueva sesión para probar. La memoria importada surte efecto en las nuevas sesiones.

Crea tus propios límites de sesión. Las conversaciones de Hermes persisten hasta /new o /reset. Para saber lo que la memoria de OpenClaw podía y no podía hacer desde el principio, consulta lo que la memoria de OpenClaw puede y no puede hacer; y si llegaste a OpenClaw desde Claude, migrar la memoria de Claude a OpenClaw muestra la etapa anterior del viaje. Para opciones de memoria persistente dentro del propio OpenClaw, consulta memoria de OpenClaw.

Conclusión

El comando hermes claw migrate de Hermes Agent traslada tu persona, instrucciones, habilidades, memoria y perfil de usuario desde OpenClaw, y archiva lo que no tiene un equivalente directo para que lo revises. El detalle a planificar es la memoria: las notas diarias de OpenClaw, una capa de trabajo que se mantiene fuera del prompt, se fusionan en el único MEMORY.md de Hermes, que se inyecta en cada sesión, tiene un tamaño limitado y no se autocompacta.

Depura antes de migrar. Destila las notas diarias en un MEMORY.md corto y actualizado, mantén los archivos sin procesar en tu propio archivo, realiza un simulacro y luego verifica el informe y los archivos de memoria después del traslado.

Mantén tu contexto duradero en algún lugar que administres tú mismo, y la próxima migración se convertirá en una tarea de configuración en lugar de un rescate de memoria.

Preguntas frecuentes

¿Cómo migro de OpenClaw a Hermes Agent?

Hermes proporciona hermes claw migrate, que importa una configuración de OpenClaw o del legado Clawdbot. Ejecútalo primero con --dry-run para obtener una vista previa del plan, luego aplícalo con el objetivo de tu espacio de trabajo configurado para que se coloque AGENTS.md.

¿Qué sucede con mis archivos de memoria diaria de OpenClaw?

La guía de migración de Hermes dice: "Todos los archivos diarios se fusionan en la memoria principal", lo que significa que se fusionan en ~/.hermes/memories/MEMORY.md junto con tu memoria a largo plazo, y luego se eliminan los duplicados.

¿Qué tan grande puede ser el MEMORY.md de Hermes?

Hermes documenta un límite de 2,200 caracteres para MEMORY.md y un límite menor para USER.md. El límite se puede configurar con memory_char_limit, y la memoria no se autocompacta cuando está llena.

¿La migración traslada mi proveedor de memoria externa?

Se archiva para revisión manual en lugar de aplicarse. Hermes guarda la configuración del backend de memoria en el archivo de migración y dice que se debe configurar con hermes honcho. Solo puede haber un proveedor externo activo en Hermes, junto con la memoria integrada.

¿Por qué Hermes no ve la memoria que acabo de importar?

Hermes inyecta la memoria como una instantánea congelada al inicio de la sesión. Su documentación dice que las habilidades importadas y las entradas de memoria surten efecto en las nuevas sesiones, así que inicia una nueva después de migrar.

¿Qué sucede con los archivos de latido (heartbeat) e identidad de OpenClaw?

Se archivan. Hermes sugiere fusionar IDENTITY.md en SOUL.md y usar tareas cron para las tareas periódicas que manejaba HEARTBEAT.md.