Migrar de OpenClaw a Hermes Agent: guía manual

Ya Tomaste La Decisión. Ahora Viene El Fin De Semana.

Ya lo decidiste. Quizá leíste la comparativa Hermes Agent vs OpenClaw y concluiste que el runtime de agente más enfocado encaja con la forma en que realmente trabajás. Quizá fue un compañero de equipo. En cualquier caso, la decisión quedó atrás. Lo que tenés delante es trabajo operativo real: llevar una instalación viva de OpenClaw, con meses de memoria acumulada y skills afinados, a una instalación limpia de Hermes Agent sin perder nada que importe.

Hermes incluye un comando oficial de migración. El paquete hermes-migrate se publicó el 10 de marzo de 2026 y el flujo hermes claw migrate está documentado para importar settings, memorias, skills, canales y API keys. Eso resuelve el camino feliz. Lo que no resuelve es el trabajo alrededor: aprovisionar un host, traducir la config de proveedor de la forma vieja de OpenClaw al esquema snake_case de Hermes, blindar los secretos en reposo, re-emparejar tu bot de Telegram y verificar de punta a punta antes de avisarle al equipo que el bot nuevo está vivo.

Esta guía recorre todo eso a mano para que sepas exactamente a qué te estás anotando. Al final hay una alternativa de 1 minuto.

Paso 1: Congelá Y Exportá Tu Estado De OpenClaw

No empieces instalando Hermes. Empezá haciendo que el lado de OpenClaw quede quieto.

La propia documentación de migración de OpenClaw te dice que detengas el gateway antes de copiar el estado, porque si no, el historial de conversaciones y las sesiones de canales escriben debajo tuyo. El directorio de estado por defecto es ~/.openclaw/, que contiene openclaw.json, settings del gateway, auth-profiles.json, credenciales de proveedores, sesiones, estado de canales para WhatsApp y Telegram, y tus archivos de workspace incluyendo MEMORY.md, USER.md, skills y prompts.

openclaw gateway stop
cd ~
tar -czf openclaw-state-$(date +%Y%m%d).tgz .openclaw
sha256sum openclaw-state-*.tgz

Si configuraste una ruta personalizada con OPENCLAW_STATE_DIR, o si corrés perfiles como ~/.openclaw-work o ~/.openclaw-personal, archivá cada uno por separado. La migración solo es tan completa como los directorios que te acuerdes de capturar, y el modo de fallo de olvidarte un perfil es silencioso: Hermes va a arrancar bien y simplemente no va a estar tu personalidad de fin de semana.

Copiá los archivos al host nuevo antes de tocar nada más. Si te lo saltás y la instalación en el host nuevo falla, vas a querer una vía de rollback limpia que no dependa de que la máquina vieja siga sana.

Paso 2: Aprovisioná Un Host E Instalá Hermes

Ahora necesitás un lugar donde Hermes viva. Las dos opciones realistas son un VPS chico o un host Docker local.

Para un VPS, una caja de 2 vCPU / 4 GB es un piso cómodo. Vas a pasar la próxima hora en las partes sobre las que nadie escribe posts: elegir una región cerca de tus usuarios de mensajería, endurecer SSH, configurar un firewall que solo permita los puertos que de verdad necesitás, instalar las actualizaciones de seguridad desatendidas y decidir si el agente corre como root (no debería) o como un usuario de servicio dedicado con un home bloqueado.

Para Docker local, el trabajo es distinto pero no más corto. Escribís un Compose file, decidís dónde viven los volúmenes de estado, decidís cómo se reinicia el contenedor cuando reinicia el host y resolvés cómo el contenedor llega al exterior sin exponer más de la cuenta.

Una vez que el host existe, instalá Hermes:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes setup

hermes setup va a buscar ~/.openclaw/ y va a ofrecer migrar. Si subiste tu tarball a otra ruta, extraelo primero para que el wizard lo encuentre.

Una terminal extrayendo un archivo de estado de OpenClaw en un servidor nuevo

Paso 3: Traducí La Config De Proveedor

Este es el paso donde la mayoría de las migraciones manuales se rompen en silencio.

Tanto OpenClaw como Hermes te permiten apuntar el agente a OpenAI, Anthropic, OpenRouter, vLLM, Ollama o un endpoint custom compatible con OpenAI. Los campos parecen iguales. No tienen la misma forma.

Hermes solo reconoce snake_case en la config de proveedor. Un apiKey o baseUrl editado a mano se descarta en silencio. Usá api_key y base_url. Cuando base_url está seteado, Hermes ignora el nombre del proveedor y llama a ese endpoint directamente usando api_key o la variable de entorno OPENAI_API_KEY para autenticarse.

El mapeo manual mínimo se ve así para cada proveedor que traigas:

| Campo OpenClaw | Campo Hermes | Notas | |---|---|---| | provider | provider | Usá el slug en minúsculas que Hermes espera (openai, anthropic, openrouter, ollama, vllm, custom) | | model | model | Mismo string, sin traducción | | apiKey | api_key | snake_case es obligatorio, camelCase se descarta | | baseUrl | base_url | snake_case es obligatorio, seteá solo si de verdad necesitás un endpoint custom | | apiMode | api_mode | Confirmá que Hermes todavía soporta el valor que usabas |

Repetí esto para cada proveedor que tengas configurado. Si corrés cadenas de fallback (uno principal más uno barato de respaldo), hacelos de a uno y probá cada uno antes de pasar al siguiente.

Paso 4: Portá Persona, Skills Y Memoria

