Prérequis
- Un compte Discord
- Un serveur Discord sur lequel vous avez la permission Gérer le serveur
- Une instance Claw (créez-en une ici)
Guide de configuration
Créer une application Discord
- Accédez au Portail des développeurs Discord
- Cliquez sur New Application
- Donnez-lui un nom (ex: “Mon Bot IA”) et cliquez sur Create
Créer un Bot
- Dans votre application, allez dans l’onglet Bot
- Cliquez sur Add Bot → Yes, do it!
- Sous Privileged Gateway Intents, activez :
- Message Content Intent (requis)
- Server Members Intent (recommandé)
- Cliquez sur Reset Token pour générer un token de bot
- Copiez le token — vous en aurez besoin à l’étape suivante
Inviter le bot sur votre serveur
- Allez dans l’onglet OAuth2 → URL Generator
- Sous Scopes, sélectionnez :
bot,applications.commands - Sous Bot Permissions, sélectionnez :
Send Messages,Read Message History - Copiez l’URL générée et ouvrez-la dans votre navigateur
- Sélectionnez votre serveur et cliquez sur Authorize
Ouvrir la LemonClaw WebUI
- Si vous utilisez Claw hébergé, allez sur votre Claw Dashboard et cliquez sur Open WebUI
- Si vous auto-hébergez LemonClaw, ouvrez votre propre WebUI (par exemple
http://your-ip:18789) et connectez-vous avec votre token - Dans la WebUI, allez dans Settings → Channels
- Développez la section Discord
- Collez votre Bot Token
- Cliquez sur Save
Utilisation sur les serveurs
Paramètres de groupe
Configurez le comportement du serveur (guild) dans l’onglet Channels de votre WebUI :| Paramètre | Options | Description |
|---|---|---|
| Group Policy | Open (par défaut) / Allowlist / Disabled | Contrôle l’accès aux salons du serveur |
| Require @mention | On / Off | Le bot ne répond que lorsqu’il est mentionné (recommandé) |
| Group IDs | Liste d’IDs de serveurs | Restreindre à des serveurs spécifiques (vide = tous les serveurs) |
Discord utilise des listes blanches d’utilisateurs par serveur au lieu d’une liste blanche de groupe globale. Pour un filtrage avancé des utilisateurs par serveur, configurez-le directement dans le fichier de configuration LemonClaw.
Politique de messages privés (DM)
Contrôlez qui peut envoyer des messages directs à votre bot :| Politique | Comportement |
|---|---|
| Pairing (par défaut) | Les nouveaux utilisateurs reçoivent un code d’association — saisissez-le dans la WebUI pour autoriser |
| Allowlist | Seuls les IDs d’utilisateurs spécifiés peuvent envoyer des DM au bot |
| Open | Tout le monde peut envoyer des DM au bot (à utiliser avec prudence) |
Dépannage
Le bot est en ligne mais ne répond pas
Le bot est en ligne mais ne répond pas
- Assurez-vous que Message Content Intent est activé dans le Portail des développeurs
- Vérifiez que le token du bot est correct
- Vérifiez que le bot a la permission de lire et d’envoyer des messages dans le salon
Le bot apparaît comme hors ligne
Le bot apparaît comme hors ligne
- Vérifiez le statut de votre instance dans le tableau de bord (doit être vert/en cours d’exécution)
- Essayez de redémarrer l’instance
- Vérifiez que le token n’a pas été réinitialisé dans le Portail des développeurs
Erreurs 409 Conflict dans les logs
Erreurs 409 Conflict dans les logs
- Cela se produit lorsque deux instances tentent d’utiliser le même token de bot
- Assurez-vous qu’une seule instance Claw est configurée avec ce token