Hermes Relay — Conectar Instancias | Easy Understand Hermes Agent

Piensa en Hermes Relay como una cabina telefónica que te devuelve la llamada — no necesitas dar tu dirección, solo marcas una vez, y el otro lado puede contactarte en cualquier momento a través de esa misma línea.

¿Qué es Hermes Relay?

Hermes Relay es un sistema de conectores para la puerta de enlace de Hermes Agent. Permite que tu puerta de enlace hable con plataformas de mensajería como Discord, Telegram o Slack sin tener que almacenar sus tokens de bot o contraseñas.

En su lugar, un servicio separado (el “conector”) es el dueño de esas credenciales. Tu puerta de enlace simplemente se conecta al conector a través de una única conexión WebSocket segura — y luego todos los mensajes fluyen de un lado a otro por esa misma línea abierta.

¿Por qué es útil?

Aquí están las grandes ventajas, en palabras sencillas:

No necesitas abrir puertos. Tu puerta de enlace funciona incluso detrás de un router doméstico o un firewall en la nube. Solo realiza conexiones salientes, así que no tienes que exponer nada a internet.
Sin secretos de bots en tu máquina. El conector guarda todos los tokens de las plataformas. Si roban tu puerta de enlace, el atacante no obtiene nada útil.
Una puerta de enlace, muchas plataformas. El conector le dice a tu puerta de enlace qué puede hacer (longitud de mensaje, markdown, edición, hilos, etc.) en el momento en que se conectan. Sin reglas fijas — simplemente se adapta.

Cuándo usarlo: Si estás ejecutando tus propios bots directamente, omite Relay y usa los adaptadores nativos (Telegram, Discord). Relay es para configuraciones donde un conector compartido o alojado gestiona el lado de la plataforma — como hosting multi-tenant o cuando simplemente no quieres tokens en tu máquina.

Cómo inscribir tu puerta de enlace

La inscripción es una configuración única. Ejecutas un solo comando, y Hermes hace el resto.

Primero, asegúrate de tener un token de inscripción (emitido por tu proveedor de conectores). Luego ejecuta:

hermes gateway enroll \
  --token <enrollment-token> \
  --connector-url wss://connector.example.com/relay

Esto es lo que sucede paso a paso:

Hermes verifica tu inicio de sesión existente (~/.hermes/auth.json) para demostrar a qué organización perteneces.
Si has configurado tu propio proveedor de identidad (para entornos aislados o autoalojados), usa ese en su lugar.
Envía el token de inscripción al endpoint /relay/enroll del conector a través de TLS.
El conector verifica que el token sea válido, de un solo uso y que coincida con tu tenant.
Luego emite un secreto por puerta de enlace y una clave de entrega — y los devuelve una sola vez.
Hermes los guarda en ~/.hermes/.env:

GATEWAY_RELAY_ID
GATEWAY_RELAY_SECRET
GATEWAY_RELAY_DELIVERY_KEY

Eso es todo. Tu puerta de enlace ahora está “inscrita” y puede conectarse al conector cuando lo necesite.

¿Qué pasa después?

Una vez inscrita, tu puerta de enlace:

Se conectará a la URL del conector que proporcionaste
Recibirá un descriptor de capacidades (lo que la plataforma frontal puede hacer)
Comenzará a intercambiar mensajes y acciones normalizados a través de ese mismo socket

Sin puertos de entrada, sin credenciales adicionales, sin código específico de plataforma.

Resumen y consejo práctico

Resumen: Hermes Relay es una forma limpia de conectar tu puerta de enlace a plataformas de mensajería sin tener sus credenciales ni abrir puertos. Es perfecto para hosting compartido, entornos NAT o cualquier configuración donde quieras mantener los secretos fuera de tu máquina principal.

Consejo práctico: Mantén siempre tu token de inscripción de un solo uso y de corta duración. Si alguna vez necesitas rotar credenciales, simplemente vuelve a ejecutar el comando de inscripción con un token nuevo — y recuerda eliminar el antiguo GATEWAY_RELAY_SECRET de tu archivo .env antes de actualizarlo. Un poco de higiene ayuda mucho.