Puedes controlar de forma remota Hermes Agent a través de Telegram, in­de­pe­n­die­n­te­me­n­te del di­s­po­si­ti­vo que utilices. El agente sigue alojado en tu propio equipo o servidor y el acceso se realiza mediante un bot de Telegram. Para pro­te­ge­r­lo, puedes autorizar úni­ca­me­n­te de­te­r­mi­na­dos ID de usuario. Si quieres que esté di­s­po­ni­ble de forma pe­r­ma­ne­n­te, puedes ejecutar la pasarela en un servidor Linux o VPS.

Resumen

  • La pasarela de me­n­sa­je­ría conecta tu Hermes Agent alojado en tu propio equipo o servidor con Telegram, que solo actúa como interfaz.
  • Crea un bot con BotFather y copia su token secreto.
  • Averigua tu ID numérico de usuario de Telegram y añádelo a los usuarios au­to­ri­za­dos.
  • Configura la pasarela con hermes gateway setup y pruébala con hermes gateway run.
  • Instala la pasarela como servicio en segundo plano; si el bot no responde, hermes doctor te ayuda a dia­g­no­s­ti­car el problema.
  • Para tener Hermes di­s­po­ni­ble las 24 horas, ejecútalo en un servidor Linux o VPS. No­r­ma­l­me­n­te no es necesario abrir ningún puerto público.

¿Cómo funciona la conexión entre Hermes Agent y Telegram?

La pasarela de me­n­sa­je­ría de Hermes Agent es la interfaz nativa que permite conectar Hermes Agent alojado en tu propio equipo o servidor con pla­ta­fo­r­mas de chat externas como Telegram. La pasarela recibe los mensajes, los asigna a una sesión y los envía al agente. Después, devuelve las re­s­pue­s­tas al chat de Telegram co­rre­s­po­n­die­n­te.

De este modo, puedes co­mu­ni­car­te con Hermes Agent desde la app de Telegram en tu sma­r­t­pho­ne, tablet u otro ordenador. El agente de IA continúa eje­cu­tá­n­do­se en tu propio ordenador o servidor, mientras que Telegram funciona como interfaz de acceso para enviar mensajes y recibir las re­s­pue­s­tas.

Para co­n­fi­gu­rar la conexión necesitas tres elementos: un bot de Telegram, el token secreto del bot y tu ID de usuario de Telegram para autorizar el acceso. Después, solo tienes que iniciar la pasarela de me­n­sa­je­ría de Hermes. Si quieres ma­n­te­ne­r­la di­s­po­ni­ble de forma pe­r­ma­ne­n­te, también puedes co­n­fi­gu­rar­la como servicio en segundo plano en un servidor Linux.

Hermes Agent VPS Hosting
Tu VPS para el Hermes Agent – potente, seguro y escalable
  • Listo para Hermes: acceso root, op­ti­mi­za­do para SSH, operativo en minutos
  • Rápido de forma constante: SSD NVMe y 1 Gbit/s, sin li­mi­ta­cio­nes
  • Seguro: in­te­gra­cio­nes API pe­r­so­na­li­za­das y co­m­pa­ti­bi­li­dad con Docker

Re­qui­si­tos para conectar Hermes Agent con Telegram

Antes de empezar, Hermes Agent debe estar instalado y funcionar co­rre­c­ta­me­n­te. Para co­m­pro­bar­lo, abre un terminal e inicia Hermes sin Telegram:

hermes
bash

Haz una pregunta sencilla y comprueba que el agente responde.

Además, necesitas:

  • una cuenta de Telegram
  • acceso al terminal del equipo en el que se ejecuta Hermes
  • un proveedor de modelos ya co­n­fi­gu­ra­do
  • conexión a Internet en el sistema donde se ejecuta Hermes

Crear un bot de Telegram con BotFather

