Configurer OpenClaw sur Discord : appairage en DM, canaux du serveur et voix

Name

Soren Atelier

Mis à jour le 08/04/2026

Si vous voulez utiliser OpenClaw avec Discord, le chemin le plus rapide et le plus sûr est le suivant : créez un bot Discord, définissez le jeton du bot sur la machine qui exécute OpenClaw, démarrez le gateway, approuvez le premier appairage en DM, puis transformez votre serveur privé en espace de travail de guilde.

C’est la séquence de configuration qui compte, car OpenClaw sur Discord n’est pas seulement « un bot de plus ». Chaque canal Discord peut devenir sa propre session d’agent avec son propre contexte, ses approbations et ses règles de routage. Si vous sautez l’appairage, la liste d’autorisation et les paramètres de mention, la configuration donne souvent l’impression d’être cassée même lorsque le jeton du bot est valide.

Si vous avez recherché la documentation Discord d’OpenClaw, la source officielle principale est le guide du canal Discord d’OpenClaw : documentation de configuration Discord (opens in a new tab). Cette page est la couche pratique au-dessus : quoi configurer en premier, quoi garder privé, et comment passer d’un test en DM à un espace de travail Discord privé utilisable.

Si vous avez besoin d’abord du contexte général sur le produit, lisez NVIDIA NemoClaw vs OpenClaw vs ZeroClaw: Differences, Pi Agent, and Nanobot in 2026. Si votre véritable objectif est une aide au codage locale dans un dépôt plutôt qu’un assistant basé sur Discord, How to Use Codex et How to Use OpenCode sont de meilleurs points de départ.

Réponse rapide : quelle est la manière la plus rapide de faire fonctionner OpenClaw dans Discord ?

L’ordre de configuration fiable est le suivant :

1. créer le bot Discord
2. activer les intents requis
3. définir le jeton du bot de manière sécurisée
4. démarrer le gateway
5. approuver le premier appairage en DM
6. ajouter votre serveur à la liste d’autorisation de la guilde
7. décider si les réponses doivent nécessiter un @mention
8. ajouter la voix uniquement après stabilisation du chat texte

Ce qu’OpenClaw sur Discord vous apporte réellement

OpenClaw sur Discord n’est pas juste une mémoire partagée unique pour un bot.

D’après la documentation OpenClaw actuelle, Discord prend en charge :

• les DM
• les canaux texte de guilde
• les workflows de threads dans les canaux de forum
• la gestion native des commandes
• les boutons d’approbation
• des sessions optionnelles dans des canaux vocaux

Cela compte parce que la vraie forme du produit est un espace de travail Discord composé de sessions d’agent, et pas seulement un bot en DM.

En pratique, cela signifie :

• les DM Discord peuvent servir de premier canal d’appairage à faible risque
• chaque canal de guilde peut conserver son propre contexte
• les approbations et le routage restent liés à l’interface Discord où la demande a été faite
• la voix peut être ajoutée plus tard si vous voulez des conversations continues

Démarrage rapide

La documentation officielle Discord recommande de créer un bot, de définir le jeton, puis de démarrer le gateway. La version minimale pratique ressemble à ceci :

export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN
openclaw config set channels.discord.enabled true --strict-json
openclaw gateway

Si OpenClaw fonctionne déjà comme processus en arrière-plan, redémarrez le gateway au lieu de lancer une deuxième copie.

Ensuite, envoyez un DM à votre bot dans Discord et approuvez le code d’appairage.

C’est le chemin le plus court pour passer de « j’ai un jeton de bot Discord » à « OpenClaw est réellement accessible dans Discord ».

Étape 1 : créer correctement le bot Discord

Dans les docs de configuration Discord (opens in a new tab) officielles, OpenClaw recommande un flux Discord standard :

1. allez dans le Discord Developer Portal
2. créez une nouvelle application
3. ajoutez un bot
4. copiez le jeton du bot

Pour l’URL OAuth, les portées de base sont :

• bot
• applications.commands

Les permissions de base courantes sont :

• View Channels
• Send Messages
• Read Message History
• Embed Links
• Attach Files

Évitez Administrator sauf si vous en avez vraiment besoin. Un serveur privé avec un minimum de permissions est un meilleur défaut.

Étape 2 : activer les bons intents avant de déboguer autre chose

C’est l’un des moyens les plus faciles de perdre du temps.

La documentation Discord d’OpenClaw indique ces intents :

• Message Content Intent : requis
• Server Members Intent : recommandé, et requis pour les listes d’autorisation par rôles et la correspondance des noms
• Presence Intent : optionnel

