Guia de Configuracion de Hermes Agent: Asistente de IA Auto-mejorante en tu Propio Servidor

He estado probando Hermes Agent de Nous Research junto con mi configuración de OpenClaw y mi instancia de OpenFang durante aproximadamente una semana. Lo que me enganchó es el ciclo de aprendizaje. Hermes crea habilidades a partir de las tareas que completa, mejora esas habilidades durante el uso posterior y recuerda quién eres entre sesiones. También migra tu configuración existente de OpenClaw, memorias y habilidades con un solo comando.

Si estás comparando opciones de asistentes de IA auto-alojados, nuestro resumen de alternativas a OpenClaw cubre varios proyectos incluyendo NanoClaw, nanobot, PicoClaw, ZeroClaw, NullClaw y OpenFang. Para consideraciones de seguridad al ejecutar cualquiera de estos, consulta la guía de seguridad de OpenClaw.

Que es realmente Hermes Agent

Nous Research creó Hermes Agent como lo que ellos llaman un asistente de IA “auto-mejorante”. Esa etiqueta realmente significa algo aquí: el agente observa lo que hace, extrae habilidades reutilizables de tareas complejas y refina esas habilidades la próxima vez que las ejecuta. La mayoría de los otros asistentes en esta categoría olvidan todo entre sesiones. Hermes lleva adelante lo que aprendió.

La arquitectura:

Tú (CLI / Telegram / Discord / Slack / WhatsApp / Signal / Email)
    ↓
Hermes Gateway (un solo proceso en segundo plano)
    ↓
AI Agent (almacén de sesiones, memoria, habilidades, herramientas)
    ↓
Proveedor LLM (OpenRouter, Nous Portal, OpenAI, Anthropic, Ollama, personalizado)
    ↓
40+ Herramientas (terminal, búsqueda web, navegador, edición de archivos, ejecución de código, TTS)

Los mensajes llegan desde cualquier plataforma que uses. El gateway los enruta a través de un almacén de sesiones por chat, el agente los procesa con acceso a más de 40 herramientas integradas, y todo se ejecuta desde un solo proceso. Sin microservicios, sin servidor de base de datos.

Como se compara con OpenClaw y otros

El ciclo de aprendizaje es el verdadero diferenciador. Después de pedirle a Hermes que haga algo complejo (por ejemplo, desplegar un servicio Docker), extrae ese flujo de trabajo en una habilidad. La próxima vez que pidas algo similar, usa y refina esa habilidad. La búsqueda de sesiones FTS5 significa que puede recordar detalles de conversaciones de hace semanas. Y el modo de voz en canales de voz de Discord es algo que ninguno de los otros proyectos ofrece.

OpenClaw todavía tiene la comunidad más grande, más dashboards de terceros y un historial más largo. Si OpenClaw ya te funciona, el comando de migración hace que cambiar sea indoloro cuando estés listo.

Instalacion

El instalador de una línea se encarga de Python, Node.js, dependencias y el comando hermes. Funciona en Linux, macOS y WSL2.

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

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

hermes --version

# Make sure you have Python 3.11+
python3 --version

# Create a virtual environment (recommended)
python3 -m venv ~/.hermes-venv
source ~/.hermes-venv/bin/activate

# Install
pip install hermes-agent

# For voice mode support
pip install hermes-agent[voice]

# For all optional features
pip install hermes-agent[all]

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
git submodule update --init mini-swe-agent

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv venv --python 3.11
source venv/bin/activate
uv pip install -e ".[all,dev]"
uv pip install -e "./mini-swe-agent"

Instalar en un VPS de Hetzner

Si quieres Hermes funcionando 24/7, un VPS barato hace el trabajo. Yo uso un Hetzner CX22 (2 vCPU, 4GB RAM) por €3.99/mes.

Conéctate por SSH a tu servidor y ejecuta:

ssh root@YOUR_SERVER_IP
apt update && apt upgrade -y
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc

