Come collegare Hermes Agent a Discord

In breve. Crea un'applicazione e un bot nel Discord Developer Portal, attiva Message Content Intent e Server Members Intent, copia il token del bot con Reset Token, invita il bot nel tuo server, poi dai a Hermes Agent il token e il tuo ID utente Discord. Solo gli ID nella sua lista di utenti autorizzati possono parlargli. Sulla tua macchina si tratta di DISCORD_BOT_TOKEN e DISCORD_ALLOWED_USERS in ~/.hermes/.env, oppure di hermes gateway setup. Su PlayNHost incolli il token e il tuo ID nella pagina Agente e riavvii.

Verificato il 7 novembre 2026, valido per Hermes Agent v0.23.0.

Questa guida usa la documentazione di Hermes Agent su Discord e sulla sicurezza e il pannello PlayNHost così come funziona oggi. Il supporto a Discord è integrato nel gateway di messaggistica di Hermes Agent.

Passo 1: crea l'applicazione e il bot

1. Apri il Discord Developer Portal, premi New Application, dagli un nome e premi Create. Annota l'Application ID nella pagina General Information.
2. Apri Bot nel menu a sinistra. Sotto Authorization Flow, imposta Public Bot su attivo se vuoi il link di invito di Discord (Passo 2), e lascia Require OAuth2 Code Grant disattivato.
3. Sotto Privileged Gateway Intents, attiva Message Content Intent e Server Members Intent, poi premi Save Changes. La documentazione di Hermes Agent li indica entrambi come obbligatori: senza Message Content Intent, Discord rifiuta la connessione del bot e questo non va mai online. Presence Intent è facoltativo.
4. Sotto Token, premi Reset Token e copia il token. Discord lo mostra una volta sola. Tienilo privato: chiunque lo abbia controlla il tuo bot.

Passo 2: invita il bot nel tuo server

Usa Installation (Guild Install, Discord Provided Link, scope bot e applications.commands, e i permessi elencati qui sotto), oppure costruisci tu il link con l'Application ID del Passo 1:

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

309237763136 è l'insieme di permessi consigliato dalla documentazione di Hermes Agent: View Channels, Send Messages, Embed Links, Attach Files, Read Message History, Create Public Threads, Send Messages in Threads e Add Reactions. Apri il link, scegli il tuo server e premi Authorize. Ti serve il permesso Manage Server su quel server.

Passo 3: trova il tuo ID utente Discord

1. In Discord, apri Settings, Advanced, e attiva Developer Mode.
2. Fai clic destro sul tuo nome e scegli Copy User ID. È un numero lungo, come 284102345871466496.

Questo è il tuo ID utente, non l'Application ID del bot e non l'ID di un server o di un canale.

Passo 4 su PlayNHost: incolla il token e il tuo ID

1. Apri il tuo server su panel.playnhost.com, poi la scheda Agente.
2. Sotto Provider IA, imposta una chiave se non l'hai ancora fatto (vedi quale chiave di un provider IA usare).
3. Sotto App di chat, premi Imposta su Token del bot Discord, incolla il token e premi Salva. La riga mostra poi solo gli ultimi quattro caratteri; il token non viene più mostrato.
4. Sotto Chi può scrivergli, incolla il tuo ID in ID utente Discord e premi Salva. Più ID vanno sulla stessa riga, separati da virgole o spazi.
5. Premi Avvia, oppure Riavvia ora se l'agente è già in esecuzione ("Le modifiche si applicano al prossimo avvio del tuo agente."). Quando è attivo, la console conferma:

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

6. Invia al bot un messaggio diretto, oppure menzionalo con @ in un canale che può vedere. Il tuo agente risponde: in un messaggio diretto proprio lì, in un canale in un nuovo thread sotto il tuo messaggio.

Se parti con il campo ID utente Discord vuoto, la console dice "Discord: nobody can message your agent yet" e ti chiede di inviare un messaggio al bot: un messaggio diretto da qualcuno non in lista viene ignorato, e la console stampa poi una riga con l'ID di quel mittente da aggiungere. Developer Mode è il modo più rapido.

Telegram e Discord possono funzionare sullo stesso agente nello stesso momento: imposta entrambi i token ed entrambe le liste di ID.

Come si comporta Hermes Agent su Discord

• Messaggi diretti: risponde a ogni messaggio, senza bisogno di menzione, con una conversazione per ogni DM.
• Canali del server: risponde solo quando lo menzioni con @ e, per impostazione predefinita, apre un nuovo thread per ogni menzione e risponde lì. Persone diverse nello stesso canale hanno conversazioni separate.
• Altre persone: su PlayNHost vengono servite solo le richieste degli ID utente nella pagina Agente. I permessi per ruolo, gli interruttori "consenti tutti" e l'accesso da bot a bot sono disattivati a ogni avvio.

Passo 4 sulla tua macchina

1. Lancia la procedura guidata e scegli Discord. La documentazione di Hermes Agent dice che controlla il token con Discord, controlla gli intent, stampa il link di invito e propone di autorizzarti:

   hermes gateway setup

2. Oppure aggiungi i valori a mano in ~/.hermes/.env:

   DISCORD_BOT_TOKEN=your-bot-token
   DISCORD_ALLOWED_USERS=284102345871466496

3. Avvialo con hermes gateway. Per un gateway che resta attivo dopo il logout, vedi come eseguire Hermes Agent 24/7.

Quando non risponde

Su PlayNHost, il log di Hermes Agent è .hermes/logs/gateway.log in Files. Vuoi anche Telegram? Vedi collegare Hermes Agent a Telegram. Non l'hai ancora configurato? Crea un server Hermes Agent.

PlayNHost non è affiliato a Nous Research. Hermes Agent è un software open source con licenza MIT.