Clase 02 · Agentes

Instala Hermes y conéctalo a Telegram

práctica
01

Antes de instalar, las reglas

Ya escogiste a Hermes. Ahora va a vivir en tu computador, con acceso de verdad a tu máquina. Tres reglas desde el minuto uno: puerta cerrada, nada expuesto a internet, llaves en la caja fuerte.

02

Instálalo con un comando

Funciona en macOS y Linux. Python y sus dependencias las resuelve el instalador solo. Al final escribes hermes y se abre la consola del agente.

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashsource ~/.zshrc# abre la consola del agente:hermes
03

Revisa y congela la versión

hermes doctor confirma que todo quedó bien. A julio de 2026 Hermes va en v0.18 y cambia cada 2 o 3 semanas. Congela tu versión y actualiza cuando tú decidas.

hermes doctor# cuando decidas actualizar, tú mandas:hermes update
04

Crea tu bot con BotFather

En Telegram, BotFather te entrega el token de tu bot. Ese token es una llave de tu casa: va a la caja fuerte del Keychain, jamás a un archivo de texto.

DEL TOKEN AL PRIMER MENSAJE BotFatheren Telegramtokenla llave de tu botuna sola veztu computadortokencaja fuerteel Keychain de tu Macpasarelahermes gatewayescuchandousa la llave y atiende el chatsin puertos abiertos · nada entra desde afueratu mensajesu respuestatu botholaaquí estoy¿qué hacemos?tu chat de Telegramdesde donde estés la llave guardada, la pasarela adentro, y el bot contestando en tu chat.
El token va a la caja fuerte y la pasarela vive dentro de tu casa. Nada queda expuesto a internet.
05

El candado antes de compartir

Esto pasó de verdad: un bot sin lista de permitidos le daba a cualquiera acceso total a la máquina. La falla se documentó y ya viene corregida de fábrica. Igual: primero tu lista de permitidos, el allowlist por chat_id.

# en la config de Hermes, antes de compartir el bot:TELEGRAM_ALLOWED_USERS=tu_chat_id# varios ids van separados por coma
EL PORTERO DE TU BOT SIN LISTA DE PERMITIDOS?cualquiera que encuentre el bottu bot le responde a cualquiera$ tu terminal$ tus archivosacceso total: terminal, archivos, llavesCON ALLOWLISTchat_id en la lista?desconocidono está en la listano pasael portero: la lista de chat_idtu bot y tu máquinasolo entra quien está en la lista sin lista, cualquiera llega a tu máquina. con la lista, el portero decide.
Primero el candado, después compartes el bot. La lista de permitidos es tu portero.
06

Enciende la pasarela

La pasarela es el puente del agente con tu chat y vive dentro de tu computador. Enciéndela y escríbele a tu bot. Te responde. Tu primer agente vivo.

hermes gateway setuphermes gateway start
07

¿Y WhatsApp?

El puente no es oficial: emula WhatsApp Web y hay riesgo real de baneo. Si lo haces, usa un número dedicado. Nosotros compramos un chip aparte una sola vez. Para empezar, el canal serio es Telegram.

08

Lo que NO hicimos

No lo expusimos a internet. No le dimos el número personal. No compartimos el bot antes del candado. Ya tienes un agente escuchando. Lo que sigue: escogerle el cerebro.

Volver a Agentes

hecho con mucho amor

espero les sea útil

santa-ia · 2026 · @santaia.lab