Cómo conectar Hermes Agent a Telegram

Respuesta corta. Crea un bot con @BotFather en Telegram (/newbot) y copia su token. Dale a Hermes Agent el token y tu ID numérico de usuario de Telegram: solo los IDs de su lista de permitidos, o las personas que apruebes con un código de emparejamiento, pueden hablar con él; sin lista de permitidos, un desconocido solo recibe un código de emparejamiento que tendrías que aprobar. En tu propia máquina eso son TELEGRAM_BOT_TOKEN y TELEGRAM_ALLOWED_USERS en ~/.hermes/.env, o hermes gateway setup. En PlayNHost pegas el token y tu ID en la página Agente y reinicias.

Comprobado el 7 de noviembre de 2026, correcto para Hermes Agent v0.23.0.

Esta guía usa la documentación de Telegram y de seguridad de Hermes Agent y el panel de PlayNHost tal como funciona hoy. La compatibilidad con Telegram viene integrada en el gateway de mensajería de Hermes Agent: no hay que instalar nada más.

Paso 1: crea el bot y copia su token

1. En Telegram, abre un chat con @BotFather (o t.me/BotFather). Comprueba que el nombre sea exactamente @BotFather.
2. Envía /newbot, elige un nombre para mostrar y después un nombre de usuario que termine en bot.
3. BotFather responde con el token, que tiene este aspecto: 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Mantenlo en privado: quien lo tenga puede controlar tu bot. Si se filtra, revócalo con /revoke en BotFather.

Un programa por bot. Las preguntas frecuentes de Hermes Agent dicen que cada plataforma de chat necesita uso exclusivo de un token de bot. Si una copia anterior de Hermes Agent, o cualquier otro programa, sigue usando el mismo token, páralo primero o crea un bot nuevo.

Paso 2: encuentra tu ID de usuario de Telegram

La lista de permitidos de Hermes Agent pide tu ID de usuario numérico, un número como 123456789, no tu @usuario. Formas de obtenerlo:

• En PlayNHost, desde la consola. Escribe a tu bot antes de haber puesto ningún ID: la consola muestra tu ID. Los detalles están en el paso 3 más abajo.
• Desde el registro de Hermes Agent. Cuando alguien que no está en su lista envía un mensaje directo, su registro (~/.hermes/logs/gateway.log) recibe una advertencia que empieza por “Unauthorized user” con el ID numérico del remitente (entre corchetes tras su nombre cuando se ha configurado ignorar a los desconocidos, como en PlayNHost).
• Un bot de terceros. La documentación de Hermes Agent sugiere @userinfobot o @get_id_bot, que responden con tu ID.

Paso 3 en PlayNHost: pega el token y tu ID

Necesitas una clave de proveedor de IA en la misma página. Sin ella, Iniciar se detiene con “Your agent is not set up yet: it needs an API key from one AI provider and a Telegram or Discord bot token.” (el mensaje sale en inglés).

1. Abre tu servidor en panel.playnhost.com y luego la pestaña Agente.
2. En Proveedor de IA, define una clave si aún no lo has hecho (mira qué clave de proveedor de IA usar).
3. En Apps de chat, pulsa Definir en Token del bot de Telegram, pega el token de BotFather y pulsa Guardar. El panel comprueba su forma; si pegas algo incorrecto, aparece “That is not a valid telegram bot token.” (en inglés). Una vez guardado, la fila muestra solo los últimos cuatro caracteres y el token no se vuelve a mostrar.
4. ¿Aún no sabes tu ID? Deja IDs de usuario de Telegram vacío y pulsa Iniciar. El primer arranque instala Hermes Agent, que en nuestras pruebas tardó de 2,5 a 4 minutos. Cuando el agente está en marcha, la consola imprime:

   [PlayNHost] Your agent is running
   [PlayNHost] Telegram: nobody can message your agent yet. Send your bot any message: your Telegram user ID appears here in the console. Put it on the Agent page, then restart.

   Envía un mensaje a tu bot en Telegram. No responde, ni siquiera con un código de emparejamiento: en PlayNHost, Hermes Agent ignora a cualquiera que no esté en la lista. En unos 20 segundos (la consola revisa el registro de Hermes Agent cada 20 segundos) muestra tu ID:

   [PlayNHost] Telegram user 123456789 messaged your agent and was ignored. If that is you, add 123456789 to the Telegram user IDs on the Agent page, then restart.

5. En Quién puede escribirle, escribe el número en IDs de usuario de Telegram y pulsa Guardar. Varios IDs van en una sola línea, separados por comas o espacios.
6. La página dice “Los cambios se aplican la próxima vez que se inicie tu agente.” Pulsa Reiniciar ahora. La consola lo confirma entonces:

   [PlayNHost] Telegram: only user 123456789 can message your agent.

7. Escribe a tu bot. Tu agente responde. Los mensajes de cualquier otra cuenta de Telegram se ignoran, y cada nuevo remitente que escribe al bot en directo aparece en la consola una vez por arranque, así que puedes añadir a un amigo de la misma manera.

Lo que PlayNHost configura por ti

• Los IDs de la página Agente llegan a Hermes Agent como TELEGRAM_ALLOWED_USERS. Cualquier otra forma de dejar entrar a gente (interruptores de permitir a todos, otras listas de permitidos, permisos de grupo, aprobaciones de emparejamiento) se desactiva en cada arranque, y el agente se detiene si aparece una mientras funciona.
• A los desconocidos se les ignora (unauthorized_dm_behavior: ignore) en lugar de darles el código de emparejamiento por defecto de Hermes Agent, porque un servidor de PlayNHost no tiene línea de comandos para aprobar un código.
• El token llega a Hermes Agent como TELEGRAM_BOT_TOKEN. Una copia suya escrita en .hermes/.env se elimina en el siguiente arranque, así que el token de la página Agente es el que se usa.
• Solo están activos Telegram y Discord. WhatsApp se rechaza: la propia documentación de Hermes Agent dice que su puente de WhatsApp emula una sesión de WhatsApp Web y conlleva riesgo de bloqueo.

Paso 3 en tu propia máquina

1. Ejecuta el asistente de configuración y elige Telegram. Te pide el token y los IDs de usuario permitidos y los escribe por ti:

   hermes gateway setup

2. O añádelos a mano a ~/.hermes/.env:

   TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
   TELEGRAM_ALLOWED_USERS=123456789

   Varios IDs se separan con comas.
3. Arranca el gateway con hermes gateway y envía un mensaje a tu bot. Para que siga funcionando al cerrar la sesión, mira cómo ejecutar Hermes Agent 24/7.

Sin ninguna lista de permitidos, Hermes Agent deniega a todo el mundo. Su opción por defecto para desconocidos es un código de emparejamiento que apruebas con hermes pairing approve telegram <code>; los códigos caducan a la hora. La documentación de Hermes Agent también ofrece GATEWAY_ALLOW_ALL_USERS=true, y lo desaconseja para un bot que puede ejecutar comandos.

Cuando no responde

En PlayNHost, el registro propio de Hermes Agent es .hermes/logs/gateway.log en Files. ¿Quieres Discord también? Mira conectar Hermes Agent a Discord. ¿Aún no lo tienes? Crea un servidor Hermes Agent.

PlayNHost no está afiliada a Nous Research. Hermes Agent es software de código abierto con licencia MIT.