Discord

Exécutez votre agent ZeroClaw en tant que bot Discord. Ce guide vous accompagne clic par clic, aucune expérience préalable avec les bots n’est nécessaire. À la fin, vous aurez un bot installé sur votre serveur qui répond lorsque les gens lui parlent.

Qui peut parler à l’agent

Les expéditeurs entrants sont filtrés par rapport au peer set résolu pour l’agent lié, issu de la configuration peer_groups à laquelle l’agent appartient. La correspondance supprime le @ initial et est insensible à la casse par rapport à l’identifiant d’expéditeur natif du canal. Un ensemble vide refuse tout le monde ; un ensemble contenant "*" accepte n’importe qui ; sinon, seuls les pairs externes listés (et les agents pairs) sont acceptés. Ceci est distinct de l’appairage de la passerelle (gateway.require_pairing), qui authentifie les clients HTTP/WebSocket, et non les expéditeurs des canaux de discussion.

Un groupe de pairs pour discord définit channel sur discord, liste les expéditeurs autorisés dans external_peers (pour discord, l’identifiant utilisateur Discord (snowflake) ; ["*"] accepte tout le monde), nomme éventuellement des agents pairs pour la répartition inter-agents, une liste de blocage ignore, et une output_modality (mirror, voice ou text). Consultez Peer Groups pour la référence des champs.

Où définir ce paramètre :

Démarrage rapide

Cinq étapes : créez le bot, copiez son token, activez deux interrupteurs, invitez-le et démarrez ZeroClaw.

1. Créer le bot

1. Accédez au Portail des développeurs Discord.
2. Cliquez sur New Application, donnez-lui un nom, puis cliquez sur Create.
3. Dans la barre latérale gauche, cliquez sur Bot.
4. Cliquez sur Reset Token, puis sur Copy. Cette longue chaîne de caractères est votre bot_token. Conservez-la en lieu sûr pour l’étape 3, vous ne pourrez plus la consulter par la suite (seulement la réinitialiser).

Le jeton du bot est un mot de passe pour votre bot. Toute personne qui le possède peut contrôler votre bot. Ne le collez jamais dans une discussion publique, ne le partagez jamais dans une capture d’écran et ne le validez jamais dans git.

2. Activez les deux interrupteurs dont le bot a besoin

Toujours sur la page Bot, faites défiler jusqu’à Privileged Gateway Intents et activez les deux options suivantes :

• Message Content Intent pour que le bot puisse lire ce que les utilisateurs écrivent.
• Intention Membres du Serveur (Server Members Intent) afin qu’il puisse voir qui se trouve sur le serveur.

Cliquez sur Save Changes. Si vous sautez cette étape, le bot se connecte mais ne voit jamais aucun message, ce qui est la cause la plus fréquente du problème « mon bot ne fait rien ».

3. Informez ZeroClaw de l’existence du bot

Placez le jeton de l’étape 1 dans votre configuration. Le jeton est un secret, vous devez donc le définir via une interface qui le chiffre plutôt que de le saisir directement dans config.toml :

channels.discord.<alias>.bot_token est un secret. Stocké chiffré, jamais en clair dans config.toml. Définissez-le via l’une de ces méthodes, qui chiffrent à l’écriture :

zeroclaw config set channels.discord.<alias>.bot_token    # demande une saisie masquée, stocke de manière chiffrée

4. Invitez le bot sur votre serveur

1. De retour dans le Developer Portal, ouvrez OAuth2 -> URL Generator.
2. Sous Scopes, cochez bot.
3. Sous Bot Permissions, cochez au moins Send Messages, Read Message History et View Channels.
4. Copiez l’URL en bas, ouvrez-la dans votre navigateur, choisissez votre serveur, puis cliquez sur Authorize.

Le bot apparaît maintenant dans votre liste de membres (hors ligne jusqu’à ce que vous démarriez ZeroClaw).

5. Démarrer et tester

Démarrez ZeroClaw (zeroclaw service restart ou zeroclaw daemon), puis envoyez un message dans un canal visible par le bot. Il devrait répondre. Si ce n’est pas le cas, passez à la section Dépannage.

Configuration

La liste complète des champs, dérivée du schéma en production. La plupart ont des valeurs par défaut raisonnables ; pour un bot basique, vous ne définissez jamais que bot_token.

zeroclaw config set channels.discord.<alias>.approval_timeout_secs <value>

export ZEROCLAW_channels__discord__<alias>__approval_timeout_secs=

zeroclaw config set channels.discord.<alias>.archive <value>

export ZEROCLAW_channels__discord__<alias>__archive=

zeroclaw config set channels.discord.<alias>.bot_token    # entrée masquée, stockée chiffrée

export ZEROCLAW_channels__discord__<alias>__bot_token=

zeroclaw config set channels.discord.<alias>.channel_ids <value>

export ZEROCLAW_channels__discord__<alias>__channel_ids=

zeroclaw config set channels.discord.<alias>.draft_update_interval_ms <value>

export ZEROCLAW_channels__discord__<alias>__draft_update_interval_ms=

zeroclaw config set channels.discord.<alias>.excluded_tools <value>

export ZEROCLAW_channels__discord__<alias>__excluded_tools=

zeroclaw config set channels.discord.<alias>.guild_ids <value>

export ZEROCLAW_channels__discord__<alias>__guild_ids=

zeroclaw config set channels.discord.<alias>.intents_mask <value>

