Come collegare OpenClaw a Discord

Risposta breve. Nel Discord Developer Portal crea un'applicazione, apri Bot, premi Reset Token per ottenere il token e attiva Message Content Intent. Invita il bot in un server di cui fai parte, attiva Developer Mode in Discord e copia il tuo ID utente. Poi dai il token a OpenClaw e consenti solo il tuo ID utente. Su PlayNHost sono due campi nella pagina Agente, e un riavvio; il pannello installa per te il connettore Discord di OpenClaw.

Verificato il 6 novembre 2026, valido per OpenClaw 2026.11.1.

Questa guida segue la documentazione di configurazione Discord di OpenClaw e il pannello PlayNHost così come funziona oggi. Le interfacce di Discord sono mostrate con i nomi inglesi, come le vedi sullo schermo.

Passo 1: crea l'applicazione Discord e il bot

1. Apri il Discord Developer Portal, premi New Application e dagli un nome.
2. Apri Bot nella barra laterale e imposta lo Username del bot al nome del tuo agente.
3. Sempre in Bot, sotto Privileged Gateway Intents, attiva:
   • Message Content Intent: obbligatorio qui. OpenClaw lo chiede a Discord, e Discord rifiuta la connessione ("disallowed intents") quando è disattivato.
   • Server Members Intent: consigliato da OpenClaw, serve per le allowlist di ruoli e per associare i nomi agli ID.
   • Presence Intent: facoltativo, solo per gli aggiornamenti di presenza.
4. Premi Reset Token e copia il token. Nonostante il nome, la prima pressione crea il tuo primo token. Tienilo privato.

Passo 2: invita il bot e consenti i DM

1. Apri OAuth2, poi OAuth2 URL Generator. Spunta gli scope bot e applications.commands.
2. Sotto Bot Permissions, spunta almeno View Channels, Send Messages, Read Message History, Embed Links e Attach Files (Add Reactions è facoltativo).
3. Apri l'URL generato, scegli il tuo server e premi Continue. Un server privato con solo te e il bot è la soluzione più semplice.
4. Lascia che il bot possa scriverti: fai clic destro sull'icona del server, apri Privacy Settings e attiva Direct Messages.

Passo 3: copia il tuo ID utente Discord

In Discord apri User Settings, poi Developer, e attiva Developer Mode (su mobile: App Settings, Advanced). Poi fai clic destro sul tuo avatar o nome e scegli Copy User ID. È un numero lungo (PlayNHost accetta da 17 a 20 cifre).

La documentazione Discord di OpenClaw usa Developer Mode per questo, e lo fa anche il pannello: a differenza della configurazione Telegram, la console non ti chiede di leggere il tuo ID da una risposta del bot.

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

1. Apri il tuo server su panel.playnhost.com, poi la scheda Agente. Imposta una chiave del provider IA sotto Provider IA se non l'hai ancora fatto (vedi quale chiave di provider IA usare).
2. Sotto App di chat, premi Imposta su Token del bot Discord, incolla il token e premi Salva. Il pannello ne controlla la forma; un incolla sbagliato riceve "That is not a valid discord bot token."
3. Sotto Chi può scrivergli, inserisci il tuo ID in ID utente Discord e premi Salva. Più ID vanno sulla stessa riga, separati da virgole.
4. Premi Avvia, oppure Riavvia ora se l'agente è già in esecuzione. Discord è un plugin OpenClaw separato, quindi il primo avvio con un token Discord lo installa una volta sola. Tra le altre righe, la console mostra:

   [PlayNHost] Installing the Discord connector 2026.11.1
   [PlayNHost] Starting OpenClaw 2026.11.1
   [PlayNHost] Your agent is running
   [PlayNHost] Discord: only user 123456789012345678 can message your agent.

   Nel nostro test l'installazione del connettore ha richiesto circa 30 secondi. Gli avvii successivi lo riutilizzano e lo aggiornano quando viene aggiornato OpenClaw stesso.
5. Manda al tuo bot un messaggio diretto in Discord. Il tuo agente risponde. Gli altri account Discord vengono ignorati.

Se lasci vuoto ID utente Discord, la console dice "Discord: nobody can message your agent yet" e spiega come copiare il tuo ID. Finché non lo aggiungi, chiunque scriva in DM al bot viene ignorato; OpenClaw risponde a un primo messaggio con un codice di abbinamento: ignoralo, non c'è nulla da approvare, e inserisci invece il tuo ID utente nel riquadro Agente.

Che cosa imposta PlayNHost per te

• I DM di Discord usano dmPolicy: "allowlist" con gli ID del riquadro Agente (oppure pairing finché l'elenco è vuoto), e quegli ID diventano i proprietari dei comandi di OpenClaw.
• I canali dei server restano chiusi: il groupPolicy predefinito di OpenClaw è allowlist, e nessun server è in quell'elenco finché non ne viene aggiunto uno alle impostazioni di OpenClaw. Usa i messaggi diretti.
• Il token arriva a OpenClaw come DISCORD_BOT_TOKEN nel suo ambiente. Un token scritto nel file di impostazioni di OpenClaw avrebbe la precedenza, quindi l'avvio rimuove quello.
• Lo stesso server può parlare anche su Telegram: imposta entrambi i token ed entrambi gli elenchi di ID. Vedi collegare OpenClaw a Telegram.

Passo 4 sulla tua macchina

1. Controlla che il plugin Discord ci sia con openclaw plugins list. Nella nostra installazione di prova del pacchetto npm 2026.11.1 non era incluso; questo comando lo ha aggiunto:

   openclaw plugins install npm:@openclaw/discord

2. Metti il token nell'ambiente del Gateway (mai in una chat) e fai puntare la configurazione a esso, consentendo solo te stesso:

   export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
   cat > discord.patch.json5 <<'JSON5'
   {
     channels: {
       discord: {
         enabled: true,
         token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },
         dmPolicy: "allowlist",
         allowFrom: ["123456789012345678"],
       },
     },
     commands: {
       ownerAllowFrom: ["discord:123456789012345678"],
     },
   }
   JSON5
   openclaw config patch --file ./discord.patch.json5 --dry-run
   openclaw config patch --file ./discord.patch.json5
   openclaw gateway

   La parte commands ti rende il proprietario per i comandi riservati, cosa che una allowlist scritta a mano non fa. Per un'installazione come servizio, metti DISCORD_BOT_TOKEN in ~/.openclaw/.env così il servizio lo ha, e riavvia il servizio invece di eseguire openclaw gateway.
3. Oppure tieni la modalità pairing predefinita: scrivi in DM al bot, poi approva il codice entro un'ora:

   openclaw pairing list discord
   openclaw pairing approve discord <CODE>

Quando non risponde

Non hai ancora configurato nulla? Crea un server OpenClaw.

PlayNHost non è affiliata alla OpenClaw Foundation. OpenClaw è un software open source con licenza MIT.