Asistente de IA Hermes: instalación, configuración, flujo de trabajo y solución de problemas

Hermes Agent es un asistente de IA autoalojado, agnóstico de modelos, que se ejecuta en una máquina local o en un VPS de bajo coste, funciona a través de interfaces de terminal y mensajería, y mejora con el tiempo al convertir tareas repetidas en habilidades reutilizables.

Es muy similar en funcionalidad a OpenClaw, otro pila de asistentes autoalojados construido en torno a herramientas, memoria y control local. Muchos desarrolladores encontraron su camino hacia Hermes después de que Anthropic bloqueara el acceso por suscripción de Claude de OpenClaw en abril de 2026; la cronología del ascenso y caída de OpenClaw explica por qué Hermes surgió como el destino natural para los usuarios que querían automatización persistente y autoalojada sin la dependencia del proveedor.

Si quieres una visión más amplia de los asistentes autoalojados, la recuperación y la infraestructura local alrededor de Hermes, esta visión general de sistemas de IA vincula esos temas con los mismos problemas que Hermes intenta resolver. Para el modelo de asistente de cinco capas: LLM, memoria, herramientas, enrutamiento y observabilidad, con Hermes y OpenClaw como implementaciones de referencia, consulta la Arquitectura de Asistente de IA. Para datos concretos de adopción: estrellas de GitHub, volumen diario de tokens de OpenRouter, recuentos de descargas de PyPI, historial de CVE y sentimiento de la comunidad en Reddit, OpenClaw vs Hermes Agent: Estrellas, Descargas y Uso 2026 sigue cómo se compara Hermes con 19 alternativas en todas las señales medibles.

Para las compensaciones de despliegue y las opciones de tiempo de ejecución, Alojamiento de LLM en 2026: Infraestructura Local, Autoalojada y en la Nube Comparada proporciona el mapa de alojamiento, mientras que Rendimiento de LLM en 2026: Benchmarks, Cuellos de Botella y Optimización cubre el lado del rendimiento y la latencia una vez que Hermes está en funcionamiento. Si apuntas rutinariamente a Hermes hacia Qwen o Gemma en tiempos de ejecución locales como Ollama, consolida los presets de temperatura y penalización para el uso de herramientas en múltiples pasos con Parámetros de inferencia agéntica de LLM para Qwen y Gemma. Para un mapa compacto de comandos de shell (hermes gateway, hermes memory, hermes doctor, accesos directos de barra diagonal y más), usa la hoja de referencia de CLI de Hermes Agent. Si tu punto de entrada principal es la mensajería en el móvil, usa Control por Voz de Hermes desde tu Teléfono para la pila de voz y la configuración específica de la plataforma.

Mi opinión sesgada: Hermes es más interesante cuando se trata como infraestructura, no como una pestaña que abres ocasionalmente. Una vez que se ejecuta como servicio y tiene un directorio de inicio estable, tus prompts empiezan a parecer menos “chat” y más “operaciones”.

Qué es Hermes Agent y por qué importa

Hermes Agent es un agente de IA de código abierto creado por Nous Research. Está diseñado para ejecutarse de forma persistente, usar herramientas (terminal, archivos, web y más) y mejorar su propio comportamiento con el tiempo mediante un sistema de habilidades y memoria.

Dos decisiones de diseño merecen ser explicadas porque dan forma a todo lo demás en esta guía.

Primero, Hermes no está bloqueado a un solo proveedor de modelos. El flujo de configuración oficial admite múltiples proveedores y cualquier punto final compatible con OpenAI, y el cambio se realiza mediante el comando hermes model en lugar de ediciones de código.

Segundo, Hermes traza una línea dura entre “conversación” y “ejecución”. El agente puede hablar todo el día, pero cuando necesita actuar, lo hace a través de herramientas explícitas y un backend de ejecución configurable. Es ahí donde residen la seguridad, la reproducibilidad y la solución de problemas.

Los costes y la licencia son refrescadamente aburridos. El propio Hermes Agent es software gratuito bajo la licencia MIT. Si usas modelos alojados, el coste continuo es lo que tu proveedor cobre. Si ejecutas modelos locales, puedes evitar por completo las tarifas de API.

Si tu configuración de Hermes usa Claude a través de capas de herramientas externas, este cambio de suscripción de Anthropic es una referencia útil sobre por qué la facturación basada en API es ahora la vía esperada.