Configurar OpenRouter con modelos gratuitos

OpenRouter enruta a más de 200 modelos a través de una sola API key. También tienen un tier gratuito con varios modelos a coste cero, que es la forma más barata de empezar.

Obtener tu API key

1. Ve a openrouter.ai y crea una cuenta
2. Navega a Keys en tu dashboard
3. Haz clic en Create Key y copia la clave

Configurar Hermes Agent

Puedes configurar de forma interactiva o editando los archivos de configuración directamente.

Configuración interactiva (recomendada):

hermes setup

Esto te guía a través del proveedor de modelo, API key, herramientas y configuración de plataformas. Cuando te pregunte por un proveedor, selecciona OpenRouter y pega tu clave.

Configuración manual:

Añade tu API key a ~/.hermes/.env:

echo "OPENROUTER_API_KEY=sk-or-v1-your-key-here" >> ~/.hermes/.env

Establece el modelo en ~/.hermes/config.yaml:

model:
  provider: "openrouter"
  default: "openrouter/free"

El modelo openrouter/free enruta al mejor modelo gratuito disponible. También puedes especificar un modelo directamente:

hermes config set model openrouter/free

Cambiar de modelo sobre la marcha

No necesitas reiniciar nada para cambiar de modelo. Usa el selector interactivo:

hermes model

O cambia a mitad de conversación con un comando slash:

/model openrouter/free

Usar modelos de pago mas adelante

Cuando estés listo para ir más allá de los modelos gratuitos, simplemente cambia el nombre del modelo:

hermes config set model anthropic/claude-sonnet-4.6
# o
hermes config set model openai/gpt-5.4

OpenRouter se encarga del enrutamiento. Tu API key sigue siendo la misma.

Primera conversacion

Empieza a chatear:

hermes

Verás un banner de bienvenida mostrando tu modelo, herramientas disponibles y habilidades. Escribe un mensaje y pulsa Enter:

❯ What can you help me with?

Algunas cosas para probar de inmediato:

❯ What's my disk usage? Show the top 5 largest directories.
❯ Search the web for the latest Docker release and summarize it.
❯ Create a Python script that monitors CPU usage and alerts me above 80%.

El agente ejecuta comandos de terminal, busca en la web, lee y edita archivos, y ejecuta código. No se necesita configuración adicional.

Comandos slash utiles

Escribe / para ver un menú desplegable de autocompletado. Los que más usarás:

Entrada multi-linea e interrupciones

Pulsa Alt+Enter o Ctrl+J para añadir una nueva línea. Útil para pegar bloques de código o escribir prompts detallados.

Si el agente está tardando demasiado, escribe un nuevo mensaje y pulsa Enter — interrumpe la tarea actual y cambia a tus nuevas instrucciones. Ctrl+C también funciona.

Reanudar una sesion

Cuando sales, Hermes imprime un comando para reanudar:

hermes --continue    # Reanudar la sesión más reciente
hermes -c            # Forma corta

Sistema de memoria

Hermes tiene tres capas de memoria que funcionan juntas.

MEMORY.md — Notas personales del agente

El agente escribe sus propias notas sobre tu entorno, convenciones y cosas que aprendió. Se almacena en ~/.hermes/memories/MEMORY.md. Limitado a 2,200 caracteres (~800 tokens) para mantener acotado el system prompt.

El agente gestiona esto automáticamente. Cuando descubre que tu servidor ejecuta Ubuntu 22.04 con Docker instalado, lo guarda. Cuando aprende que prefieres respuestas concisas, también lo guarda. No necesitas decirle que recuerde — observa datos útiles y los almacena.

USER.md — Tu perfil

Información sobre ti: nombre, preferencias, estilo de comunicación, zona horaria. Se almacena en ~/.hermes/memories/USER.md. Limitado a 1,375 caracteres (~500 tokens).