Un bot de Telegram es una cuenta especial ge­s­tio­na­da por software en lugar de por una persona. Para crear y ad­mi­ni­s­trar bots, Telegram ofrece el bot oficial @BotFather. Abre Telegram, busca la cuenta @BotFather y asegúrate de se­le­c­cio­nar el bot oficial. A co­n­ti­nua­ción, envíale este comando:

/newbot
text

BotFather te guiará durante el proceso de creación:

  1. Elegir el nombre del bot: primero, BotFather te pedirá un nombre para el bot. Este será el nombre que aparecerá po­s­te­rio­r­me­n­te en los chats de Telegram. No tiene que ser único y puedes cambiarlo más adelante.
  2. Elegir un nombre de usuario único: a co­n­ti­nua­ción, tendrás que asignar al bot un nombre de usuario único en Telegram. Debe terminar en bot, por ejemplo, mi_hermes_agent_bot. Si el nombre que quieres utilizar ya está ocupado, tendrás que elegir otra variante.
  3. Copiar el token del bot: una vez creado el bot, BotFather te pro­po­r­cio­na­rá un token para acceder a la API de Telegram. Hermes utiliza este token para au­te­n­ti­car el bot ante la API, por lo que debes tratarlo como una co­n­tra­se­ña.
Nota

No publiques el token ni lo incluyas en capturas de pantalla, do­cu­me­n­tos públicos, pu­bli­ca­cio­nes en foros o re­po­si­to­rios de Git de acceso público. Cualquier persona que conozca el token puede controlar el bot a través de la API de bots de Telegram. Si lo expones por error, puedes revocarlo desde BotFather con el comando /revoke y generar uno nuevo.

¿Cómo encontrar tu ID de usuario de Telegram?

Además del token, Hermes necesita tu ID de usuario de Telegram. Se trata de un ide­n­ti­fi­ca­dor numérico único que no debes confundir con el nombre que aparece en tu perfil ni con tu nombre de usuario. Mientras que el nombre de usuario puede cambiar, Hermes utiliza este ID numérico para controlar quién puede acceder al bot.

Para averiguar tu ID, puedes abrir en Telegram un bot externo como @use­ri­n­fo­bot e iniciar el chat o enviarle cualquier mensaje. El bot te mostrará distintos datos de tu cuenta. Copia el número co­rre­s­po­n­die­n­te a tu ID de usuario.

Datos ne­ce­sa­rios para co­n­fi­gu­rar Telegram

Dato de co­n­fi­gu­ra­ción Contenido Pro­ce­de­n­cia
TELEGRAM_BOT_TOKEN Token secreto de tu bot de Telegram Lo pro­po­r­cio­na el bot oficial @BotFather después de ejecutar /newbot
TELEGRAM_ALLOWED_USERS Tu ID numérico de usuario de Telegram Puede co­n­su­l­tar­se, por ejemplo, mediante @use­ri­n­fo­bot
Nombre de usuario del bot Nombre público y único del bot, que termina en bot Se establece al crear el bot con @BotFather

Para una in­s­ta­la­ción personal de Hermes, no­r­ma­l­me­n­te basta con añadir tu propio ID de usuario. Si más adelante quieres permitir el acceso a varias personas, puedes añadir sus ID separados por comas.

Co­n­fi­gu­rar la pasarela de Hermes Agent desde la CLI

Hermes incluye un asistente in­ter­ac­ti­vo que te guía paso a paso por la co­n­fi­gu­ra­ción de Telegram desde la línea de comandos. Abre un terminal en el equipo donde tengas instalado Hermes Agent y ejecuta:

hermes gateway setup
bash

El asistente mostrará las pla­ta­fo­r­mas de me­n­sa­je­ría co­m­pa­ti­bles. Se­le­c­cio­na Telegram con las teclas de dirección y confirma con Intro. Después, introduce los si­guie­n­tes datos:

  • la pla­ta­fo­r­ma que quieres utilizar
  • el token del bot de Telegram
  • los ID de usuario de Telegram au­to­ri­za­dos