Instalar Hermes Agent

Hermes tiene una vía de instalación rápida para Linux, macOS y WSL2. La documentación oficial lo mantiene intencionalmente simple.

Instalación de Hermes en Linux

sudo apt-get update
sudo apt-get upgrade
sudo apt-get curl git
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Después de la instalación, recarga tu shell y inicia la CLI.

source ~/.bashrc   # o source ~/.zshrc
hermes

El instalador no es solo un envoltorio delgado. Según la guía de instalación, configura dependencias, el repositorio, un entorno virtual y el comando hermes, llevándote a un primer estado listo para el chat.

Si llegas desde un despliegue existente de OpenClaw en lugar de comenzar desde cero, instala y valida un Hermes vacío primero, luego sigue el cambio escalonado en Cómo Migrar de OpenClaw a Hermes Agent de Forma Segura — hermes claw migrate mapea persona, memoria, habilidades, proveedores y servidores MCP, pero los trabajos cron, los plugins y el enrutamiento multiagente tienen que reconstruirse a mano.

Notas para Windows y Android

Windows nativo no está soportado. La documentación recomienda WSL2 y ejecutar Hermes dentro de él.

Para Android, Hermes soporta una vía de instalación en Termux. Está diseñado para detectar Termux y adaptar su configuración de dependencias y entorno en consecuencia.

Inicio rápido

La primera ejecución más rápida es literalmente solo hermes, pero un inicio rápido significativo significa dos decisiones adicionales: qué proveedor de modelo usar y qué herramientas deben habilitarse.

Elige un proveedor y un modelo

Hermes expone tres puntos de entrada complementarios:

• hermes model para elegir un proveedor y un modelo predeterminado
• hermes tools para habilitar o deshabilitar juegos de herramientas
• hermes setup para ejecutar un asistente interactivo en las principales áreas de configuración

Un flujo minimalista se ve así:

hermes model
hermes tools
hermes

En cuanto a lo que se admite realmente, el Inicio Rápido oficial lista una serie de proveedores y también señala que Hermes funciona con APIs compatibles con OpenAI. Esto es importante porque incluye tanto servicios alojados como puntos finales autoalojados.

Demuestra la ejecución de herramientas temprano

Antes de crear hábitos alrededor de Hermes, vale la pena verificar que el uso de herramientas funcione en tu entorno. El Inicio Rápido sugiere explícitamente el uso de terminal como primera característica a probar.

En la práctica, un pequeño prompt de “prueba de humo” realiza dos trabajos: verifica la herramienta de terminal y valida las solicitudes de permisos.

Ejemplo de prompt:

Muestra mi uso de disco y los cinco directorios más grandes.

Si Hermes no puede ejecutar la herramienta de terminal, salta a Solución de Problemas. La mala configuración del backend de terminal es una de las causas más comunes y la solución suele ser obvia una vez que miras la configuración.

Configuración que escala

Hermes premia a quienes entienden dónde almacena su estado y cómo resuelve la configuración. Aquí es también donde surgen muchos problemas de “funcionaba ayer”.

Dónde residen la configuración y el estado

Hermes almacena sus ajustes y estado bajo ~/.hermes. La guía de configuración oficial documenta el layout, incluyendo config.yaml para ajustes, .env para secretos, auth.json para credenciales de OAuth, SOUL.md para identidad y carpetas para memorias, habilidades, cron, sesiones y registros.

Esto importa por dos razones.

• La depuración se vuelve mecánica porque sabes exactamente dónde buscar.
• Las copias de seguridad se vuelven directas porque un directorio captura la mayor parte del estado del agente que te importa.

Precedencia de configuración y mantener secretos fuera de config.yaml

Hermes resuelve la configuración con un orden de precedencia. En la parte superior están las anulaciones de CLI, luego config.yaml, luego .env, con valores predeterminados integrados en la parte inferior.

El detalle agradable es que hermes config set enruta los valores al archivo correcto: claves de API a .env y ajustes no secretos a config.yaml.

hermes config set model openrouter/meta-llama/llama-3.1-70b-instruct
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-v1-xxxxxxxx

