Skill Discord pour OpenClaw

Présentation du Skill Discord d'OpenClaw

Le skill Discord connecte OpenClaw à vos serveurs Discord via l'API Discord, transformant votre agent IA en un puissant assistant Discord. Une fois installé, vous pouvez envoyer des messages, gérer des fils de discussion, lancer des sondages, importer des emojis et même gérer la modération — le tout grâce à des commandes en langage naturel.

Discord est l'une des plateformes les plus populaires pour les communautés de développeurs, les projets open source et la communication d'équipe. Le skill Discord d'OpenClaw élimine le besoin de basculer entre votre terminal et Discord. Que vous surveilliez les canaux communautaires, répondiez à des questions ou gériez les paramètres du serveur, une simple conversation avec OpenClaw suffit.

Flux de travail typique :

1. Demandez à OpenClaw d'envoyer un message ou de vérifier l'activité récente dans un canal Discord.
2. L'agent appelle l'API Discord avec l'action appropriée (par exemple, sendMessage, readMessages).
3. Les résultats sont renvoyés sous forme de résumé lisible — aucun changement de contexte nécessaire.

Prérequis pour le Skill Discord

Avant d'installer le skill Discord, assurez-vous de disposer de :

• OpenClaw installé et en cours d'exécution (v1.0+)
• Un compte Discord avec accès aux serveurs que vous souhaitez gérer
• Un bot Discord créé dans le Portail Développeur avec un jeton de bot
• Le bot invité sur votre serveur avec les permissions nécessaires
• clawhub CLI installé pour la gestion des skills

Vérifiez votre configuration :

# Vérifier la version d'OpenClaw
openclaw --version

# Vérifier le CLI clawhub
clawhub --version

Créer un Bot Discord

Si vous ne possédez pas encore de bot, suivez ces étapes :

1. Rendez-vous sur le Portail Développeur Discord et cliquez sur New Application.
2. Accédez à l'onglet Bot et cliquez sur Add Bot.
3. Copiez le jeton du bot — vous en aurez besoin pour la configuration.
4. Sous Privileged Gateway Intents, activez Message Content Intent si vous avez besoin que le skill puisse lire le contenu des messages.
5. Utilisez le OAuth2 URL Generator pour créer un lien d'invitation avec le scope bot et les permissions nécessaires.

Comment Installer le Skill Discord

Installez le skill Discord avec une seule commande :

npx clawhub@latest install discord

Pour vérifier l'installation :

clawhub list

Vous devriez voir discord dans la liste des skills installés. Vous pouvez également prévisualiser le skill avant de l'installer avec clawhub inspect discord.

Configuration du Skill Discord

Le skill Discord nécessite un jeton de bot pour l'authentification. Créez un bot dans le Portail Développeur Discord si ce n'est pas déjà fait.

Configuration de l'Environnement

# Définir votre jeton de bot Discord
export DISCORD_BOT_TOKEN=your_bot_token_here

Important : Ne codez jamais les jetons en dur dans les fichiers de configuration. Utilisez des variables d'environnement ou un gestionnaire de secrets tel que 1Password.

Gateway Intents

Le skill utilise les Gateway Intents de Discord pour recevoir des événements. Trois intents sont privilégiés et doivent être activés dans le Portail Développeur :

| Intent | Objectif | Requis ? | |--------|----------|----------| | MESSAGE_CONTENT | Lire le texte des messages, les embeds et les pièces jointes | Oui, pour readMessages | | GUILD_MEMBERS | Accéder aux événements d'arrivée/départ des membres et aux listes de membres | Uniquement pour memberInfo | | GUILD_PRESENCES | Suivre le statut en ligne/hors ligne des utilisateurs | Rarement nécessaire |

Activez uniquement les intents requis par votre cas d'usage. Pour la plupart des configurations, MESSAGE_CONTENT seul suffit.

Contrôle des Actions

Le skill Discord prend en charge un contrôle granulaire des actions. La plupart des actions sont activées par défaut, mais les actions sensibles sont désactivées :

| Action | Par défaut | Description | |--------|------------|-------------| | discord.actions.moderation | false | Mise en sourdine, expulsion et bannissement des utilisateurs | | discord.actions.roles | false | Ajouter ou retirer des rôles aux membres |

Pour activer les actions de modération, mettez à jour votre configuration OpenClaw :