Si le bot rejoint le serveur mais se comporte de façon étrange, l’absence d’intents est l’une des premières choses à vérifier.

Étape 3 : garder le jeton hors du chat

Le jeton de votre bot Discord est un secret. Ne le collez pas dans un chat avec l’agent.

Utilisez une variable d’environnement ou un chemin de configuration basé sur SecretRef sur la machine qui exécute OpenClaw. La documentation recommande explicitement de définir le jeton localement, puis de relier la configuration à ce secret local.

Voici la base sûre :

export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
openclaw config set channels.discord.token --ref-provider default --ref-source env --ref-id DISCORD_BOT_TOKEN
openclaw config set channels.discord.enabled true --strict-json

Puis démarrez le gateway :

openclaw gateway

Si le chat texte ne fonctionne pas après cela, arrêtez-vous et déboguez le jeton, les intents et le gateway avant de toucher aux politiques de guilde.

Étape 4 : effectuer d’abord l’appairage en DM dans Discord

La documentation Discord actuelle d’OpenClaw considère les DM comme le premier point de contrôle le plus simple.

Le flux pratique est :

1. assurez-vous que le gateway est en cours d’exécution
2. envoyez un DM au bot dans Discord
3. attendez le code d’appairage
4. approuvez ce code depuis un canal OpenClaw existant ou via la CLI

Pourquoi commencer par l’appairage en DM :

• c’est la boucle la plus courte pour valider le jeton du bot et le routage
• cela retire la politique de guilde du premier test
• cela vous permet de prouver que le bot est vivant avant de transformer tout un serveur en espace de travail

Si votre premier DM ne reçoit jamais de réponse, ne passez pas encore à l’étape suivante. Le problème est généralement l’un des suivants :

• le jeton est incorrect
• le gateway n’est pas en cours d’exécution
• les DM sont bloqués
• les intents sont incomplets

Étape 5 : transformer un serveur Discord privé en espace de travail de guilde

Une fois l’appairage en DM fonctionnel, l’étape utile suivante n’est pas « ajouter plus de canaux partout ». C’est « configurer correctement un serveur Discord privé ».

La documentation officielle recommande un espace de travail de guilde parce que chaque canal obtient sa propre session OpenClaw isolée. C’est la vraie raison pour laquelle Discord est intéressant ici. Vous pouvez créer des canaux comme :

• #coding
• #research
• #home
• #ops

et chacun peut conserver un contexte différent.

Le premier changement de configuration consiste à ajouter votre serveur à la liste d’autorisation de la guilde :

{
  channels: {
    discord: {
      groupPolicy: "allowlist",
      guilds: {
        YOUR_SERVER_ID: {
          requireMention: true,
          users: ["YOUR_USER_ID"],
        },
      },
    },
  },
}

C’est le réglage le plus sûr par défaut, car il limite où le bot répondra et qui peut l’utiliser.

Étape 6 : décider si votre serveur doit exiger @mention

Par défaut, OpenClaw sur Discord est plus sûr que pratique.

C’est généralement correct pour les serveurs partagés. Mais dans un serveur privé où il n’y a que vous et votre bot, exiger un @mention sur chaque message rend l’espace de travail maladroit.

La documentation montre que vous pouvez désactiver le comportement « mention obligatoire » pour une guilde spécifique :

{
  channels: {
    discord: {
      guilds: {
        YOUR_SERVER_ID: {
          requireMention: false,
        },
      },
    },
  },
}

Utilisez cela uniquement dans des serveurs de confiance. Si le serveur est partagé, conservez l’exigence de mention.

Étape 7 : comprendre le modèle de mémoire avant d’attendre un « contexte partagé »

C’est l’un des détails conceptuels les plus importants dans la documentation Discord.

OpenClaw ne traite pas chaque conversation Discord comme un immense pool de mémoire partagé.

La documentation indique que :

• les DM peuvent se fondre dans la session principale de l’agent
• les canaux de guilde sont des sessions isolées
• la mémoire à long terme n’est pas chargée automatiquement dans chaque canal de guilde de la même manière

Cela signifie que vous ne devez pas vous attendre à ce que #research et #home donnent automatiquement l’impression d’être le même fil d’assistant. Cette isolation est utile, mais seulement si vous savez qu’elle existe.

Si vous avez besoin d’instructions partagées stables partout, conservez-les dans la couche d’instructions globale de l’agent plutôt que de supposer que la mémoire du canal les transportera.

Ajouter la voix uniquement après le bon fonctionnement du chat texte

