Cómo conectar Hermes Agent a Telegram y gestionar tareas desde el teléfono

Puedes enviar mensajes a Hermes Agent o dictarle tareas por Telegram desde el teléfono cuando estés lejos del ordenador, y recibir el resultado en el mismo chat. Los resultados de las tareas programadas llegan una vez al chat que designes como chat principal.

Si aún no tienes Hermes, empieza por la guía sobre qué es este agente y cómo instalarlo y luego vuelve para conectar Telegram.

Encontrarás instrucciones adicionales en la documentación de Ailoot.

¿Qué necesitas para conectar Hermes Agent a Telegram?#

El comando hermes doctor comprueba la instalación de Hermes y la conexión con el modelo. Crearemos el bot en la aplicación de Telegram, y necesitarás un ordenador para ejecutar comandos en el terminal.

¿Cómo se crea un bot a través de BotFather?#

Cada bot de Telegram tiene un token, una clave secreta que permite controlarlo. Lo emite el bot oficial de Telegram, @BotFather.

1. Abre @BotFather

   Busca @BotFather en Telegram o abre t.me/BotFather. El BotFather auténtico tiene una marca azul de verificación. Pulsa «Start» para iniciar la conversación.

2. Envía el comando /newbot

   BotFather te pedirá dos nombres. El primero es el nombre para mostrar; puede ser cualquiera, por ejemplo, «Mi agente». El segundo es el nombre de usuario: debe ser único y terminar en bot, por ejemplo, moy_agent_bot.

3. Obtén el token

   BotFather te enviará un mensaje de felicitación y una cadena larga con el formato 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Ese es el token del bot. Copia la cadena completa.

También hay una forma rápida de hacerlo sin conversar manualmente con BotFather. En el panel web de Hermes (hermes dashboard) y en la aplicación de escritorio, en la página «Messaging → Telegram», hay un botón «Create with QR»: escanea el código con el teléfono y Hermes creará un bot, detectará tu ID, guardará el token en la configuración y reiniciará la pasarela. Los pasos siguientes explican el método manual; si elegiste el código QR, ve directamente a comprobar la conexión.

¿Cómo encuentras tu ID de Telegram y por qué lo necesitas?#

Una cuenta de Telegram tiene dos identificadores: un nombre de usuario público con @ y un ID numérico interno. Hermes usa el número.

El método rápido «Crear con QR» descrito arriba detecta tu ID automáticamente. Anótalo junto al token.

¿Cómo proporcionas el token a Hermes Agent e inicias la pasarela?#

1. Ejecuta el asistente de configuración

   hermes gateway setup
   

   Ejecuta el comando en la máquina donde está instalado Hermes. El asistente te ofrecerá una lista de aplicaciones de mensajería.

2. Selecciona Telegram e introduce tus datos

   El asistente te pedirá el token del bot y los ID autorizados (puedes introducir varios, separados por comas) y lo guardará todo directamente en la configuración.

3. Inicia la pasarela

   hermes gateway
   

   La pasarela se iniciará y se conectará a Telegram. Después de unos segundos, envía cualquier mensaje a tu bot desde la aplicación: si Hermes responde, la conexión está lista.

Para usar el método manual en lugar del asistente, abre el archivo ~/.hermes/.env y añade dos líneas. Sustituye los valores por el token de BotFather y tu ID numérico:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

La segunda línea autoriza a esas personas en privados y grupos; la autorización separada de chats de grupo también puede conceder acceso. Separa las distintas personas con comas. Después de guardar el archivo, inicia la pasarela con el mismo comando hermes gateway.

Si el bot no responde ni siquiera en un chat privado, revisa los registros de la pasarela en el mismo terminal y comprueba primero que el token y tu ID sean correctos en la lista de acceso; los demás errores se describen en la tabla al final del artículo.

¿Qué puede hacer el bot de Telegram en tu teléfono?#

Estas son las cinco funciones que más necesitarás en el teléfono.

Mensajes de texto y de voz. Escribe una tarea con palabras o dicta un mensaje de voz: si está configurado el reconocimiento de voz, Hermes lo transcribirá y lo entenderá. Con un proveedor local no se necesitan claves; todo se procesa en la máquina donde se ejecuta el agente.

Archivos e imágenes. Puedes reenviar al bot un documento, una hoja de cálculo o una captura de pantalla; el agente lo recibirá como archivo adjunto. También puede enviarte archivos generados: pídele un informe y te lo enviará como archivo en el chat.

Confirmaciones para acciones peligrosas. Cuando el agente esté a punto de hacer algo arriesgado, como borrar archivos, primero te preguntará en el chat: responde «yes» o «y» para que lo haga; responde «no» o «n» para que lo cancele.