Introduce como token el valor que te ha pro­po­r­cio­na­do BotFather y, en el campo de usuarios au­to­ri­za­dos, añade el ID numérico de Telegram que has obtenido an­te­rio­r­me­n­te. El asistente guardará estos datos en la co­n­fi­gu­ra­ción de Hermes. El token permite conectar Hermes con el bot de Telegram que has creado.

El ID de usuario como control de acceso

De­pe­n­die­n­do de su co­n­fi­gu­ra­ción, Hermes Agent puede acceder a archivos, ejecutar programas y comandos del terminal, y utilizar otras he­rra­mie­n­tas. Por este motivo, permitir el acceso público al bot supone un riesgo co­n­si­de­ra­ble­me­n­te mayor que en el caso de un chatbot co­n­ve­n­cio­nal de preguntas y re­s­pue­s­tas.

Hermes aplica por defecto una política re­s­tri­c­ti­va: los usuarios que no estén au­to­ri­za­dos no pueden ejecutar tareas a través del agente. En los mensajes directos, y según la co­n­fi­gu­ra­ción utilizada, un usuario de­s­co­no­ci­do puede recibir un código de em­pa­re­ja­mie­n­to para solicitar acceso, pero no obtiene acceso al agente hasta que se le autoriza.

Si utilizas el bot úni­ca­me­n­te de forma privada, limitar el acceso mediante una lista fija de ID de usuario es una opción sencilla y fácil de controlar.

Nota

No confíes úni­ca­me­n­te en la pro­te­c­ción pre­de­te­r­mi­na­da. Envía un mensaje al bot desde una cuenta de Telegram que no esté au­to­ri­za­da y comprueba que no pueda ejecutar tareas con Hermes.

Evita co­n­fi­gu­rar GATEWAY_ALLOW_ALL_USERS=true si Hermes tiene acceso al sistema o al terminal. Esta opción elimina la re­s­tri­c­ción global de acceso y permite que cualquier usuario que pueda contactar con el bot in­ter­ac­túe con el agente.

Autorizar el acceso a varias personas

Si quieres permitir que varias personas de confianza utilicen el mismo bot, introduce sus ID de Telegram separados por comas:

TELEGRAM_ALLOWED_USERS=123456789,987654321,555555555
bash

De forma pre­de­te­r­mi­na­da, todas las personas incluidas en esta lista pueden acceder al mismo agente y a las he­rra­mie­n­tas que tenga di­s­po­ni­bles. Por tanto, añade úni­ca­me­n­te los ID de personas que deban tener acceso al sistema. Hermes mantiene separadas las co­n­ve­r­sa­cio­nes de los distintos usuarios de Telegram, aunque todos ellos acceden a las funciones y he­rra­mie­n­tas di­s­po­ni­bles en el mismo agente.

Activar la pasarela de Telegram y comprobar la conexión

Una vez terminada la co­n­fi­gu­ra­ción, conviene iniciar primero la pasarela di­re­c­ta­me­n­te desde el terminal para comprobar que funciona co­rre­c­ta­me­n­te. Ejecuta:

hermes gateway run
bash

La pasarela se ejecutará en primer plano, por lo que podrás ver di­re­c­ta­me­n­te en el terminal los mensajes de estado y los posibles errores. Mantén esta ventana abierta durante la prueba. Si la conexión se establece co­rre­c­ta­me­n­te, debería aparecer un mensaje indicando que el adaptador de Telegram está conectado.

A co­n­ti­nua­ción, abre en Telegram el bot que has creado y envíale un mensaje. Realiza estas pruebas una a una:

  1. Comprobar el estado: envía /status. Hermes debería mostrar in­fo­r­ma­ción sobre la sesión actual.
  2. Hacer una pregunta: envía al agente una consulta como «¿Qué he­rra­mie­n­tas del sistema tienes di­s­po­ni­bles ac­tua­l­me­n­te? Indica solo sus nombres y no ejecutes ninguna». Así puedes comprobar que Hermes recibe el mensaje, lo procesa y devuelve la respuesta a través de Telegram.
  3. Iniciar una nueva co­n­ve­r­sa­ción: envía /new. Este comando inicia una nueva sesión sin el contexto de la co­n­ve­r­sa­ción anterior. Si el bot responde co­rre­c­ta­me­n­te a estas pruebas, la co­mu­ni­ca­ción entre Telegram y Hermes funciona en ambos sentidos.