# Activer les actions de modération (à utiliser avec précaution)
openclaw config set discord.actions.moderation true

Exemples d'Utilisation du Skill Discord

1. Envoyer un Message dans un Canal

Vous : "Envoie un message dans le canal #announcements disant 'La version 2.0 est maintenant disponible ! Consultez les notes de version pour plus de détails.'"

L'agent utilise l'action sendMessage avec l'identifiant du canal cible. Il publie le message et confirme l'envoi avec le lien du message.

2. Surveiller les Questions de la Communauté

Vous : "Lis les 10 derniers messages dans #help-forum et résume les questions sans réponse."

L'agent appelle readMessages sur le canal spécifié, filtre les messages sans réponse et renvoie un résumé des questions sans réponse avec des liens vers chaque fil de discussion.

3. Lancer un Sondage Communautaire

Vous : "Crée un sondage dans #general demandant 'Quelle fonctionnalité devrions-nous développer ensuite ?' avec les options : Mode sombre, Application mobile, Améliorations de l'API, Meilleure documentation. Laisse-le ouvert pendant 24 heures."

L'agent crée un sondage en utilisant l'action poll avec jusqu'à 10 options de réponse. Il définit la durée et renvoie une confirmation avec le lien du sondage.

4. Importer un Emoji Personnalisé

Vous : "Importe cette image en tant qu'emoji personnalisé appelé 'ship_it' sur notre serveur."

L'agent utilise emojiUpload pour ajouter l'image (PNG/JPG/GIF, max 256 Ko) en tant qu'emoji du serveur. Il confirme l'import et affiche le code emoji :ship_it: pour l'utiliser dans les messages.

Sécurité et Bonnes Pratiques

Le skill Discord peut effectuer des opérations d'écriture sur vos serveurs, y compris l'envoi de messages et — si activé — des actions de modération. Suivez ces recommandations pour rester en sécurité :

• Appliquez le principe du moindre privilège. N'accordez au bot que les permissions dont il a réellement besoin. Évitez d'accorder la permission Administrator sauf en cas de nécessité absolue.
• Gardez la modération désactivée par défaut. Le skill désactive les actions moderation et roles par défaut. Ne les activez que si vous avez un besoin spécifique et comprenez les implications.
• Activez uniquement les intents requis. Les intents privilégiés comme MESSAGE_CONTENT et GUILD_MEMBERS ne devraient être activés que lorsque votre flux de travail en dépend.
• Renouvelez régulièrement votre jeton de bot. Si vous soupçonnez qu'un jeton a été compromis, régénérez-le immédiatement dans le Portail Développeur.
• Vérifiez avant de confirmer. OpenClaw demande une confirmation pour les actions destructives. Lisez toujours le résumé de l'action avant d'approuver, en particulier pour la modération et les opérations en masse.
• Auditez l'activité du bot. Utilisez le journal d'audit de Discord pour suivre les actions effectuées par votre bot et vérifier qu'elles correspondent à vos attentes.

Résolution des Erreurs Courantes

"401: Unauthorized"

Votre jeton de bot est manquant, invalide ou a été régénéré.

1. Vérifiez que DISCORD_BOT_TOKEN est défini dans votre environnement.
2. Assurez-vous que le jeton correspond à celui des paramètres du bot dans votre Portail Développeur.
3. Si le jeton a été récemment régénéré, mettez à jour votre variable d'environnement.

# Vérifier que le jeton est défini
echo $DISCORD_BOT_TOKEN

"50001: Missing Access"

Le bot n'a pas la permission d'accéder au canal ou au serveur cible.

1. Confirmez que le bot a été invité sur le serveur avec les permissions correctes.
2. Vérifiez les remplacements de permissions au niveau du canal qui pourraient bloquer le bot.
3. Utilisez l'action permissions pour vérifier les permissions effectives du bot sur un canal.

"MESSAGE_CONTENT intent is required"

Vous essayez de lire le contenu des messages mais l'intent privilégié MESSAGE_CONTENT n'est pas activé.

1. Rendez-vous dans le Portail Développeur → votre application → onglet Bot.
2. Sous Privileged Gateway Intents, activez Message Content Intent.
3. Pour les bots vérifiés (75+ serveurs), vous devez faire une demande pour cet intent via le portail.