Comment connecter OpenClaw à Discord

En bref. Dans le Discord Developer Portal, créez une application, ouvrez Bot, appuyez sur Reset Token pour obtenir le token et activez Message Content Intent. Invitez le bot sur un serveur où vous êtes, activez Developer Mode dans Discord et copiez votre propre ID utilisateur. Donnez ensuite le token à OpenClaw et n’autorisez que votre ID utilisateur. Sur PlayNHost, ce sont deux champs sur la page Agent, et un redémarrage ; le panel installe pour vous le connecteur Discord d’OpenClaw.

Vérifié le 6 novembre 2026, exact pour OpenClaw 2026.11.1.

Ce guide suit la documentation de configuration Discord d’OpenClaw et le panel PlayNHost tel qu’il fonctionne aujourd’hui.

Étape 1 : créer l’application Discord et le bot

1. Ouvrez le Discord Developer Portal, appuyez sur New Application et donnez-lui un nom.
2. Ouvrez Bot dans la barre latérale et réglez le Username du bot sur le nom de votre agent.
3. Toujours sur Bot, sous Privileged Gateway Intents, activez :
   • Message Content Intent : indispensable ici. OpenClaw le demande à Discord, et Discord refuse la connexion (« disallowed intents ») quand il est désactivé.
   • Server Members Intent : recommandé par OpenClaw, nécessaire pour les listes autorisées par rôle et pour associer des noms à des ID.
   • Presence Intent : facultatif, uniquement pour les mises à jour de présence.
4. Appuyez sur Reset Token et copiez le token. Malgré son nom, le premier appui crée votre premier token. Gardez-le privé.

Étape 2 : inviter le bot et autoriser les DM

1. Ouvrez OAuth2, puis l’OAuth2 URL Generator. Cochez les scopes bot et applications.commands.
2. Sous Bot Permissions, cochez au moins View Channels, Send Messages, Read Message History, Embed Links et Attach Files (Add Reactions est facultatif).
3. Ouvrez l’URL générée, choisissez votre serveur et appuyez sur Continue. Un serveur privé avec seulement vous et le bot est le plus simple.
4. Autorisez le bot à vous écrire : faites un clic droit sur l’icône du serveur, ouvrez Privacy Settings et activez Direct Messages.

Étape 3 : copier votre ID utilisateur Discord

Dans Discord, ouvrez User Settings, puis Developer, et activez Developer Mode (sur mobile : App Settings, Advanced). Faites ensuite un clic droit sur votre propre avatar ou nom et choisissez Copy User ID. C’est un long nombre (PlayNHost accepte 17 à 20 chiffres).

La doc Discord d’OpenClaw utilise Developer Mode pour cela, et le panel aussi : contrairement à la configuration de Telegram, la Console ne vous demande pas de lire votre ID dans une réponse du bot.

Étape 4 sur PlayNHost : collez le token et votre ID

1. Ouvrez votre serveur sur panel.playnhost.com, puis l’onglet Agent. Définissez une clé de fournisseur d’IA sous Fournisseur d’IA si ce n’est pas déjà fait (voir quelle clé de fournisseur d’IA utiliser).
2. Sous Applis de chat, appuyez sur Définir pour Token du bot Discord, collez le token et appuyez sur Enregistrer. Le panel vérifie sa forme : un mauvais collage affiche « That is not a valid discord bot token. » (ce n’est pas un token de bot Discord valide).
3. Sous Qui peut lui écrire, saisissez votre ID dans ID utilisateur Discord et appuyez sur Enregistrer. Plusieurs ID se mettent sur une seule ligne, séparés par des virgules.
4. Appuyez sur Démarrer, ou sur Redémarrer maintenant si l’agent tourne déjà. Discord est un plugin OpenClaw à part : le premier démarrage avec un token Discord l’installe donc une fois. Parmi d’autres lignes, la Console affiche :

   [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.

   Dans notre test, l’installation du connecteur a pris environ 30 secondes. Les démarrages suivants le réutilisent et le mettent à jour quand OpenClaw lui-même est mis à jour.
5. Envoyez un message privé à votre bot dans Discord. Votre agent répond. Les autres comptes Discord sont ignorés.

Si vous laissez ID utilisateur Discord vide, la Console affiche « Discord: nobody can message your agent yet » (personne ne peut encore écrire à votre agent) et explique comment copier votre ID. Tant que vous ne l’ajoutez pas, toute personne qui envoie un DM au bot est ignorée ; OpenClaw répond à un premier message par un code de pairing : ignorez-le, il n’y a rien à approuver, et mettez plutôt votre ID utilisateur dans le volet Agent.

Ce que PlayNHost règle pour vous

• Les DM Discord utilisent dmPolicy: "allowlist" avec les ID du volet Agent (ou pairing tant que la liste est vide), et ces ID deviennent les propriétaires des commandes d’OpenClaw.
• Les canaux de serveur restent fermés : le groupPolicy par défaut d’OpenClaw est allowlist, et aucun serveur n’est sur cette liste tant qu’on n’en ajoute pas un aux réglages d’OpenClaw. Utilisez les messages privés.
• Le token parvient à OpenClaw sous le nom DISCORD_BOT_TOKEN dans son environnement. Un token écrit dans le fichier de réglages d’OpenClaw l’emporterait sur celui-là : le démarrage retire donc ce dernier.
• Le même serveur peut aussi parler sur Telegram : définissez les deux tokens et les deux listes d’ID. Voyez connecter OpenClaw à Telegram.

Étape 4 sur votre propre machine

1. Vérifiez que le plugin Discord est présent avec openclaw plugins list. Sur notre installation de test du paquet npm 2026.11.1, il n’était pas inclus ; ceci l’a ajouté :

   openclaw plugins install npm:@openclaw/discord

2. Mettez le token dans l’environnement du Gateway (jamais dans un chat) et faites pointer la configuration vers lui, en n’autorisant que vous :

   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 partie commands fait de vous le propriétaire pour les commandes réservées au propriétaire, ce que ne fait pas une liste autorisée écrite à la main. Pour une installation en service, mettez DISCORD_BOT_TOKEN dans ~/.openclaw/.env pour que le service l’ait, et redémarrez le service au lieu de lancer openclaw gateway.
3. Ou gardez le mode pairing par défaut : envoyez un DM au bot, puis approuvez le code dans l’heure :

   openclaw pairing list discord
   openclaw pairing approve discord <CODE>

Quand il ne répond pas

Pas encore installé ? Créez un serveur OpenClaw.

PlayNHost n’est pas affilié à l’OpenClaw Foundation. OpenClaw est un logiciel open source sous licence MIT.