Cuando termines, detén la pasarela en el terminal con la co­m­bi­na­ción de teclas Ctrl+C.

Ejecutar la pasarela en segundo plano

Para no tener que mantener una ventana del terminal abierta, puedes instalar la pasarela como servicio en segundo plano:

hermes gateway install
bash

Una vez instalada, puedes co­n­tro­lar­la con los si­guie­n­tes comandos:

hermes gateway start
hermes gateway stop
hermes gateway status
bash

Si modificas la co­n­fi­gu­ra­ción de Telegram, es re­co­me­n­da­ble reiniciar la pasarela:

hermes gateway stop
hermes gateway start
bash

También puedes re­ini­ciar­la di­re­c­ta­me­n­te con:

hermes gateway restart
bash

El comando hermes gateway start inicia el servicio en segundo plano que has instalado pre­via­me­n­te. Si todavía no lo has instalado, ejecuta primero hermes gateway install. En cambio, hermes gateway run sirve para iniciar la pasarela en primer plano, por ejemplo, para realizar pruebas y ver di­re­c­ta­me­n­te los mensajes de estado.

Si utilizas un servidor Linux o VPS y quieres que la pasarela siga fu­n­cio­na­n­do después de cerrar la sesión, puedes habilitar el servicio de usuario para que pe­r­ma­ne­z­ca activo:

sudo loginctl enable-linger $USER
bash

A co­n­ti­nua­ción, comprueba el estado de la pasarela:

hermes gateway status
bash

Por último, vuelve a enviar un mensaje al bot de Telegram. Debería responder aunque ya no tengas abierta una ventana del terminal con Hermes.

¿Qué hacer si el bot de Telegram no responde?

Como primer paso para dia­g­no­s­ti­car el problema, ejecuta:

hermes doctor
bash

Hermes co­m­pro­ba­rá, entre otros aspectos, la in­s­ta­la­ción, los pri­n­ci­pa­les valores de co­n­fi­gu­ra­ción y las de­pe­n­de­n­cias ne­ce­sa­rias. Si detecta algún problema, mostrará in­fo­r­ma­ción en el terminal junto con posibles so­lu­cio­nes. Hermes también puede intentar corregir au­to­má­ti­ca­me­n­te algunos errores con:

hermes doctor --fix
bash

A co­n­ti­nua­ción, comprueba si la pasarela está en fu­n­cio­na­mie­n­to. Si el bot sigue sin responder, revisa estos puntos uno por uno:

  • ¿El token del bot está completo y no contiene espacios adi­cio­na­les?
  • ¿El ID numérico de usuario es correcto?
  • ¿Has in­tro­du­ci­do el ID de usuario y no el nombre de usuario de Telegram?
  • ¿La pasarela aparece activa al ejecutar hermes gateway status?
  • ¿Hermes funciona di­re­c­ta­me­n­te desde el terminal sin Telegram?
  • ¿El equipo tiene conexión a Internet?

Para ver di­re­c­ta­me­n­te los posibles errores, puedes detener el servicio en segundo plano e iniciar de nuevo la pasarela en el terminal:

hermes gateway stop
hermes gateway run
bash

De este modo, los errores que se produzcan al es­ta­ble­cer la conexión apa­re­ce­rán di­re­c­ta­me­n­te en el terminal.

Mantener Hermes Agent di­s­po­ni­ble las 24 horas con Telegram

