Si llevas tiempo corriendo OpenClaw, Hermes Agent es su sucesor. Mismo linaje del proyecto, los mismos maintainers, un renombre y un rediseño encima. El instalador de Hermes está hecho para reconocer eso — v0.14.0 trae un comando de primera clase, hermes claw migrate, que importa tu estado de OpenClaw de una pasada, con soporte de dry-run y presets explícitos.
Esta es la guía práctica de migración: qué se trae, qué flags hay, y el flujo de "primero dry-run" que te ahorra disgustos.
1. Instala Hermes Agent
El asistente de setup de Hermes detecta ~/.openclaw automáticamente y te ofrece migrar antes de empezar la configuración. La ruta más corta:
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes setup
Cuando el asistente ve tu directorio home de OpenClaw, pregunta si quieres migrar. Di que sí — pero si quieres ver exactamente qué se migraría primero, sales del asistente y lanzas el comando de migración directamente.
2. Previsualiza con --dry-run
Esto siempre primero. Enumera todo lo que el migrador importaría sin escribir nada a disco:
hermes claw migrate --dry-run
La salida se agrupa por categorías — SOUL.md, memorias, skills, lista blanca, configs de mensajería, API keys, archivos TTS. Léetela. Si algo te chirría (una API key vieja que no quieres migrar, un archivo de personalidad que ya superaste), saltas esa sección con un preset.
3. Elige un preset
Vienen dos por defecto:
- •
full(por defecto) — migra todo, secretos incluidos - •
user-data— migra todo excepto las API keys; los secretos los reintroduces tú a mano
¿Cambias de máquina y quieres romper limpio con los secretos? Usa user-data:
hermes claw migrate --preset user-data
¿Actualizas la misma máquina y quieres continuidad?
hermes claw migrate
4. Qué se trae
Según el README:
| OpenClaw | Destino en Hermes |
|---|---|
SOUL.md (persona) | importado tal cual |
Entradas de MEMORY.md y USER.md | importadas al memory de Hermes |
| Skills creados por el usuario | copiados a ~/.hermes/skills/openclaw-imports/ |
| Lista blanca de comandos (patrones de aprobación) | importada |
| Configs de mensajería (configs de plataforma, usuarios permitidos, directorio de trabajo) | importadas |
| API keys (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs) | importadas bajo el preset full |
| Archivos TTS (audios del workspace) | importados |
AGENTS.md del workspace | importado con --workspace-target |
Los skills de agentskills.io no se reinstalan solos — Hermes asume que vas a volver a darle un repaso al hub y a escoger lo que quieras vía hermes skills. Es a propósito: el renombre OpenClaw → Hermes también remodeló el hub de skills (v0.14.0 añadió huggingface/skills como tap por defecto de confianza), y una selección fresca queda más limpia que un traspaso al por mayor.
5. Maneja los conflictos
Si Hermes ya tiene configuración en esta máquina (por ejemplo, hiciste hermes setup antes de acordarte de que OpenClaw estaba ahí), el comando de migración se niega a sobrescribir por defecto. Dos opciones:
- •
--overwrite— sobrescribe la configuración de Hermes con los valores de OpenClaw - •Salta la categoría en conflicto con
--preset user-datasi el conflicto es en secretos
Usa --overwrite solo después de un --dry-run que confirme que los valores de OpenClaw son los que quieres.
6. Verifica
hermes doctor
Ejecuta el chequeo de salud post-instalación. Si memorias, skills, lista blanca o configs de plataforma no están donde deberían, aparecen errores concretos. Los arreglas, vuelves a correr, y sigues.
Alternativa: migración guiada por el agente
Si prefieres no tocar flags de CLI, Hermes incluye un skill openclaw-migration:
hermes
> /openclaw-migration
El skill te lleva por la misma migración de forma interactiva, con previsualizaciones --dry-run en cada paso.
Preguntas frecuentes
¿Pierdo mis datos de OpenClaw? No. El migrador copia — no mueve. Tu directorio ~/.openclaw queda intacto. Si algo va mal, puedes dar marcha atrás borrando ~/.hermes y seguir usando OpenClaw.
¿Puedo correr los dos? Brevemente. Comparten suposiciones sobre HOME y no esperan ser los dueños del mismo memory a la vez. Para operación dual prolongada, el puente comunitario HermesClaw se encarga de correr OpenClaw y Hermes en la misma cuenta de WeChat.
¿Se me rompen los skills? Los skills creados por el usuario se copian a ~/.hermes/skills/openclaw-imports/, así que sobreviven a la mudanza. Los skills que sacaste de agentskills.io están ligados al hub, no a tu instalación local — los vuelves a instalar vía hermes skills.
¿Dónde pido ayuda si algo falla? hermes doctor primero. Luego el Discord de Nous Research o los Issues de GitHub — ambos enlazados desde el README.