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

El Agente Hermes es un asistente de IA autoalojado y agnóstico de modelo 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 convirtiendo las tareas repetitivas en habilidades reutilizables.

Es muy similar en funcionalidad a OpenClaw, otra pila de asistente autoalojada construida alrededor de herramientas, memoria y control local. Muchos desarrolladores encontraron su camino hacia Hermes después de que Anthropic bloqueara el acceso a la 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 los 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 Arquitectura de Asistentes de IA. Para datos concretos de adopción (estrellas de GitHub, volumen diario de tokens de OpenRouter, conteos de descargas de PyPI, historial de CVE y sentimiento de la comunidad en Reddit), OpenClaw vs Hermes Agent: Estrellas, descargas y uso en 2026 rastrea cómo se compara Hermes con 19 alternativas en cada señal medible.

Para las compensaciones de despliegue y las elecciones de tiempo de ejecución, Alojamiento de LLMs en 2026: Infraestructura local, autoalojada y en la nube comparada proporciona el mapa de alojamiento, mientras que Rendimiento de LLMs en 2026: Benchmarks, cuellos de botella y optimización cubre el lado del ancho de banda y la latencia una vez que Hermes está en funcionamiento. Si habitually diriges Hermes hacia Qwen o Gemma en tiempos de ejecución locales como Ollama, consolida los preajustes de temperatura y penalización para el uso de herramientas de múltiples pasos con Parámetros de inferencia de LLMs agénticos para Qwen y Gemma. Para un mapa compacto de comandos de shell (hermes gateway, hermes memory, hermes doctor, atajos de barra espaciadora y más), usa la hoja de trucos de la 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](https://www.glukhov.org/es/ai-systems/hermes/hermes-voice-control/ “Configura el control por voz de Hermes en Telegram y Discord usando Whisper local y Edge TTS gratuito. Incluye configuración, consejos de ajuste, ejemplos y solución de problemas.”} 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 un servicio y tiene un directorio de inicio estable, tus prompts empiezan a parecerse menos al “chat” y más a las “operaciones”.

Qué es el Agente Hermes y por qué es importante

El Agente Hermes es un agente de IA de código abierto creado por Nous Research. Está diseñado para funcionar de manera 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 destacadas 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 soporta múltiples proveedores y cualquier punto de extremo 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. Ahí es donde residen la seguridad, la reproducibilidad y la solución de problemas.

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

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

Instalación de Hermes Agent

Hermes tiene un camino de instalación rápido 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 install 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 fino. Según la guía de instalación, establece las dependencias, el repositorio, un entorno virtual y el comando hermes, y luego te lleva a un estado inicial listo para el chat.

Si llegas desde una implementación existente de OpenClaw en lugar de empezar desde cero, instala y valida primero un Hermes vacío, y luego sigue el cambio por etapas en Cómo migrar de OpenClaw a Hermes Agent de forma segura — hermes claw migrate mapea la persona, la memoria, las habilidades, los proveedores y los servidores MCP, pero los trabajos cron, los plugins y el enrutamiento multiagente deben 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 un camino de instalación de 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 implica dos decisiones adicionales: qué proveedor de modelos 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 conjuntos de herramientas
• hermes setup para ejecutar un asistente interactivo en las principales áreas de configuración

Un flujo mínimo se ve así:

hermes model
hermes tools
hermes

En términos de lo que se soporta realmente, el Inicio Rápido oficial lista una serie de proveedores y también destaca que Hermes funciona con APIs compatibles con OpenAI. Eso es importante porque incluye tanto servicios alojados como puntos de extremo autoalojados.

Demuestra la ejecución de herramientas pronto

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 la terminal como una primera característica para probar.

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

Prompt de ejemplo:

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

Si Hermes no puede ejecutar la herramienta de terminal, salta a la sección de 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 recompensa a las personas que entienden dónde almacena su estado y cómo resuelve la configuración. Aquí es también de donde provienen 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 OAuth, SOUL.md para la 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 mirar.
• Las copias de seguridad se vuelven straightforward porque un solo 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 la CLI, luego config.yaml, luego .env, con los valores predeterminados integrados en la parte inferior.

El detalle agradable es que hermes config set enruta los valores al archivo correcto: las claves de API a .env y los 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.

Sandboxes 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 opinionada pero no evangelizadora de pensar en esto es:

• local es la más rápida y simple, pero no está aislada
• docker es una capa pragmática de seguridad y reproducibilidad
• ssh es una manera limpia de separar tu dispositivo de chat de tu máquina 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 mínimo 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 la eliminación de capacidades y la deshabilitación de 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 recordatorio más profundo. La documentación de memoria lista varios plugins de proveedor, 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 realmente 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 autorreforzados en agentes de IA para saber por qué importan los valores predeterminados de escritura conservadores.

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 del Asistente de IA Hermes para Configuraciones Reales de Producción. Cuando estés listo para crear o depurar archivos SKILL.md (metadatos YAML, niveles de divulgación progresiva, visibilidad condicional e instalaciones de hub), usa Autoría de Habilidades en Hermes Agent — Estructura de SKILL.md y Mejores Prácticas.

Flujo de trabajo típico

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

Una línea base estable

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

1. Instala y ejecuta un primer chat en la CLI.
2. Elige un proveedor y un modelo con hermes model, y luego confirma los costes.
3. Configura los conjuntos de herramientas y decide si la ejecución de la terminal es local o en un 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 la “posición 1” en el prompt del sistema.

Uso diario que compila valor

Hermes tiene una interfaz de usuario de terminal en lugar de una interfaz web, y está diseñada para sesiones largas con comandos de barra espaciadora, sesiones reanudables y salida de herramientas en streaming.

En la práctica, un ritmo útil es:

• ejecutar trabajo en una sesión con nombre para un proyecto
• comprimir el contexto cuando crece demasiado
• dejar que Hermes convierta las rutinas repetidas en habilidades
• mantener un límite mental entre “preguntar” y “actuar” para que la ejecución de herramientas se mantenga 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 app 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 un servicio de usuario. La referencia de la CLI documenta subcomandos del gateway como run, install, start, stop, status y restart. Si quieres que este modelo de gateway funcione en un servidor dedicado mientras te conectas desde un cliente de escritorio separado, usa Configuración de Servidor Headless y Escritorio Remoto para Hermes Agent.

Para colas de trabajo multiagente y programación controlada, consulta Kanban en Hermes Agent para Flujos de Trabajo de LLMs Autoalojados, que cubre los límites del despachador, las cadenas de dependencia y el 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 mensajes directos que emite códigos de emparejamiento de un solo uso y requiere aprobación mediante hermes pairing approve.

Actualizaciones sin dramas

Las actualizaciones de Hermes son un comando de primera clase. La guía de actualización documenta hermes update, las 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. Parecen 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 la CLI posiciona explícitamente tres comandos como el ciclo principal:

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

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 lista 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 te encuentras con 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 comprobar la configuración, volver a ejecutar hermes model o configurar una clave directamente mediante hermes config set. También destaca un error común: las claves son específicas del proveedor.

Para los problemas de “modelo no encontrado”, la FAQ apunta a usar hermes model para elegir un identificador válido y muestra tanto anulaciones de configuración como por sesión.

También se abordan los problemas de limitación de tasa y longitud de contexto. La FAQ sugiere esperar a los 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 las causas típicas por backend, incluyendo Docker no ejecutándose y variables SSH faltantes. También nota que volver a local es un movimiento de depuración válido cuando la configuración del sandbox está en cuestión.

Para los problemas del gateway, la guía de mensajería destaca las listas de permitidos y el emparejamiento como valores predeterminados seguros, lo que significa que muchos incidentes de “el bot está silencioso” 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 realmente la memoria persistente de IA
• Habilidades del Asistente de IA Hermes para Configuraciones Reales de Producción