Intégration de Clawdbot avec Discord

Aperçu de l'Intégration Clawdbot Discord

L'intégration Clawdbot Discord vous permet d'apporter une assistance alimentée par l'IA à vos serveurs Discord en utilisant la passerelle officielle des bots Discord. C'est prêt pour les DM et les canaux texte des guildes.

Pourquoi Utiliser Clawdbot avec Discord ?

Discord est la plateforme leader pour les jeux et la communication communautaire. Intégrer Clawdbot avec Discord offre :

Configuration Rapide (Débutant)

1. Créez un bot Discord et copiez le token du bot
2. Dans les paramètres de l'application Discord, activez Message Content Intent (et Server Members Intent si nécessaire)
3. Définissez le token via env (DISCORD_BOT_TOKEN=...) ou config (channels.discord.token)
4. Invitez le bot sur votre serveur avec les permissions de message
5. Démarrez la passerelle
6. L'accès DM est par appairage par défaut ; approuvez le code d'appairage au premier contact

Configuration minimale :

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

Configuration de Clawdbot Discord

Prérequis

Avant de connecter Clawdbot à Discord, assurez-vous d'avoir :

• Clawdbot installé sur votre appareil
• Un compte Discord
• Accès au Portail des Développeurs Discord
• Permissions d'administrateur du serveur

Étape 1 : Créer une Application Discord

Configurez votre application Clawdbot Discord :

1. Allez sur le Portail des Développeurs Discord
2. Cliquez sur "New Application"
3. Dans votre application : Bot → Add Bot
4. Copiez le Token du Bot

Étape 2 : Activer les Intents de Gateway

Activez les intents dont Clawdbot a besoin :

• Message Content Intent — Requis pour lire le contenu des messages
• Server Members Intent — Requis pour les listes autorisées ou les recherches de noms

Étape 3 : Générer l'URL d'Invitation

Utilisez le Générateur d'URL OAuth2 dans le Portail des Développeurs :

Permissions requises pour Clawdbot Discord :

• Read Messages/View Channels
• Send Messages
• Embed Links
• Read Message History
• Add Reactions
• Use Slash Commands

Étape 4 : Configurer Clawdbot Discord

Ajoutez votre bot Discord à Clawdbot :

Variable d'environnement :

DISCORD_BOT_TOKEN=YOUR_BOT_TOKEN

Fichier de configuration (~/.clawdbot/clawdbot.json) :

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

Si env et config sont tous deux définis, config a la priorité.

Étape 5 : Démarrer la Passerelle

clawdbot gateway --port 18789

Discord démarre automatiquement quand un token est disponible et channels.discord.enabled n'est pas false.

Étape 6 : Vérifier la Connexion

Vérifiez le statut de votre Clawdbot Discord :

clawdbot channels status discord

Comment Ça Fonctionne

• Les chats directs se regroupent dans la session principale de l'agent (par défaut agent:main:main)
• Les canaux de guilde restent isolés comme agent:<agentId>:discord:channel:<channelId>
• Les DM de groupe sont ignorés par défaut ; activez via channels.discord.dm.groupEnabled
• Le routage est déterministe : les réponses reviennent toujours au canal d'origine

Fonctionnalités de Clawdbot Discord

Contrôle d'Accès DM

Les chats directs sont sécurisés par défaut via channels.discord.dm.policy :

Exemple (liste autorisée stricte) :

{
  "channels": {
    "discord": {
      "dm": {
        "policy": "allowlist",
        "allowFrom": ["user:123456789"]
      }
    }
  }
}

Configuration des Canaux de Guilde

Définissez des règles par guilde ou par canal :

{
  "channels": {
    "discord": {
      "guilds": {
        "<guild_id>": {
          "channels": ["bot-commands", "ai-chat"],
          "requireMention": true
        }
      }
    }
  }
}

Commandes Slash

Clawdbot Discord supporte les commandes slash natives :

Les commandes natives sont par défaut "auto" (activées pour Discord/Telegram). Remplacez avec :

{
  "channels": {
    "discord": {
      "commands": {
        "native": true
      }
    }
  }
}

Historique de Contexte de Guilde

Définissez channels.discord.historyLimit (par défaut 20) pour inclure les N derniers messages de guilde comme contexte lors de la réponse à une mention. Définissez 0 pour désactiver.

Réactions

L'agent peut déclencher des réactions via l'outil discord (contrôlé par channels.discord.actions.*).

Configuration de Clawdbot Discord

Exemple de Configuration Complète

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "dm": {
        "policy": "pairing",
        "groupEnabled": false
      },
      "guilds": {
        "*": {
          "requireMention": true
        }
      },
      "historyLimit": 20
    }
  }
}

Écritures de Configuration

Par défaut, Discord peut écrire des mises à jour de configuration déclenchées par /config set|unset. Désactivez avec :

{
  "channels": {
    "discord": {
      "configWrites": false
    }
  }
}

Stockage des Identifiants Clawdbot Discord

Clawdbot stocke les identifiants Discord de manière sécurisée :

~/.clawdbot/credentials/discord/bot_token
~/.clawdbot/credentials/discord/servers.json

Vos données Clawdbot Discord restent sur votre machine locale.

Dépannage Clawdbot Discord

Bot Hors Ligne

Si Clawdbot Discord apparaît hors ligne :

1. Vérifiez le token : clawdbot channels verify discord
2. Vérifiez la connexion de la passerelle
3. Consultez les logs : cat /tmp/clawdbot/discord.log

Commandes Slash Non Fonctionnelles

Si les commandes slash Clawdbot Discord échouent :

1. Réenregistrez les commandes via la configuration
2. Vérifiez les permissions du bot
3. Vérifiez l'enregistrement des commandes spécifiques au serveur

Erreurs de Permission

Si Clawdbot Discord manque de permissions :

1. Vérifiez la position du rôle du bot dans les paramètres du serveur
2. Vérifiez les permissions spécifiques au canal
3. Réinvitez avec les bonnes permissions

Résolution de Noms

La résolution nom → id utilise la recherche de membres de guilde et nécessite Server Members Intent. Si le bot ne peut pas rechercher les membres, utilisez les ids ou les mentions <@id>.

Meilleures Pratiques Clawdbot Discord

1. Utilisez le Mode Appairage : Sécurisé par défaut avec des codes d'appairage pour les DMs
2. Définissez des Limites de Canal : Restreignez Clawdbot Discord aux canaux appropriés
3. Configurez les Rôles : Utilisez l'accès basé sur les rôles pour Clawdbot Discord
4. Surveillez l'Activité : Consultez régulièrement les logs Clawdbot Discord
5. Utilisez les Commandes Slash : Meilleure UX que les commandes texte

Cas d'Usage Clawdbot Discord

Support Communautaire

Déployez Clawdbot Discord comme un bot de support :

• Répondez automatiquement aux FAQs
• Escaladez les problèmes complexes
• Fournissez une assistance 24/7

Communautés de Jeux

Utilisez Clawdbot Discord pour les serveurs de jeux :

• Recherche d'informations sur les jeux
• Coordination d'équipe
• Planification d'événements

Communautés de Développeurs

Clawdbot Discord pour les serveurs de développeurs :

• Assistance au code
• Recherche de documentation
• Triage des bugs

Prochaines Étapes

• Intégration Clawdbot WhatsApp - Connectez Clawdbot à WhatsApp
• Intégration Clawdbot Telegram - Configurez Clawdbot sur Telegram
• Guide de Configuration Clawdbot - Guide d'installation complet