Busqueda de sesiones

Más allá de los dos archivos markdown, Hermes almacena todas las conversaciones pasadas en SQLite con búsqueda de texto completo FTS5. Puede buscar entre semanas de conversaciones antiguas para encontrar algo que discutiste antes:

❯ What did we discuss about the Nginx configuration last week?

El agente busca en su historial de sesiones, resume las partes relevantes y te da la respuesta. Ningún otro asistente de la familia OpenClaw hace esto.

Configurar la memoria

En ~/.hermes/config.yaml:

memory:
  memory_enabled: true
  user_profile_enabled: true
  memory_char_limit: 2200
  user_char_limit: 1375

Sistema de habilidades

Esta es la funcionalidad a la que sigo volviendo. Las habilidades no son plugins preconstruidos que instalas desde un hub. El agente las crea a partir de tareas que completa.

Como funciona la creacion de habilidades

1. Le pides a Hermes que haga algo complejo (desplegar un servicio, configurar un pipeline de CI, configurar Nginx)
2. Hermes completa la tarea usando sus herramientas
3. Después de terminar, extrae el flujo de trabajo en una habilidad reutilizable
4. La próxima vez que pidas algo similar, usa y refina esa habilidad

Las habilidades también se auto-mejoran. Cada vez que una se ejecuta, el agente verifica si los pasos podrían ser mejores y actualiza la habilidad si es así.

Buscar e instalar habilidades de la comunidad

hermes skills search kubernetes
hermes skills search react --source skills-sh
hermes skills install openai/skills/k8s

O usa el comando slash /skills dentro del chat.

Skills Hub

Las habilidades contribuidas por la comunidad están en agentskills.io. Puedes navegar e instalarlas, o publicar las tuyas.

Configurar plataformas de mensajeria

Hermes se comunica con Telegram, Discord, Slack, WhatsApp, Signal, SMS, Email, Home Assistant, Mattermost, Matrix y DingTalk a través de un solo proceso gateway.

Configuracion rapida

hermes gateway setup

El asistente interactivo te guía a través de cada plataforma. Muestra lo que ya está configurado y ofrece iniciar el gateway cuando termina.

TELEGRAM_BOT_TOKEN=your-bot-token-here
TELEGRAM_ALLOWED_USERS=your-telegram-user-id

hermes gateway start

DISCORD_BOT_TOKEN=your-bot-token-here
DISCORD_ALLOWED_USERS=your-discord-user-id

https://discord.com/oauth2/authorize?client_id=YOUR_APP_ID&scope=bot+applications.commands&permissions=274878286912

hermes gateway start

hermes gateway setup

Ejecutar el gateway como servicio

En un VPS, quieres que el gateway se ejecute al arrancar:

# Install as a systemd service
hermes gateway install

# Start it
hermes gateway start

# Check status
hermes gateway status

# View logs
journalctl --user -u hermes-gateway -f

# Enable lingering so it survives logout
sudo loginctl enable-linger $USER

En un VPS sin interfaz gráfica, usa el servicio del sistema en su lugar:

sudo hermes gateway install --system
sudo hermes gateway start --system

Seguridad

El gateway deniega a todos los usuarios por defecto. Solo los usuarios en la lista de permitidos pueden interactuar:

# In ~/.hermes/.env
TELEGRAM_ALLOWED_USERS=123456789
DISCORD_ALLOWED_USERS=123456789012345678

Como alternativa a las listas de permitidos, puedes usar emparejamiento por DM. Los usuarios desconocidos reciben un código de emparejamiento único cuando envían un mensaje al bot:

hermes pairing approve telegram XKGH5N7P
hermes pairing list
hermes pairing revoke telegram 123456789

Backends de terminal

Por defecto, Hermes ejecuta comandos directamente en tu máquina. Por seguridad, puedes aislar la ejecución de comandos en un contenedor o enviarla a un servidor remoto.