Hermes también soporta la sustitución de variables de entorno dentro de config.yaml mediante la sintaxis ${VAR_NAME}. Esto es útil cuando quieres mantener ciertos valores en el entorno mientras aún los referencias en la configuración estructurada.

Sandbox y backends de ejecución

Hermes soporta múltiples backends de terminal que definen dónde se ejecutan realmente los comandos de shell. La guía de configuración lista local, docker, ssh, modal, daytona y singularity.

La manera opinada pero no evangelizadora de pensar en esto es:

• local es el más rápido y simple, pero no está aislado
• docker es una capa pragmática de seguridad y reproducibilidad
• ssh es una manera limpia de separar tu dispositivo de chat de tu caja de cómputo
• modal y daytona encajan en flujos de trabajo “serverless pero lo suficientemente persistentes”
• singularity es la opción amigable con HPC

Un ejemplo minimalista de un backend Docker:

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker_image: "nikolaik/python-nodejs:python3.11-nodejs20"
  docker_volumes:
    - "/home/user/projects:/workspace/projects"
  docker_forward_env:
    - "GITHUB_TOKEN"

La documentación también describe el endurecimiento de seguridad para el backend Docker, como eliminar capacidades y deshabilitar la escalada de privilegios.

Habilidades, memoria y perfiles

Hermes tiene dos mecanismos relacionados para acumular valor.

Las habilidades son memoria procedural. Hermes puede crear, actualizar y eliminar sus propias habilidades y puede ofrecer guardar un enfoque como habilidad después de completar una tarea compleja.

La memoria integrada se almacena como archivos como MEMORY.md y USER.md bajo ~/.hermes, y Hermes también puede usar proveedores de memoria externos para un recuerdo más profundo. La documentación de memoria lista varios plugins de proveedores, y la guía de proveedores de memoria documenta un flujo de configuración interactivo. Para un desglose técnico completo de cómo funciona la arquitectura de memoria: instantáneas congeladas, límites de caracteres, los proveedores externos y la filosofía detrás de la memoria acotada, consulta Sistema de Memoria de Hermes Agent: Cómo Funciona la Memoria Persistente de IA. Si quieres un proveedor local y autoalojado con un control inusualmente granular sobre lo que se escribe automáticamente, consulta Mnemosyne para Hermes Agent: Inicio Rápido de Memoria Local y Bucles de Memoria Autorreforzada en Agentes de IA sobre por qué los valores predeterminados de escritura conservadores importan en primer lugar.

Si quieres múltiples agentes independientes en la misma máquina, los perfiles de Hermes proporcionan aislamiento. Cada perfil obtiene su propio directorio con su propia configuración, secretos, memorias, sesiones, habilidades, trabajos cron y estado del gateway.

Para una mirada más profunda a qué habilidades funcionan bien en producción por rol: ingenieros, investigadores, operadores y flujos de trabajo ejecutivos, consulta Habilidades de Asistente de IA Hermes para Configuraciones de Producción Reales. Cuando estés listo para autor o depurar archivos SKILL.md mismos: metadatos YAML, niveles de divulgación progresiva, visibilidad condicional e instalaciones de hub, usa Autorización de Habilidades en Hermes Agent — Estructura y Mejores Prácticas de SKILL.md.

Flujo de trabajo típico

Si tratas a Hermes como un agente que mantendrás alrededor, el flujo de trabajo empieza a parecer ingeniería de servicios.

Una línea base estable

Una línea base que tiende a no pudrirse es:

1. Instala y ejecuta un primer chat en la CLI.
2. Elige un proveedor y un modelo con hermes model, luego confirma los costes.
3. Configura los juegos de herramientas y decide si la ejecución de terminal es local o en sandbox.
4. Haz un cambio rápido en SOUL.md solo después de haber usado el predeterminado durante un tiempo. Los cambios de identidad importan más de lo que la gente espera porque es el “slot 1” en el prompt del sistema.

Uso diario que acumula

Hermes tiene una interfaz de usuario de terminal en lugar de una interfaz de usuario web, y está diseñado para sesiones largas con comandos de barra diagonal, sesiones reanudables y salida de herramientas en streaming. Las banderas de shell, subcomandos y accesos directos de barra diagonal para esa sesión están en la hoja de referencia de CLI de Hermes Agent.

En la práctica, una cadencia útil es:

