Cómo Desplegar Hermes Agent en Telegram

Por Qué Telegram Es la Mejor Interfaz para Hermes

La mayoría de las herramientas de IA viven en una pestaña del navegador. Navegás hasta ellas, escribís algo, leés la respuesta y cerrás la pestaña. En el momento en que la cerrás, el contexto desaparece.

Telegram cambia todo eso. Si Hermes corre como un bot de Telegram, interactuás con tu agente desde tu teléfono, desde cualquier dispositivo, en cualquier momento, sin abrir un navegador ni recordar una URL. Los mensajes llegan como cualquier otra conversación. El agente responde con todo su contexto persistente intacto.

Esto es lo que significa "agente de IA siempre activo" en la práctica: no un proceso en segundo plano que revisás cuando te acordás de que existe, sino un contacto en tu app de mensajería que está listo y recuerda todo.

Lo Que un Despliegue Real en Telegram Requiere

Poner Hermes en Telegram implica más que un solo comando. Un despliegue real tiene cinco piezas distintas:

1. Crear el bot en BotFather

Abrí Telegram y buscá @BotFather. Enviá /newbot, elegí un nombre de visualización y un nombre de usuario que termine en bot, y copiá el token de API que te devuelve. Ese token tiene el formato 7123456789:ABCDef...: guardá el string completo.

2. Elegir un proveedor de modelos

Hermes necesita un LLM para generar sus respuestas. OpenRouter es la opción más sencilla: una API key te da acceso a Claude, GPT-4, Llama y otros sin manejar cuentas separadas. La guía de configuración de OpenRouter lo cubre en detalle.

3. Configurar el runtime

En config.yaml, conectá tu clave de proveedor, la elección de modelo y la configuración de Telegram:

provider: openrouter
model: anthropic/claude-3-5-sonnet
openrouter_api_key: sk-or-your-key-here
telegram_bot_token: 7123456789:ABCDef...
telegram_allowed_users: "TU_ID_NUMERICO_DE_TELEGRAM"

El campo telegram_allowed_users es crítico. Hermes solo responderá a los IDs numéricos de Telegram que estén en esa lista. Podés obtener tu ID numérico desde @userinfobot en Telegram: no acepta nombres de usuario.

4. Iniciar el gateway de mensajería

hermes gateway start --detach

El gateway corre como un proceso en segundo plano que hace long-polling a la API de Telegram y enruta los mensajes al runtime de Hermes. Sin él, tu bot recibirá mensajes pero nunca responderá.

5. Mantenerlo corriendo

Aquí es donde la mayoría de los despliegues propios eventualmente se estancan. El bot funciona cuando el proceso está corriendo, y deja de funcionar cuando el proceso se detiene. En una laptop con WSL2, el proceso muere cuando cerrás la terminal. En un VPS económico, puede ser terminado durante un reciclado de contenedor. Un despliegue de producción real requiere un servidor persistente con gestión de procesos (systemd, Docker con política de reinicio, o hosting gestionado).

Los Modos de Falla Más Comunes

Bot silencioso: El bot está registrado en Telegram, pero no responde cuando le escribís. El gateway no está corriendo (hermes gateway status) o tu ID de usuario no está en telegram_allowed_users.

Error "Unauthorized" en los logs: Tu token de bot fue revocado o es incorrecto. Generá uno nuevo desde BotFather (/mybots → seleccioná el bot → API Token → Revoke) y actualizá tu configuración.

Funciona una vez y luego se silencia: El proceso de Hermes se cayó o el gateway se desconectó. Revisá los logs para ver si hay algún error antes del momento de silencio. Un error de la API del modelo (límite de velocidad, cuota agotada) puede hacer que la sesión salga en vez de recuperarse.

Funciona localmente pero está roto después del despliegue: La causa más común es que la configuración del servidor difiere de la configuración local, específicamente el token o la lista de usuarios permitidos. Revisá el config.yaml del servidor directamente, no el local.

La guía de troubleshooting de Telegram cubre cada uno de estos casos en detalle con los pasos exactos para solucionarlos.

El Costo de Tiempo Que Nadie Contempla

El comando de instalación lleva cinco minutos. El camino operativo es lo que realmente cuesta tiempo.

Cuando Hermes está corriendo en Telegram de forma exitosa, es genuinamente útil. El problema es el tiempo entre "quiero esto" y "está funcionando de manera confiable":

• Configurar el VPS o el entorno del servidor
• Almacenar las credenciales de forma segura
• Depurar la primera vez que el gateway deja de responder
• Manejar el reinicio del proceso después de una actualización del sistema
• Monitorear el uptime para notar cuándo el bot se silencia

Ninguno de estos pasos es difícil por separado. Juntos, representan una responsabilidad operativa continua. Si tu objetivo es usar Hermes en vez de mantener la infraestructura alrededor de él, este es el punto de fricción.

El Camino Gestionado: Hermify

Hermify está diseñado específicamente alrededor del problema del despliegue en Telegram. En vez de construir el entorno del servidor vos mismo:

1. Creás una cuenta y elegís un plan
2. Ingresás tu token de bot de Telegram y los IDs de usuarios permitidos en el formulario de onboarding
3. Agregás tu clave de proveedor de modelos (o usás un plan con acceso a modelos incluido)
4. Hacés clic en deploy

El runtime se provisionea en un servidor persistente, el gateway arranca automáticamente y el bot está activo en Telegram. El dashboard muestra el estado del runtime, permite actualizar credenciales y te deja activar reinicios sin acceso SSH.

Cuando el bot se silencia en un despliegue autogestionado, depurás el gateway. Cuando se silencia en Hermify, revisás la tarjeta de estado y reiniciás desde el dashboard.

Esta es la diferencia práctica: no si el despliegue en Telegram es posible (claramente lo es), sino quién asume la responsabilidad de mantenerlo saludable después de que está en vivo.

Elegir Entre Self-Hosting y Hosting Gestionado

Ambos caminos funcionan. La elección depende de qué querés manejar vos:

Elegí self-hosting si: Tenés experiencia con administración de servidores Linux, ya corrés este tipo de infraestructura, y querés control total sobre el entorno, el almacenamiento y la configuración.

Usá hosting gestionado si: Querés Hermes disponible en Telegram de forma confiable, no querés gestionar un servidor, y tu interés principal es usar el agente y no mantener el stack alrededor de él.

La comparación entre hosting y self-hosting cubre esta decisión con más profundidad, incluyendo el desglose de costos y las expectativas de mantenimiento después del primer despliegue.

Si estás listo para empezar, la página de deploy de Hermes Agent te guía por el proceso completo de configuración gestionada, desde la creación de la cuenta hasta el primer mensaje.