Configurer Discord dans OpenClaw
Créer l’application et le bot, les trois intentions privilégiées, l’URL d’invitation et les permissions de base, le mode développeur et les trois identifiants, les messages privés des membres du serveur, le correctif de jeton SecretRef, l’appairage par discussion ou en ligne de commande, la règle du jeton en double, fonctionner sans Message Content, et transformer un serveur privé en espace de travail de serveur
La configuration Discord est plus longue que celle de Telegram parce que le bot a besoin d’une application, d’intentions, d’une invitation avec permissions et de trois identifiants avant de pouvoir dire bonjour. La documentation d’OpenClaw la parcourt dans l’ordre puis montre la seconde moitié que la plupart veulent : un serveur privé où chaque canal est sa propre session d’agent. Voici la configuration rapide, les règles des jetons, et l’espace de travail de serveur.
Application, intentions, invitation
- Dans le portail des développeurs, vous créez une nouvelle application, ouvrez la page Bot et réglez le nom d’utilisateur sur celui de votre agent, puis sous les intentions de passerelle privilégiées vous activez Message Content, requise pour les messages de serveur normaux, Server Members, recommandée et requise pour les listes de rôles, la correspondance nom vers identifiant et les groupes d’accès par audience de canal, et facultativement Presence pour les mises à jour de présence.
- Le bouton de réinitialisation du jeton sur la page Bot génère votre premier jeton malgré son nom ; puis le générateur d’URL OAuth2 prend les portées bot et commandes d’application et, dans la section des permissions qui apparaît, au moins voir les canaux, envoyer des messages, lire l’historique, intégrer des liens et joindre des fichiers, facultativement ajouter des réactions, et envoyer des messages dans les fils si le bot doit publier dans des fils ou dans des flux de canaux forum et média, après quoi vous ouvrez l’URL générée, choisissez votre serveur et continuez.
- Le mode développeur de l’application Discord vous laisse copier les identifiants : clic droit sur l’icône du serveur pour copier l’identifiant du serveur et sur votre propre avatar pour copier votre identifiant d’utilisateur, à garder avec le jeton ; pour que l’appairage fonctionne, les réglages de confidentialité du serveur doivent autoriser les messages privés des membres, ce que vous pouvez désactiver après l’appairage si vous n’utilisez que les canaux de serveur.
- Le jeton est un secret réglé sur la machine qui fait tourner OpenClaw avant d’écrire à l’agent : exportez-le, écrivez un correctif qui active le canal avec une référence de secret d’environnement, lancez la commande de correctif de configuration à blanc puis pour de vrai, et démarrez la passerelle ; un service en arrière-plan se redémarre depuis l’application Mac ou en relançant le processus d’exécution de la passerelle, un service géré s’installe depuis un shell où la variable est définie ou la lit dans le fichier d’environnement d’OpenClaw, et un hôte bloqué ou limité par la recherche d’application au démarrage de Discord peut régler l’identifiant d’application pour que le démarrage saute cet appel REST.
La mémoire à long terme (MEMORY.md) ne se charge automatiquement que dans les sessions de messages privés ; les canaux de serveur ne la chargent pas.
Appairage et jetons
Vous terminez la configuration soit en disant à votre agent sur un canal existant que le jeton est dans la configuration et en lui donnant vos identifiants d’utilisateur et de serveur, soit par la configuration, où le même bloc JSON5 s’applique avec la commande de correctif, les jetons en clair fonctionnant aussi, et les valeurs SecretRef étant prises en charge par les fournisseurs d’environnement, de fichier, d’exécution et de magasin. Plusieurs bots gardent leur jeton et leur identifiant d’application sous leur propre compte, puisqu’un identifiant d’application de premier niveau est hérité et n’y a sa place que si tous les comptes le partagent. Une fois la passerelle en route, un message privé au bot renvoie un code d’appairage que vous approuvez en l’envoyant à votre agent ou avec les commandes de liste et d’approbation d’appairage, et les codes expirent après une heure. Si Discord ne peut pas accorder Message Content, OpenClaw fonctionne encore en messages privés et dans les canaux de serveur où les utilisateurs mentionnent explicitement le bot : réglez l’intention de contenu des messages sur faux pour que la passerelle ne demande pas l’intention indisponible, gardez la mention obligatoire sur chaque canal configuré, et acceptez que Discord omette le contenu rédigé par les utilisateurs dans les autres messages de serveur. La résolution des jetons dépend du compte, les valeurs de configuration l’emportent sur le repli d’environnement et la variable de jeton ne sert que le compte par défaut ; quand deux comptes activés se résolvent vers le même jeton, OpenClaw ne démarre qu’un moniteur pour lui, un jeton issu de la configuration bat le repli d’environnement, sinon le premier compte activé l’emporte et le doublon est signalé désactivé avec une raison de jeton de bot en double ; et un jeton explicite par appel sur les actions sortantes avancées s’applique à cet appel tandis que les réglages de politique et de nouvelles tentatives viennent toujours du compte sélectionné.
L’espace de travail de serveur
- Ajouter votre serveur à la liste des serveurs, en le demandant à l’agent ou en réglant une politique de groupe en liste avec votre identifiant de serveur, la mention obligatoire et votre identifiant d’utilisateur sous les serveurs, laisse l’agent répondre dans n’importe quel canal du serveur plutôt que seulement en messages privés.
- Par défaut l’agent ne répond dans les canaux de serveur que lorsqu’il est mentionné, et sur un serveur privé vous voulez probablement chaque message : réglez la mention obligatoire sur faux, ou pour les salles partagées toujours actives optez pour les réponses visibles par l’outil de message afin que l’agent observe et ne publie que lorsqu’il juge une réponse utile, ce qui marche le mieux avec les derniers modèles fiables avec les outils ; si Discord montre la frappe et que les journaux montrent une consommation de jetons sans rien de publié, vérifiez si le tour était un événement ambiant de salle ou avait opté pour les réponses par l’outil de message, et les avis de session occupée suivent la même politique, journalisés plutôt que publiés.
- La mémoire à long terme ne se charge automatiquement que dans les sessions de messages privés, donc pour les canaux de serveur vous dites à l’agent d’utiliser les outils de recherche et de lecture de mémoire quand il a besoin de contexte à long terme, ou vous placez des instructions stables dans les fichiers d’agents ou d’utilisateur injectés dans chaque session en gardant les notes dans le fichier de mémoire pour un accès à la demande ; puis vous créez des canaux et discutez, puisque l’agent voit le nom du canal et que chaque canal est une session isolée.
OpenClaw sur Discord est le billet du canal auquel cette configuration appartient, et Le contrôle d’accès Discord d’OpenClaw le modèle de listes sur lequel l’espace de travail de serveur est bâti.
Un canal, une session
Le schéma du serveur privé est la raison pour laquelle la configuration vaut ses étapes supplémentaires : un canal de code, un canal maison et un canal de recherche deviennent chacun une session d’agent distincte avec le nom du canal pour contexte, ce qu’aucune configuration limitée aux messages privés ne peut offrir. Les événements ambiants de salle dans OpenClaw couvre le mode discret qui rend supportable une salle partagée toujours active, et Connecter votre premier canal en cinq minutes le parcours plus court pour un premier canal.
Sur Diali
Sur Diali, le canal Discord se connecte depuis le tableau de bord et la configuration d’exécution en est générée puis remplacée à chaque version, donc les étapes du portail au début de ce billet sont la partie qui reste de votre côté. Discord sur Diali décrit le canal sur Diali et La sécurité chez Diali la frontière que partage chaque canal connecté.
- Trois intentions, cinq permissions, trois identifiants, un jeton.
- Les codes d’appairage expirent après une heure ; le jeton ne passe jamais par la discussion.
- Un serveur privé fait de chaque canal sa propre session.
Arrêtez de lire, construisez le vôtre
Configurez un agent, choisissez un canal, et faites-le travailler dans l’application que vous gardez déjà ouverte.