• ejecutar trabajo en una sesión con nombre para un proyecto
• comprimir el contexto cuando crece demasiado
• dejar que Hermes convierta rutinas repetidas en habilidades
• mantener una frontera mental entre “preguntar” y “actuar” para que la ejecución de herramientas siga siendo auditable

Gateway de mensajería para acceso 24/7

El gateway de mensajería es la pieza que hace que Hermes se sienta como un asistente en lugar de una aplicación de terminal. La documentación lo describe como un solo proceso que se conecta a múltiples plataformas, maneja sesiones, ejecuta trabajos cron y entrega mensajes.

La configuración se invoca mediante hermes gateway setup, y el gateway puede ejecutarse en primer plano o como servicio de usuario. La referencia de CLI documenta subcomandos de gateway como run, install, start, stop, status y restart. Si quieres que este modelo de gateway se ejecute en un servidor dedicado mientras te conectas desde un cliente de escritorio separado, usa Servidor Headless y Configuración de Escritorio Remoto de Hermes Agent.

Para retrocesos multiagente y programación controlada, consulta Kanban en Hermes Agent para Flujos de Trabajo de LLM Autoalojados, que cubre límites de despachador, cadenas de dependencia y loteo basado en cron.

La seguridad para un bot que usa herramientas importa. La documentación del gateway describe listas de permitidos para plataformas específicas y un flujo de emparejamiento de DM que emite códigos de emparejamiento de un solo uso y requiere aprobación mediante hermes pairing approve.

Actualizaciones sin drama

Las actualizaciones de Hermes son un comando de primera clase. La guía de actualización documenta hermes update, comprobaciones de migración de configuración y una pequeña rutina de validación posterior a la actualización que incluye hermes doctor y hermes gateway status.

hermes update
hermes doctor
hermes gateway status

Solución de problemas y diagnósticos

La mayoría de los fallos de Hermes no son misteriosos. Se ven misteriosos porque la gente solo comprueba la capa del modelo e ignora la capa de tiempo de ejecución.

Comandos de triaje rápido

La referencia de CLI posiciona explícitamente tres comandos como el bucle central:

• hermes doctor para diagnósticos interactivos
• hermes status para una visión general rápida
• hermes dump para un resumen de configuración compartible y redactado

Para los registros, hermes logs hace cola de archivos almacenados bajo ~/.hermes/logs.

hermes doctor --fix
hermes status
hermes dump --show-keys
hermes logs errors -f

Fallos de instalación comunes

La FAQ y la guía de solución de problemas enumeran varios problemas recurrentes y sus soluciones, incluyendo problemas de versión de Python, uv no encontrado y problemas de permisos causados por mezclar instalaciones con sudo con instalaciones de usuario.

Si encuentras estos errores, la documentación proporciona pasos de remediación específicos como actualizar Python, instalar uv y reinstalar Hermes sin sudo.

Problemas de proveedor y modelo

Cuando las claves de API no funcionan, la FAQ recomienda revisar la configuración, volver a ejecutar hermes model o establecer una clave directamente mediante hermes config set. También señala un error común: las claves son específicas del proveedor.

Para problemas de “modelo no encontrado”, la FAQ señala de nuevo el uso de hermes model para elegir un identificador válido y muestra tanto anulaciones de configuración como de sesión individual.

También se cubren los problemas de limitación de tasa y longitud de contexto. La FAQ sugiere esperar a errores 429, cambiar de proveedor o modelo, y reducir la presión de contexto mediante compresión o una sesión nueva.

Problemas de backend de terminal y gateway

Si los comandos de terminal fallan inmediatamente, la guía de configuración incluye una sección de “problemas comunes de backend de terminal” y señala a las causas típicas por backend, incluyendo Docker no ejecutándose y variables SSH faltantes. También señala que volver a local es una válida de depuración cuando la configuración del sandbox está en cuestión.

Para problemas de gateway, la guía de mensajería destaca las listas de permitidos y el emparejamiento como los valores predeterminados seguros, lo que significa que muchos incidentes de “el bot está en silencio” son en realidad la autorización haciendo su trabajo.

Referencias

• Página de Inicio de Hermes Agent
• Sistema de Memoria de Hermes Agent: Cómo Funciona la Memoria Persistente de IA
• Habilidades de Asistente de IA Hermes para Configuraciones de Producción Reales