# In ~/.hermes/config.yaml
terminal:
  backend: local    # or: docker, ssh, singularity, modal, daytona
  timeout: 180

Aislamiento con Docker

terminal:
  backend: docker
  docker_image: python:3.11-slim
  container_cpu: 1
  container_memory: 5120
  container_disk: 51200
  container_persistent: true

Los contenedores se ejecutan con un sistema de archivos raíz de solo lectura, todas las capacidades de Linux eliminadas, sin escalación de privilegios, límites de PID y aislamiento de namespaces.

Backend SSH

Ejecuta comandos en una máquina completamente separada:

terminal:
  backend: ssh

# In ~/.hermes/.env
TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa

Modo de voz

Hermes tiene soporte de voz en CLI y mensajería. Puedes hablarle con tu micrófono en la terminal, obtener respuestas habladas en Telegram y Discord, y tener conversaciones de voz en vivo en canales de voz de Discord.

Prerequisitos

# Install voice dependencies
pip install hermes-agent[voice]

# Optional: free local speech-to-text (recommended)
pip install faster-whisper

# System dependencies (Ubuntu/Debian)
sudo apt install portaudio19-dev ffmpeg libopus0

Modo de voz en CLI

Inicia el CLI y activa la voz:

hermes
/voice on

Pulsa Ctrl+B para grabar. Habla, y cuando pares, detecta automáticamente el silencio después de 3 segundos y transcribe tu audio. Si TTS está habilitado (/voice tts), el agente pronuncia su respuesta.

Respuestas de voz en mensajeria

En Telegram o Discord, envía:

/voice tts

El agente ahora envía audio hablado junto con texto en cada respuesta.

Canales de voz de Discord

El agente puede unirse a un canal de voz de Discord, escucharte hablar y responder con audio hablado:

/voice join

Esto requiere permisos adicionales del bot de Discord (Connect, Speak, Use Voice Activity) y el códec Opus en tu servidor.

Proveedores de TTS

Configura en ~/.hermes/config.yaml:

tts:
  provider: "edge"
  edge:
    voice: "en-US-AriaNeural"

stt:
  provider: "local"
  local:
    model: "base"

Personalidad y SOUL.md

Hermes usa un archivo llamado SOUL.md como su identidad. Va en el system prompt primero, antes que nada, y da forma a cómo habla y piensa el agente.

Edítalo en ~/.hermes/SOUL.md:

# Personality
You are a pragmatic senior engineer with strong taste.
You optimize for truth, clarity, and usefulness over politeness theater.

## Style
- Be direct without being cold
- Prefer substance over filler
- Push back when something is a bad idea
- Keep explanations compact unless depth is useful

## What to avoid
- Sycophancy
- Hype language
- Overexplaining obvious things

Personalidades integradas

Cambia de personalidad sobre la marcha con /personality:

/personality concise
/personality pirate

SOUL.md es tu base. /personality es una capa a nivel de sesión.

Tareas programadas

Hermes tiene un programador cron integrado. Solo dile lo que quieres en español (o inglés) normal:

❯ Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.
❯ Every Friday at 5pm, back up the PostgreSQL database and report the size.
❯ Every hour, check if nginx is running and restart it if not.

El agente crea cron jobs que se ejecutan a través del gateway. Los resultados llegan a la plataforma que hayas configurado.

Migrar desde OpenClaw

Si vienes de OpenClaw, Hermes puede importar tus configuraciones, memorias, habilidades y API keys.

Durante la primera configuración: El asistente de configuración (hermes setup) auto-detecta ~/.openclaw y ofrece migrar.

En cualquier momento después de instalar:

hermes claw migrate              # Interactive migration
hermes claw migrate --dry-run    # Preview what would be migrated
hermes claw migrate --preset user-data   # Migrate without secrets
hermes claw migrate --overwrite  # Overwrite existing conflicts

Lo que se importa:

