Cómo migrar de OpenClaw a Hermes Agent sin perder memoria ni skills

29 de julio del 202611 minOpenClaw, Hermes Agent, Nous Research, IA, Tutorial

Respuesta corta (60 segundos): la migración es preview → aplicar → verificar → limpiar. (1) Instalá y verificá Hermes Agent en la misma máquina donde ya corre OpenClaw. (2) Previsualizá con hermes claw migrate --dry-run para ver qué importará sin tocar nada. (3) Aplicá la migración con hermes claw migrate (o la variante opt-in hermes claw migrate --preset full --migrate-secrets --yes si querés un viaje completo que también lleve API keys sin prompts). (4) Verificá con hermes doctor, hermes status y hermes config show, más una sesión nueva que ya vea las skills importadas. (5) Revisá canales (incluido el re-emparejado de WhatsApp con QR) y los archivos archivados. (6) Recién después de validar todo, pará OpenClaw con openclaw gateway stop, previsualizá la limpieza con hermes claw cleanup --dry-run, y recién entonces corré hermes claw cleanup. Para un borrado total de OpenClaw al final, seguí la guía de desinstalación.

Si corrés OpenClaw hace un tiempo y querés pasarte a Hermes Agent sin perder ni memoria ni skills, hay un comando oficial: hermes claw migrate. Lee de ~/.openclaw/ (con fallback a ~/.clawdbot/ y ~/.moltbot/), importa todo lo compatible y deja archivado lo que no tiene equivalente. Esta guía es la versión corta, sin olores, de la guía oficial de migración, con foco en qué se lleva solo, qué queda archivado, y cómo validar antes de tocar nada importante.

Qué migra automáticamente

La tabla resume, por área, qué toma hermes claw migrate desde tu instalación de OpenClaw y dónde lo deja en Hermes. Los flags importantes son --preset full (todo compatible) o --preset user-data (excluye infra). Ningún preset importa secretos solo: si querés API keys y tokens, agregá --migrate-secrets.

Qué no migra automáticamente

Lo que sigue se archiva bajo ~/.hermes/migration/openclaw/<timestamp>/archive/ para revisión manual. Son piezas que en Hermes se construyen con otros comandos o no tienen equivalente directo.

Además hay dos plataformas que requieren acción manual: WhatsApp (re-emparejar por QR con hermes whatsapp) y cualquier token que en OpenClaw use source: file o source: exec como SecretRef — la migración avisa sobre estos y los deja sin resolver.

Paso 1 · Instalar y verificar Hermes

Antes de mover nada, asegurate de tener Hermes Agent funcionando en la misma máquina y con hermes --version verde. La guía completa de instalación (Linux, macOS, WSL2, Android, Windows nativo, paths sin sudo) está acá:

~

# Después de instalar Hermes, confirmá el binario y el Gateway
hermes --version
hermes doctor

Si ya lo tenés instalado y actualizado, podés saltearte a la previsualización. Si no, instalá Hermes Agent y volvé. Tener los dos corriendo en paralelo es exactamente lo que querés durante la transición.

Paso 2 · Previsualizar la migración

Antes de tocar nada, mirá qué va a hacer el comando. La previsualización lee todo el state de OpenClaw, busca skills, providers, canales y memoria, y te imprime el plan completo sin escribir nada:

~

# Previsualizar la migración sin modificar nada
hermes claw migrate --dry-run

Por default lee de ~/.openclaw/. Si tu instalación vive en otro lado (por ejemplo, un profile custom o un contenedor), pasale la ruta explícita:

~

# Fuente en una ruta custom (ej. profile o contenedor)
hermes claw migrate --dry-run --source /ruta/a/openclaw

El preview te muestra: archivos a copiar, skills a importar, providers y canales detectados, secretos que no se van a copiar (por default), y conflictos. Revisalo con cuidado: si hay algo que no querés tocar, ajustalo antes de aplicar.

Paso 3 · Ejecutar la migración

Una vez que el preview te cierra, aplicá la migración:

~

# Aplicar la migración (vuelve a mostrar el preview y pide confirmación)
hermes claw migrate

Si querés un camino completo en una sola corrida — incluyendo API keys y sin prompts — usá esta variante opt-in. Cuidado: lleva secretos, leelos dos veces antes de correrlo:

~