OpenClaw prend également en charge les canaux vocaux Discord, mais cela doit venir après la stabilité du texte.

La documentation indique que la voix nécessite :

• les commandes natives activées
• channels.discord.voice configuré
• les permissions Connect et Speak dans le canal vocal cible

Un exemple minimal d’auto-join ressemble à ceci :

{
  channels: {
    discord: {
      voice: {
        enabled: true,
        autoJoin: [
          {
            guildId: "123456789012345678",
            channelId: "234567890123456789",
          },
        ],
      },
    },
  },
}

C’est puissant, mais ce ne doit pas être votre premier jalon. Assurez-vous d’abord que :

• l’appairage en DM fonctionne
• le routage des canaux texte de guilde fonctionne
• les listes d’autorisation se comportent comme prévu

Ajoutez la voix seulement après cela.

Pièges courants

Envoyer le jeton du bot dans le chat

Ne faites pas cela. Définissez le jeton localement sur la machine qui exécute OpenClaw, puis pointez la configuration OpenClaw vers ce secret local.

Essayer les canaux de guilde avant l’appairage en DM

Si vous sautez le point de contrôle DM, vous finissez par déboguer en même temps le jeton, les intents, le gateway, la politique de guilde et les mentions.

Laisser requireMention activé dans un serveur privé et penser que le bot est cassé

Dans un serveur privé, le bot peut être sain mais ignorer les messages tant qu’il n’est pas mentionné. C’est une politique, pas une panne.

S’attendre à une mémoire partagée unique sur tous les canaux Discord

Les canaux de guilde sont conçus pour rester isolés. C’est souvent utile, mais cela surprend les personnes qui s’attendent à un historique de chat global unique.

Activer la voix avant que le chat texte ne fonctionne

La voix ajoute une couche de débogage supplémentaire. Commencez par le texte.

Liste de vérification pour le dépannage

Si OpenClaw dans Discord ne répond pas, vérifiez ces points dans cet ordre :

1. le gateway est en cours d’exécution
2. le jeton du bot est valide et défini localement
3. Message Content Intent est activé
4. les DM sont autorisés pour l’appairage
5. le serveur est dans la liste d’autorisation de la guilde si vous testez les canaux de guilde
6. requireMention est configuré comme vous l’attendez
7. l’expéditeur n’est pas bloqué par une politique utilisateur ou de guilde

La documentation OpenClaw indique aussi des commandes utiles pour le diagnostic :

openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Quand cette configuration Discord n’est pas le bon point de départ

Ne commencez pas ici si votre objectif réel est :

• un assistant de codage lié au dépôt local
• un runtime sans interface pour un déploiement embarqué
• une comparaison générique des alternatives à OpenClaw

Dans ces cas, les lectures suivantes sont plus adaptées :

• How to Use Codex
• How to Use OpenCode
• NVIDIA NemoClaw vs OpenClaw vs ZeroClaw: Differences, Pi Agent, and Nanobot in 2026

FAQ

Quelle est la première chose à tester dans la configuration Discord d’OpenClaw ?

Testez d’abord l’appairage en DM Discord. C’est le moyen le plus court de confirmer que votre jeton, votre gateway et votre routage de base fonctionnent.

Ai-je besoin de @mention dans chaque canal Discord ?

Pas toujours. Sur les serveurs privés, beaucoup d’utilisateurs voudront requireMention: false. Sur les serveurs partagés, conserver l’exigence de mention est le réglage le plus sûr par défaut.

Pourquoi mon bot Discord OpenClaw est-il en ligne mais ne répond-il pas ?

Les causes les plus courantes sont un mauvais jeton, l’absence de Message Content Intent, un gateway arrêté, des DM bloqués ou une politique de guilde qui empêche les réponses sans correspondance de liste d’autorisation ou de mention.

Dois-je activer d’abord la voix Discord ?

Non. Faites fonctionner d’abord l’appairage en DM et les canaux texte de guilde, puis ajoutez la voix.

Est-ce mieux qu’un guide générique « Comment utiliser OpenClaw » ?

Pour une intention de recherche pratique, oui. La configuration Discord a un objectif plus clair : elle aide le lecteur à faire fonctionner une intégration réelle plutôt que d’essayer de résumer tout le produit OpenClaw sur une seule page.

Guides associés

• NVIDIA NemoClaw vs OpenClaw vs ZeroClaw: Differences, Pi Agent, and Nanobot in 2026
• How to Use Codex
• How to Use OpenCode
• Parallel Code Agents Explained
• Cursor Review: Where It Still Wins and Where It Still Breaks