Si ejecutas Hermes en un portátil u ordenador de sobremesa, el bot de Telegram solo estará di­s­po­ni­ble mientras el equipo esté encendido, conectado a Internet y la pasarela esté activa. Si apagas el di­s­po­si­ti­vo o entra en modo de su­s­pe­n­sión, Hermes dejará de poder procesar los mensajes de Telegram.

Si quieres ma­n­te­ne­r­lo di­s­po­ni­ble las 24 horas, puedes instalar Hermes en un servidor Linux o en un servidor privado virtual (VPS). Un VPS es un ordenador virtual alojado en un centro de datos y di­s­po­ni­ble de forma pe­r­ma­ne­n­te. Por lo general, puedes acceder a su terminal mediante una conexión SSH cifrada.

Trasladar Hermes a un servidor paso a paso

Primero, instala Hermes en el servidor Linux y configura allí el proveedor de modelos. A co­n­ti­nua­ción, inicia un chat normal con Hermes para comprobar que funciona co­rre­c­ta­me­n­te. Después, vuelve a ejecutar el asistente de co­n­fi­gu­ra­ción de la pasarela:

hermes gateway setup
bash

Puedes utilizar el mismo token del bot de Telegram y el mismo ID de usuario au­to­ri­za­do. Sin embargo, antes de iniciar el bot de forma pe­r­ma­ne­n­te en el servidor, detén la pasarela que se ejecuta en tu equipo local. Así evitarás que dos in­s­ta­la­cio­nes de Hermes intenten utilizar el mismo bot al mismo tiempo.

En un servidor Linux que esté siempre encendido, puedes instalar la pasarela como servicio del sistema para que se inicie au­to­má­ti­ca­me­n­te al arrancar el servidor:

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

Para comprobar su estado, utiliza:

sudo hermes gateway status --system
bash

Puedes consultar los mensajes del registro en tiempo real con:

journalctl -u hermes-gateway -f
bash

systemd mantiene la pasarela eje­cu­tá­n­do­se en segundo plano y permite que vuelva a iniciarse au­to­má­ti­ca­me­n­te después de reiniciar el servidor. Hermes distingue entre un servicio de usuario, pensado pri­n­ci­pa­l­me­n­te para or­de­na­do­res pe­r­so­na­les y de de­sa­rro­llo, y un servicio del sistema para se­r­vi­do­res que funcionan de forma pe­r­ma­ne­n­te y sin interfaz gráfica.

En un VPS, evita ejecutar Hermes con permisos de ad­mi­ni­s­tra­dor si no es necesario. Siempre que sea posible, utiliza un usuario de Linux es­pe­cí­fi­co sin acceso root ilimitado.

Ejecutar Hermes con Docker como al­te­r­na­ti­va

Docker permite ejecutar apli­ca­cio­nes en co­n­te­ne­do­res aislados del sistema host. Esto facilita la ejecución pe­r­ma­ne­n­te de Hermes y puede limitar el acceso directo de los procesos del agente al sistema del servidor, aunque el grado de ai­s­la­mie­n­to depende de cómo co­n­fi­gu­res el co­n­te­ne­dor y los volúmenes.

Después de completar la co­n­fi­gu­ra­ción inicial, puedes iniciar el co­n­te­ne­dor oficial de Hermes en segundo plano, por ejemplo, con:

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  nousresearch/hermes-agent gateway run
bash

La opción --restart unless-stopped hace que Docker vuelva a iniciar el co­n­te­ne­dor después de un fallo o un reinicio del servidor, siempre que no lo hayas detenido ex­pre­sa­me­n­te. El di­re­c­to­rio ~/.hermes montado en /opt/data permite conservar fuera del co­n­te­ne­dor los datos de Hermes, como la co­n­fi­gu­ra­ción, las sesiones y las cre­de­n­cia­les.

Consejo

Docker no es necesario para conectar Hermes con Telegram. Si estás empezando, suele resultar más sencillo utilizar una in­s­ta­la­ción normal de Hermes junto con el servicio systemd que genera el propio programa.

Proteger la pasarela de Telegram en el servidor