• SOUL.md — archivo de personalidad
• Memorias — entradas de MEMORY.md y USER.md
• Habilidades — las habilidades creadas por el usuario van a ~/.hermes/skills/openclaw-imports/
• Lista de comandos permitidos — patrones de aprobación
• Configuración de mensajería — configuraciones de plataforma, usuarios permitidos, directorio de trabajo
• API keys — tokens de Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs
• Activos de TTS — archivos de audio del workspace

Como se diferencia Hermes Agent de OpenClaw

He usado ambos extensamente. Estas son las diferencias que realmente importan en el día a día:

El ciclo de aprendizaje cambia tu forma de trabajar con él. En OpenClaw, cada tarea compleja empieza desde cero. En Hermes, una vez que has guiado al agente a través del despliegue de un servicio Docker, crea una habilidad para ese flujo de trabajo. La próxima vez que digas “despliega la API de staging”, ya conoce los pasos.

La búsqueda de sesiones le da memoria a largo plazo. La memoria de OpenClaw está limitada a lo que cabe en sus archivos de contexto. Hermes almacena cada conversación en SQLite con búsqueda de texto completo. Pregunta “¿en qué puerto configuramos Redis el mes pasado?” y encuentra la respuesta en sesiones antiguas.

El sistema de personalidad es más estructurado. OpenClaw usa un system prompt que editas a mano. Hermes tiene SOUL.md como archivo de identidad duradero, capas de /personality a nivel de sesión y 14 presets integrados.

El modo de voz realmente funciona. Entrada de micrófono en el CLI, respuestas TTS en mensajería y conversaciones en vivo en canales de voz de Discord. Nada más en la familia OpenClaw hace esto.

Aislamiento de backend de terminal. OpenClaw ejecuta comandos en tu máquina local. Hermes puede ejecutarlos en contenedores Docker, en servidores remotos vía SSH o en entornos serverless como Modal y Daytona. Si el agente rompe algo, rompe el sandbox, no tu servidor.

La migración es indolora. hermes claw migrate importa todo desde OpenClaw — memorias, habilidades, API keys, configuraciones de plataforma. No empiezas de cero.

Donde OpenClaw todavía gana: comunidad más grande, más dashboards y skins de terceros, historial más largo. Si quieres la opción más probada en batalla, OpenClaw sigue siendo la elegida.

Referencia de comandos CLI

Referencia de configuracion

La estructura completa del directorio:

~/.hermes/
├── config.yaml     # Settings (model, terminal, TTS, compression, etc.)
├── .env            # API keys and secrets
├── auth.json       # OAuth provider credentials
├── SOUL.md         # Agent identity
├── memories/       # MEMORY.md, USER.md
├── skills/         # Agent-created skills
├── cron/           # Scheduled jobs
├── sessions/       # Gateway sessions
└── logs/           # Logs (secrets auto-redacted)

Opciones clave de configuración en config.yaml:

model:
  provider: "openrouter"
  default: "openrouter/auto"

terminal:
  backend: local
  timeout: 180

memory:
  memory_enabled: true
  user_profile_enabled: true

tts:
  provider: "edge"

stt:
  provider: "local"

display:
  tool_progress: all

Si quieres un asistente que realmente mejore cuanto más lo uses, Hermes Agent es el que debes probar. El ciclo de creación de habilidades y la búsqueda de sesiones son cosas que no he visto en ningún otro proyecto en este espacio. Y si ya estás en OpenClaw, el comando de migración significa que puedes probarlo sin perder nada.

Para otras opciones de asistentes auto-alojados, consulta nuestro resumen de alternativas a OpenClaw. Si quieres agentes autónomos ejecutándose en programaciones, la guía de configuración de OpenFang cubre eso. Para un solo binario Go en hardware mínimo, consulta la guía de configuración de PicoClaw. Y para el enfoque de consola web multi-canal, la guía de configuración de CoPaw tiene los detalles.