export ZEROCLAW_channels__discord__<alias>__intents_mask=

zeroclaw config set channels.discord.<alias>.interrupt_on_new_message <value>

export ZEROCLAW_channels__discord__<alias>__interrupt_on_new_message=

zeroclaw config set channels.discord.<alias>.listen_to_bots <value>

export ZEROCLAW_channels__discord__<alias>__listen_to_bots=

zeroclaw config set channels.discord.<alias>.mention_only <value>

export ZEROCLAW_channels__discord__<alias>__mention_only=

zeroclaw config set channels.discord.<alias>.multi_message_delay_ms <value>

export ZEROCLAW_channels__discord__<alias>__multi_message_delay_ms=

zeroclaw config set channels.discord.<alias>.proxy_url <value>

export ZEROCLAW_channels__discord__<alias>__proxy_url=

zeroclaw config set channels.discord.<alias>.reaction_notifications <value>

export ZEROCLAW_channels__discord__<alias>__reaction_notifications=

zeroclaw config set channels.discord.<alias>.reply_min_interval_secs <value>

export ZEROCLAW_channels__discord__<alias>__reply_min_interval_secs=

zeroclaw config set channels.discord.<alias>.reply_queue_depth_max <value>

export ZEROCLAW_channels__discord__<alias>__reply_queue_depth_max=

zeroclaw config set channels.discord.<alias>.slash_command_scope <value>

export ZEROCLAW_channels__discord__<alias>__slash_command_scope=

zeroclaw config set channels.discord.<alias>.slash_commands <value>

export ZEROCLAW_channels__discord__<alias>__slash_commands=

zeroclaw config set channels.discord.<alias>.stall_timeout_secs <value>

export ZEROCLAW_channels__discord__<alias>__stall_timeout_secs=

zeroclaw config set channels.discord.<alias>.stream_mode <value>

export ZEROCLAW_channels__discord__<alias>__stream_mode=

Restreindre les endroits où le bot écoute

Par défaut, le bot écoute dans chaque serveur où il est invité et chaque canal qu’il peut voir. Pour restreindre sa portée :

• guild_ids : limite le bot à des serveurs spécifiques (guilds). Vide signifie tous.
• channel_ids : limiter à des canaux spécifiques. Vide signifie tous les canaux visibles.

Pour trouver un ID, activez le Mode développeur dans Discord (Paramètres utilisateur -> Avancés), puis faites un clic droit sur un serveur ou un salon et sélectionnez Copier l’identifiant.

Threads et contexte

Lorsqu’une conversation Discord se déroule dans un fil de discussion, ce fil constitue sa propre conversation. ZeroClaw dérive une clé de session distincte par fil, de sorte que chaque fil dispose d’une fenêtre de contexte et d’un historique indépendants : les messages d’un fil ne débordent jamais dans un autre, et l’agent ne voit pas les tours précédents d’un fil voisin. Pour Discord, les fils sont des canaux natifs, donc chaque fil est déjà une conversation distincte : aucune option à configurer.

• L’isolation est l’objectif. Le contexte de chaque thread est autonome : il ne fuit pas en dehors du thread, et rien de l’extérieur du thread ne s’y infiltre. Les threads parallèles conservent des états conversationnels distincts, de sorte que des tâches sans rapport ne se contaminent jamais entre elles.
• Les threads longs font croître le contexte. Un thread accumule l’historique tant qu’il reste actif, donc un thread très long finit par remplir la fenêtre de contexte du modèle comme toute autre conversation longue. Démarrez un nouveau thread pour réinitialiser.
• Le travail en cours est limité à chaque fil de discussion. Un nouveau message dans un fil n’annule pas une réponse en cours dans un autre ; la tâche de chaque fil est indépendante.

Archiver et rechercher

Définissez archive = true et le canal ouvre un magasin de mémoire annexe discord.db, enregistre chaque message qu’il voit, et inscrit un outil discord_search que l’agent peut utiliser pour rechercher dans les conversations passées. Laissez-le désactivé si vous n’avez pas besoin de la recherche dans l’historique ; le bot répond normalement dans les deux cas.

Diffusion en continu

Discord diffuse les réponses en continu via le paramètre stream_mode :

• off (par défaut) : la réponse entière est publiée en un seul message une fois que l’agent a terminé. C’est l’option la plus simple, et elle n’affiche jamais de réponse partiellement rédigée.
• partial : le bot publie un brouillon immédiatement et le modifie sur place au fur et à mesure que la réponse arrive en streaming. draft_update_interval_ms régule la fréquence des modifications ; augmentez-le si Discord les limite (rate-limit).
• multi_message : chaque paragraphe est publié comme un message distinct, séparé par multi_message_delay_ms. Idéal pour les réponses longues qui formeraient sinon un seul bloc de texte.

Posez-le sur n’importe quelle surface :

zeroclaw config set channels.discord.<alias>.stream_mode <value>

Des réponses qui semblent naturelles

• mention_only : lorsque la valeur est true, le bot répond uniquement aux messages qui le mentionnent avec @, afin de rester silencieux dans les canaux très actifs.
• reply_min_interval_secs : un intervalle minimum entre les réponses à une même personne, utile si les réponses instantanées semblent robotiques.

Dépannage

Voir aussi

• Qui peut parler à l’agent (groupes de pairs)
• Slack
• Vue d’ensemble des canaux