Cómo conectar Hermes Agent a Discord

Respuesta corta. Crea una aplicación y un bot en el Discord Developer Portal, activa Message Content Intent y Server Members Intent, copia el token del bot con Reset Token, invita al bot a tu servidor y luego dale a Hermes Agent el token y tu ID de usuario de Discord. Solo los IDs de su lista de permitidos pueden hablar con él. En tu propia máquina eso son DISCORD_BOT_TOKEN y DISCORD_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 Discord y de seguridad de Hermes Agent y el panel de PlayNHost tal como funciona hoy. La compatibilidad con Discord viene integrada en el gateway de mensajería de Hermes Agent.

Paso 1: crea la aplicación y el bot

1. Abre el Discord Developer Portal, pulsa New Application, ponle nombre y pulsa Create. Anota el Application ID de la página General Information.
2. Abre Bot en el menú de la izquierda. En Authorization Flow, activa Public Bot si quieres usar el enlace de invitación del propio Discord (paso 2), y deja Require OAuth2 Code Grant desactivado.
3. En Privileged Gateway Intents, activa Message Content Intent y Server Members Intent y pulsa Save Changes. La documentación de Hermes Agent marca ambos como obligatorios: sin Message Content Intent, Discord rechaza la conexión del bot y nunca se pone en línea. Presence Intent es opcional.
4. En Token, pulsa Reset Token y copia el token. Discord lo muestra una sola vez. Mantenlo en privado: quien lo tenga controla tu bot.

Paso 2: invita al bot a tu servidor

Usa Installation (Guild Install, Discord Provided Link, ámbitos bot y applications.commands, y los permisos que se indican abajo), o construye tú el enlace con el Application ID del paso 1:

https://discord.com/oauth2/authorize?client_id=YOUR_APP_ID&scope=bot+applications.commands&permissions=309237763136

309237763136 es el conjunto de permisos que recomienda la documentación de Hermes Agent: View Channels, Send Messages, Embed Links, Attach Files, Read Message History, Create Public Threads, Send Messages in Threads y Add Reactions. Abre el enlace, elige tu servidor y pulsa Authorize. Necesitas el permiso Manage Server en ese servidor.

Paso 3: encuentra tu ID de usuario de Discord

1. En Discord, abre Settings, Advanced, y activa Developer Mode.
2. Haz clic derecho en tu propio nombre y elige Copy User ID. Es un número largo, como 284102345871466496.

Este es tu ID de usuario, no el Application ID del bot ni el ID de un servidor o de un canal.

Paso 4 en PlayNHost: pega el token y tu ID

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 Discord, pega el token y pulsa Guardar. La fila muestra entonces solo los últimos cuatro caracteres; el token no se vuelve a mostrar.
4. En Quién puede escribirle, pega tu ID en IDs de usuario de Discord y pulsa Guardar. Varios IDs van en una sola línea, separados por comas o espacios.
5. Pulsa Iniciar, o Reiniciar ahora si el agente ya está en marcha (“Los cambios se aplican la próxima vez que se inicie tu agente.”). Cuando está en marcha, la consola lo confirma:

   [PlayNHost] Your agent is running
   [PlayNHost] Discord: only user 284102345871466496 can message your agent.

6. Envía un mensaje directo al bot, o menciónalo con @ en un canal que pueda ver. Tu agente responde: en un mensaje directo, allí mismo; en un canal, en un hilo nuevo bajo tu mensaje.

Si empiezas con el campo IDs de usuario de Discord vacío, la consola dice “Discord: nobody can message your agent yet” y te pide que envíes un mensaje al bot: un mensaje directo de alguien que no está en la lista se ignora, y la consola imprime entonces una línea con el ID de ese remitente para que lo añadas. Developer Mode es la forma más rápida.

Telegram y Discord pueden funcionar a la vez en el mismo agente: define los dos tokens y las dos listas de IDs.

Cómo se comporta Hermes Agent en Discord

• Mensajes directos: responde a todos los mensajes, sin necesidad de mención, con una conversación por cada mensaje directo.
• Canales del servidor: responde solo cuando lo mencionas con @, y por defecto abre un hilo nuevo por cada mención y responde allí. Personas distintas en un mismo canal tienen conversaciones separadas.
• Otras personas: en PlayNHost, solo se responde a los IDs de usuario de la página Agente. Los permisos por rol, los interruptores de permitir a todos y el acceso entre bots se desactivan en cada arranque.

Paso 4 en tu propia máquina

1. Ejecuta el asistente de configuración y elige Discord. La documentación de Hermes Agent dice que comprueba el token con Discord, comprueba los intents, imprime el enlace de invitación y se ofrece a darte permiso:

   hermes gateway setup

2. O añade los valores a mano a ~/.hermes/.env:

   DISCORD_BOT_TOKEN=your-bot-token
   DISCORD_ALLOWED_USERS=284102345871466496

3. Arráncalo con hermes gateway. Para un gateway que siga funcionando al cerrar la sesión, mira cómo ejecutar Hermes Agent 24/7.

Cuando no responde

En PlayNHost, el registro propio de Hermes Agent es .hermes/logs/gateway.log en Files. ¿Quieres Telegram también? Mira conectar Hermes Agent a Telegram. ¿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.