Botones en vez de escribir la respuesta. Cuando el agente necesite una aclaración, enviará una pregunta con botones de opciones integrados: pulsa una opción y el agente seguirá trabajando. El comando /model sin argumentos muestra un menú para elegir modelo con el mismo tipo de botones.

Notificaciones silenciosas. De forma predeterminada, el teléfono solo suena para las respuestas finales, las solicitudes de confirmación y las confirmaciones de comandos. Las notificaciones de servicio, como «calling a tool» y «compressing context», llegan en silencio, para que el teléfono no suene a cada paso. Si quieres recibir notificaciones con sonido en cada paso, cambia el modo en la configuración.

¿Cómo recibes en el chat los resultados de las tareas en segundo plano?#

Chat principal para las tareas programadas. Hermes admite tareas programadas, como «cada mañana a las 7:43, prepárame un resumen». Envía los resultados al chat principal, que designas una sola vez enviando el comando /sethome directamente en la conversación con el bot. Mientras la pasarela esté funcionando, los resúmenes llegarán automáticamente.

Tareas en segundo plano. Puedes enviar una tarea larga para que se ejecute en segundo plano y seguir con tu día: el bot te escribirá cuando esté lista. Una tarea iniciada desde un tema devolverá la respuesta a ese mismo tema, para que no se pierda nada.

Limitación importante: el bot solo responde mientras la pasarela está en funcionamiento. Si apagas el ordenador donde se ejecuta Hermes o lo pones en suspensión, el bot no responderá hasta que la máquina vuelva a estar encendida. Para mantenerlo siempre en línea, traslada el agente a un servidor: tenemos una guía aparte sobre cómo mantener Hermes Agent en funcionamiento las 24 horas. De forma predeterminada, la pasarela consulta Telegram para obtener mensajes nuevos; para las plataformas en la nube que entran en suspensión cuando no reciben tráfico, la documentación ofrece un modo webhook, que invierte el sentido de la conexión para que Telegram envíe las solicitudes al bot.

¿Cómo evitas que desconocidos accedan al bot?#

El nombre de usuario de tu bot permite encontrarlo en la búsqueda de Telegram, así que la protección depende de dos cosas: la lista de acceso y mantener el token en secreto.

Primero configura el acceso de remitentes con TELEGRAM_ALLOWED_USERS. Para grupos, inspecciona también TELEGRAM_GROUP_ALLOWED_CHATS: incluir allí un chat permite acceder a cualquiera de sus miembros, aunque su ID no esté en la lista personal. Una lista personal vacía por sí sola no demuestra que todos los grupos estén cerrados.

Lo segundo es el token. No debe aparecer en capturas de pantalla, mensajes reenviados ni repositorios. Si el token queda expuesto, revócalo con el comando /revoke en BotFather. Después, introduce el token nuevo en la configuración y reinicia la pasarela.

Una nota sobre grupos: la autorización del remitente y la del chat son distintas. Un miembro de un grupo permitido por TELEGRAM_GROUP_ALLOWED_CHATS puede usar el bot aunque su ID no esté en TELEGRAM_ALLOWED_USERS. Si el acceso debe ser individual, no autorices el grupo completo; configura y verifica las restricciones de remitentes en tu versión instalada. Si quieres que el bot responda en un grupo solo cuando lo mencionen, existe el ajuste telegram.require_mention: entonces responderá a una mención con @, a una respuesta a su mensaje, a un comando como /command@yourbot y a las coincidencias con tus patrones en telegram.mention_patterns, mientras ignora los mensajes normales del grupo.

¿Por qué el bot no responde en un grupo y cómo se soluciona?#

Los bots nuevos de Telegram tienen el modo de privacidad activado de forma predeterminada; la documentación de Hermes lo describe como la causa de confusión más habitual con los bots en grupos. En este modo, el bot solo recibe los mensajes que empiezan con un comando /, las respuestas a sus propios mensajes y las notificaciones de servicio. No recibe los mensajes normales del grupo: Telegram no se los envía, y ningún ajuste del agente puede solucionarlo.

Cómo solucionarlo:

1. Abre @BotFather y envía /mybots.
2. Selecciona tu bot.
3. Abre «Bot Settings» → «Group Privacy» → «Turn off».
4. Quita el bot del grupo y vuelve a añadirlo.

Es fácil pasar por alto el cuarto paso; entonces el bot «sigue sin responder». Telegram recuerda el ajuste de privacidad que estaba vigente cuando el bot se unió al grupo y no lo actualiza hasta que se quita el bot del grupo y se vuelve a añadir.

Si no quieres desactivar la privacidad de forma global, hay otra opción: haz que el bot sea administrador del grupo. Los bots administradores reciben todos los mensajes, sea cual sea el modo de privacidad.

Errores de conexión frecuentes y qué hacer al respecto#

¿Qué otras preguntas hace la gente sobre Hermes Agent en Telegram?#

Cuando estés listo, descubre Ailoot.