# Camino opt-in completo (incluye API keys, sin confirmación)
#   --preset full: importa todo lo compatible
#   --migrate-secrets: también API keys y tokens (allowlist estricto)
#   --yes: salta el prompt de confirmación
hermes claw migrate --preset full --migrate-secrets --yes

Flags útiles si tu situación lo amerita:

• --workspace-target /ruta: a dónde va AGENTS.md (necesario para copiar las instrucciones del workspace).
• --overwrite: fuerza pisar archivos de Hermes que entren en conflicto. Sin este flag, la migración se niega a aplicar si hay conflictos.
• --no-backup: saltea el snapshot pre-migración en ~/.hermes/backups/pre-migration-*.zip. Por default se escribe siempre un restore point antes de aplicar.
• --skill-conflict skip | overwrite | rename: cómo resolver skills duplicadas. rename deja la importada con sufijo -imported en el basename (p. ej. mi-skill → mi-skill-imported).

Paso 4 · Verificar Hermes

Después de aplicar, lo crítico es validar que Hermes quedó funcional. Cuatro comandos, en este orden:

~

# 1) Chequeo completo de config y deps
hermes doctor

# 2) Autenticación con los providers migrados
hermes status

# 3) Config efectiva: revisá session_reset, terminal.cwd, model, providers
hermes config show

Después de los chequeos, arrancá una sesión nueva (las skills importadas y los memory entries toman efecto en sesiones nuevas, no en la actual):

~

# 4) Sesión nueva: acá deberían aparecer las skills importadas
hermes

Si algo no aparece, hermes config show te dice qué keys efectivamente quedaron seteadas. Si falta una API key, agregala con hermes config set OPENROUTER_API_KEY tu_key (o la variable que corresponda). /skills te lista las skills cargadas.

Paso 5 · Revisar canales y archivos archivados

Los tokens de los canales quedan en ~/.hermes/.env, pero el Gateway no los recarga solo. Reinicialo:

~

# Reiniciar el Gateway para que tome los tokens migrados
systemctl --user restart hermes-gateway

Si usás WhatsApp, la migración no puede llevarse la sesión (WhatsApp usa QR pairing con Baileys, no token). Quedó guardado el WHATSAPP_ALLOWED_USERS para que mantenga la lista blanca, pero hay que re-emparejar:

~

# Re-emparejar WhatsApp con QR después de migrar
hermes whatsapp

Para todo lo que no migra automáticamente (cron, plugins, hooks, multi-agent, channel bindings, IDENTITY.md, TOOLS.md, HEARTBEAT.md, etc.), revisá el directorio:

~

# Archivos archivados para revisión manual
ls -la ~/.hermes/migration/openclaw/$(ls -t ~/.hermes/migration/openclaw/ | head -1)/archive/

Cada carpeta adentro (workspace/, cron-config.json, plugins-config.json, hooks-config.json, bindings.json, etc.) corresponde a la columna "Cómo recrearlo en Hermes" de la tabla de arriba. Recreá lo que necesites desde la columna correspondiente.

Paso 6 · Limpiar solo después de validar

La limpieza se hace al final y solo cuando todo lo anterior esté verde. El flujo:

1. Pará el Gateway de OpenClaw para que no siga procesando: openclaw gateway stop.
2. Previsualizá qué va a renombrar la limpieza de Hermes.
3. Aplicá la limpieza: renombra los directorios de OpenClaw a .pre-migration/ para evitar confusión de state entre los dos agentes.

~

# 1) Parar OpenClaw para que no compita con Hermes
openclaw gateway stop

# 2) Previsualizar qué va a renombrar la limpieza de Hermes
hermes claw cleanup --dry-run

# 3) Aplicar la limpieza (renombra dirs de OpenClaw a .pre-migration/)
hermes claw cleanup

Si querés borrar OpenClaw por completo (CLI + Gateway + state + workspace + app), seguí la guía de desinstalación de OpenClaw después de la limpieza. No borres OpenClaw antes de validar que Hermes está estable.

Troubleshooting

Los cuatro errores más comunes durante una migración, con la solución exacta.

Si tu caso es más raro (instalación en contenedor, Nix, Docker, perfil multi-agent), la guía oficial de migración tiene secciones de edge cases que exceden este recorrido.

¿Tenés un setup puntual (multi-agent, custom providers, varios canales) y querés validar el plan antes de ejecutar la migración? Hay un CTA al final con una llamada gratis de 30 minutos.