OpenClaw guarda la persona en workspace/SOUL.md e IDENTITY.md, con carpetas opcionales por personalidad bajo personalities/, además de USER.md, MEMORY.md y archivos de memoria diarios. Los skills viven en el directorio de skills de tu workspace.

Una migración manual limpia es una decisión por archivo, no una copia de directorio. Abrí cada archivo de persona y confirmá:

La voz y las restricciones siguen coincidiendo con cómo querés que se comporte el agente nuevo.
Las referencias a herramientas específicas de OpenClaw (Control UI, nombres de plugins, comportamientos del gateway) están eliminadas o reformuladas.
Los nombres de skills no chocan con los skills de Hermes integrados, porque si no, la versión importada puede tapar o ser tapada sin aviso.

Después movelos al layout que Hermes espera:

~/.hermes/SOUL.md para persona
~/.hermes/memories/ para MEMORY.md, USER.md y archivos diarios
~/.hermes/skills/openclaw-imports/ para skills, con la resolución de conflictos hecha a mano

Los archivos de memoria son donde la mayoría de los equipos subestima el trabajo. Después de un año de uso de OpenClaw, MEMORY.md puede tener cientos de entradas que mezclan contexto de proyectos obsoletos con datos todavía relevantes. La migración es el momento correcto para deduplicar y podar, no para copiar a ciegas.

Paso 5: Asegurá Tus Secretos

Este paso no tiene atajo. Hermes guarda credenciales en ~/.hermes/, con tokens de auth sensibles en rutas como ~/.hermes/auth/google_oauth.json usando chmod 0600, escrituras atómicas y locks de archivo entre procesos. Eso es el piso, no el techo.

Una migración manual que se tome los secretos en serio necesita:

Un inventario claro de cada API key que estás trayendo, con rotación al momento de migrar para que cualquier clave filtrada durante tu período de OpenClaw quede invalidada.
Permisos sobre ~/.hermes/.env en 0600, propiedad del usuario de servicio, nunca legibles por otras cuentas del host.
Cifrado en reposo del volumen donde vive ~/.hermes/, sobre todo si el host es un VPS compartido.
Backups fuera del host, que también estén cifrados, con un procedimiento de restauración probado, porque un backup que nunca restauraste no es realmente un backup.
Listas documentadas de quién y qué puede leer estos archivos, para que la próxima persona de guardia no tenga que adivinar.

Si te saltás el paso de rotación, no migraste tu postura de seguridad: solo la mudaste de lugar.

Paso 6: Re-emparejá Telegram Y Probá De Punta A Punta

Telegram es el canal de Hermes más común y el más fácil de romper en el camino. Necesitás el token del bot, la lista de usuarios permitidos y cualquier setting específico del canal como IDs de grupo o flags de admin-only. Hermes los lee de variables de entorno en ~/.hermes/.env. Después de importar, hay que reiniciar el gateway antes de que el bot empiece a responder.

hermes status
hermes gateway restart

Si nunca desplegaste Hermes en Telegram, la guía de despliegue de Hermes Agent en Telegram cubre la creación del bot y el detalle del webhook. Una vez que el gateway está arriba de nuevo, hacé una prueba de punta a punta desde el cliente real de Telegram, no desde hermes status. Mandá un mensaje que ejercite la recuperación de memoria, uno que ejercite un skill migrado y uno que ejercite tu cadena de proveedores. Si alguno de los tres falla, arreglalo antes de avisar a alguien que la migración terminó.

Paso 7: Troubleshooting De Los Sospechosos De Siempre

Realistamente, vas a pegarle al menos a uno de estos. Planeá para eso.

Conflictos de puerto: el gateway de OpenClaw y el gateway de Hermes pelean por un puerto. Si los co-localizaste durante las pruebas, parar OpenClaw primero.
Errores de auth de proveedor: casi siempre es un error de snake_case o una clave vencida. Re-chequeá api_key y base_url, después hermes status.
Skills faltantes o incompatibles: los skills importados a veces referencian herramientas que solo existen en OpenClaw. Leé el skill que falla y reescribilo o eliminalo.
Codificación de memoria: si tu MEMORY.md viene de una instalación de OpenClaw en Windows con saltos de línea CRLF, pasalo por dos2unix antes de copiarlo.
Drift de persona: el agente se siente distinto aunque el archivo de persona sea idéntico. Verificá que no estés cargando dos archivos de persona a la vez y que ningún persona por defecto de Hermes esté tapando el tuyo.

Si algo funciona en hermes status pero no en Telegram, el problema casi siempre es el gateway, no el agente.

O Hacé Todo Esto En Menos De 1 Minuto Con Hermify

Volvé a leer las últimas siete secciones. Eso es entre un fin de semana enfocado y una semana desenfocada de noches, según qué tan limpia estuviera tu instalación de OpenClaw cuando empezaste.

Hermify incluye un wizard de migración de OpenClaw de un click dentro del dashboard que hace el mismo trabajo sin el fin de semana. Subís tu export de OpenClaw, el wizard te muestra una vista previa de la migración con conteos de persona, skills, memorias, secretos, proveedores y Telegram antes de aplicar nada, y el paso de aplicar escribe todo en una instalación gestionada de Hermes con los secretos cifrados en reposo. No hay host que aprovisionar, no hay traducción de snake_case que recordar, no hay script de backup que escribir.

El artículo que acabás de leer es lo que el wizard corre por debajo. Si el camino manual es la experiencia que querés, los pasos de arriba son precisos y completos. Si lo que querés es el resultado, el wizard te lleva ahí en cerca de un minuto.

Empezá con Hermify y migrá desde OpenClaw antes del fin de semana que pensabas dedicarle.