Para conectar Hermes con Telegram, no­r­ma­l­me­n­te no es necesario abrir ningún puerto público en el servidor. De forma pre­de­te­r­mi­na­da, la pasarela utiliza long polling: Hermes establece una conexión saliente con los se­r­vi­do­res de Telegram y consulta pe­rió­di­ca­me­n­te si hay mensajes nuevos. Por tanto, Telegram no necesita acceder di­re­c­ta­me­n­te al servidor desde Internet.

Si utilizas Telegram como única interfaz de acceso, no conviene exponer pú­bli­ca­me­n­te el puerto interno de la API de Hermes. Cada puerto adicional abierto hace que un servicio del servidor sea accesible desde Internet y puede aumentar la su­pe­r­fi­cie de ataque.

Co­m­pro­ba­cio­nes de seguridad para un fu­n­cio­na­mie­n­to continuo

Antes de ejecutar la pasarela de forma pe­r­ma­ne­n­te, comprueba lo siguiente:

  • El token del bot de Telegram está al­ma­ce­na­do úni­ca­me­n­te en la co­n­fi­gu­ra­ción protegida de Hermes.
  • TELEGRAM_ALLOWED_USERS contiene solo los ID numéricos de las personas au­to­ri­za­das ex­pre­sa­me­n­te.
  • GATEWAY_ALLOW_ALL_USERS no está activado.
  • Hermes no se ejecuta con permisos root o de ad­mi­ni­s­tra­dor si no es necesario.
  • Los puertos del servidor y de la API que no sean ne­ce­sa­rios pe­r­ma­ne­cen cerrados.
  • Las cre­de­n­cia­les no se almacenan en re­po­si­to­rios públicos de Git ni en archivos de registro ac­ce­si­bles pú­bli­ca­me­n­te.
  • El sistema operativo y Hermes Agent se mantienen ac­tua­li­za­dos.
  • Siempre que sea posible, las he­rra­mie­n­tas con un acceso amplio a archivos o al terminal se ejecutan en un entorno aislado.

Para in­s­ta­la­cio­nes de pro­du­c­ción, puedes utilizar, por ejemplo, un backend de terminal aislado basado en Docker. De este modo, los comandos eje­cu­ta­dos por el agente se ejecutan dentro de un co­n­te­ne­dor en lugar de hacerlo di­re­c­ta­me­n­te en el sistema del servidor. Este ai­s­la­mie­n­to no sustituye a la lista de usuarios au­to­ri­za­dos de Telegram ni a la pro­te­c­ción del token del bot, sino que añade una capa de seguridad adicional.

Servidor virtual / VPS
IONOS VPS a un precio in­me­jo­ra­ble: ahora aún mejor
  • NUEVO: Escala de forma flexible con VM-Cloning, Load Balancing, nuevas opciones de al­ma­ce­na­mie­n­to y más.
  • Tráfico ilimitado, > 99,99 % de di­s­po­ni­bi­li­dad
  • Atención 24/7 con asesor personal

Co­n­clu­sión

Para conectar Hermes Agent con Telegram solo necesitas crear un bot mediante BotFather, obtener su token secreto y conocer tu ID numérico de usuario de Telegram. El comando hermes gateway setup te guía durante la co­n­fi­gu­ra­ción y permite re­s­tri­n­gir el acceso a los usuarios au­to­ri­za­dos.

Después de realizar una primera prueba, puedes instalar la pasarela como servicio en segundo plano y ma­n­te­ne­r­la activa de forma pe­r­ma­ne­n­te. Si ejecutas Hermes en un servidor Linux o VPS, podrás seguir ac­ce­die­n­do al agente aunque tu propio ordenador esté apagado. Lo más im­po­r­ta­n­te es mantener en secreto el token del bot, autorizar úni­ca­me­n­te los ID de usuario ne­ce­sa­rios y, siempre que sea posible, aislar del sistema principal las he­rra­mie­n­tas del agente con acceso al terminal o a los archivos.

Ir al menú principal