Discord

Discord prend en charge les balises de réponse dans la sortie de l’agent :

• [[reply_to_current]]
• [[reply_to:<id>]]

Contrôlé par channels.discord.replyToMode :

• off (par défaut)
• first
• all
• batched

Remarque : off désactive le fil de réponse implicite. Les balises explicites [[reply_to_*]] sont toujours respectées. first attache toujours la référence de réponse native implicite au premier message Discord sortant du tour. batched n’attache la référence de réponse native implicite de Discord que lorsque le tour entrant était un lot temporisé de plusieurs messages. C’est utile lorsque vous voulez des réponses natives principalement pour les conversations en rafales ambiguës, et non pour chaque tour à message unique.

Les identifiants de message sont exposés dans le contexte/l’historique afin que les agents puissent cibler des messages précis.

OpenClaw peut diffuser des brouillons de réponses en envoyant un message temporaire et en le modifiant à mesure que le texte arrive. channels.discord.streaming accepte off | partial | block | progress (par défaut). progress conserve un brouillon d’état modifiable et le met à jour avec la progression des outils jusqu’à la livraison finale ; streamMode est un alias d’exécution hérité. Exécutez openclaw doctor --fix pour réécrire la configuration persistée vers la clé canonique.

Définissez channels.discord.streaming.mode sur off pour désactiver les modifications d’aperçu Discord. Si le streaming par blocs Discord est explicitement activé, OpenClaw ignore le flux d’aperçu afin d’éviter une double diffusion.

{
channels: {
discord: {
  streaming: {
    mode: "progress",
    progress: {
      label: "auto",
      maxLines: 8,
      toolProgress: true,
    },
  },
},
},
}

• partial modifie un seul message d’aperçu à mesure que les tokens arrivent.
• block émet des fragments de taille brouillon (utilisez draftChunk pour ajuster la taille et les points de coupure, bornés par textChunkLimit).
• Les livraisons finales contenant des médias, des erreurs ou des réponses explicites annulent les modifications d’aperçu en attente.
• streaming.preview.toolProgress (par défaut true) contrôle si les mises à jour d’outil/de progression réutilisent le message d’aperçu.
• streaming.preview.commandText / streaming.progress.commandText contrôle les détails de commande/d’exécution dans les lignes de progression compactes : raw (par défaut) ou status (libellé de l’outil uniquement).

Masquer le texte brut de commande/d’exécution tout en conservant les lignes de progression compactes :

{
  "channels": {
    "discord": {
      "streaming": {
        "mode": "progress",
        "progress": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

Le streaming d’aperçu est uniquement textuel ; les réponses multimédias reviennent à la livraison normale. Lorsque le streaming block est explicitement activé, OpenClaw ignore le flux d’aperçu afin d’éviter une double diffusion.

Contexte d’historique de guilde :

• valeur par défaut de channels.discord.historyLimit : 20
• solution de repli : messages.groupChat.historyLimit
• 0 désactive

Contrôles de l’historique des DM :

• channels.discord.dmHistoryLimit
• channels.discord.dms["<user_id>"].historyLimit

Comportement des fils :

• Les fils Discord sont routés comme des sessions de canal et héritent de la configuration du canal parent sauf remplacement.
• Les sessions de fil héritent de la sélection /model au niveau session du canal parent comme solution de repli limitée au modèle ; les sélections /model locales au fil restent prioritaires et l’historique de transcript parent n’est pas copié sauf si l’héritage de transcript est activé.
• channels.discord.thread.inheritParent (par défaut false) active, pour les nouveaux fils automatiques, l’amorçage depuis le transcript parent. Les remplacements par compte se trouvent sous channels.discord.accounts.<id>.thread.inheritParent.
• Les réactions de l’outil de message peuvent résoudre les cibles DM user:<id>.
• guilds.<guild>.channels.<channel>.requireMention: false est préservé pendant le repli d’activation à l’étape de réponse.

Les sujets de canal sont injectés comme contexte non fiable. Les listes d’autorisation limitent qui peut déclencher l’agent, mais ne constituent pas une frontière complète de caviardage du contexte supplémentaire.

Discord peut lier un fil à une cible de session afin que les messages de suivi dans ce fil continuent d’être routés vers la même session (y compris les sessions de sous-agent).

Commandes :

• /focus <target> lier le fil actuel/nouveau à une cible de sous-agent/session
• /unfocus supprimer la liaison du fil actuel
• /agents afficher les exécutions actives et l’état de liaison
• /session idle <duration|off> inspecter/mettre à jour le désengagement automatique après inactivité pour les liaisons focalisées
• /session max-age <duration|off> inspecter/mettre à jour l’âge maximal strict des liaisons focalisées

Configuration :

{
session: {
threadBindings: {
  enabled: true,
  idleHours: 24,
  maxAgeHours: 0,
},
},
channels: {
discord: {
  threadBindings: {
    enabled: true,
    idleHours: 24,
    maxAgeHours: 0,
    spawnSessions: true,
    defaultSpawnContext: "fork",
  },
},
},
}

Remarques :

• session.threadBindings.* définit les valeurs par défaut globales.
• channels.discord.threadBindings.* remplace le comportement Discord.
• spawnSessions contrôle la création/liaison automatique de fils pour sessions_spawn({ thread: true }) et les créations de fils ACP. Par défaut : true.
• defaultSpawnContext contrôle le contexte natif de sous-agent pour les créations liées à un fil. Par défaut : "fork".
• Les clés obsolètes spawnSubagentSessions/spawnAcpSessions sont migrées par openclaw doctor --fix.
• Si les liaisons de fil sont désactivées pour un compte, /focus et les opérations de liaison de fil associées ne sont pas disponibles.

Consultez Sous-agents, Agents ACP et Référence de configuration.

Pour des espaces de travail ACP stables « toujours actifs », configurez des liaisons ACP typées de niveau supérieur ciblant des conversations Discord.

Chemin de configuration :

• bindings[] avec type: "acp" et match.channel: "discord"

Exemple :

{
agents: {
list: [
  {
    id: "codex",
    runtime: {
      type: "acp",
      acp: {
        agent: "codex",
        backend: "acpx",
        mode: "persistent",
        cwd: "/workspace/openclaw",
      },
    },
  },
],
},
bindings: [
{
  type: "acp",
  agentId: "codex",
  match: {
    channel: "discord",
    accountId: "default",
    peer: { kind: "channel", id: "222222222222222222" },
  },
  acp: { label: "codex-main" },
},
],
channels: {
discord: {
  guilds: {
    "111111111111111111": {
      channels: {
        "222222222222222222": {
          requireMention: false,
        },
      },
    },
  },
},
},
}

Remarques :

• /acp spawn codex --bind here lie le canal ou le fil actuel sur place et conserve les messages futurs sur la même session ACP. Les messages de fil héritent de la liaison du canal parent.
• Dans un canal ou un fil lié, /new et /reset réinitialisent la même session ACP sur place. Les liaisons de fil temporaires peuvent remplacer la résolution de cible lorsqu’elles sont actives.
• spawnSessions contrôle la création/liaison de fils enfants via --thread auto|here.

Consultez Agents ACP pour les détails du comportement de liaison.

Mode de notification de réaction par guilde :

• off
• own (par défaut)
• all
• allowlist (utilise guilds.<id>.users)

Les événements de réaction sont transformés en événements système et attachés à la session Discord routée.

ackReaction envoie un emoji d’accusé de réception pendant qu’OpenClaw traite un message entrant.

Ordre de résolution :

• channels.discord.accounts.<accountId>.ackReaction
• channels.discord.ackReaction
• messages.ackReaction
• repli sur l’emoji d’identité de l’agent (agents.list[].identity.emoji, sinon "👀")

Remarques :

• Discord accepte les emojis unicode ou les noms d’emojis personnalisés.
• Utilisez "" pour désactiver la réaction pour un canal ou un compte.

Les écritures de configuration initiées par le canal sont activées par défaut.

Cela affecte les flux /config set|unset (lorsque les fonctionnalités de commande sont activées).

Désactiver :

{
channels: {
discord: {
  configWrites: false,
},
},
}

Routez le trafic WebSocket du Gateway Discord et les recherches REST au démarrage (ID d’application + résolution de liste d’autorisation) via un proxy HTTP(S) avec channels.discord.proxy.

{
channels: {
discord: {
  proxy: "http://proxy.example:8080",
},
},
}

Remplacement par compte :

{
channels: {
discord: {
  accounts: {
    primary: {
      proxy: "http://proxy.example:8080",
    },
  },
},
},
}

Activez la résolution PluralKit pour mapper les messages relayés par proxy à l’identité du membre du système :

{
channels: {
discord: {
  pluralkit: {
    enabled: true,
    token: "pk_live_...", // optional; needed for private systems
  },
},
},
}

Remarques :

• les listes d’autorisation peuvent utiliser pk:<memberId>
• les noms d’affichage des membres sont mis en correspondance par nom/slug uniquement lorsque channels.discord.dangerouslyAllowNameMatching: true
• les recherches utilisent l’ID du message d’origine et sont contraintes par une fenêtre temporelle
• si la recherche échoue, les messages relayés par proxy sont traités comme des messages de bot et supprimés sauf si allowBots=true

Utilisez mentionAliases lorsque les agents ont besoin de mentions sortantes déterministes pour des utilisateurs Discord connus. Les clés sont des handles sans le @ initial ; les valeurs sont des ID utilisateur Discord. Les handles inconnus, @everyone, @here et les mentions dans les spans de code Markdown restent inchangés.

{
channels: {
discord: {
  mentionAliases: {
    Vladislava: "123456789012345678",
  },
  accounts: {
    ops: {
      mentionAliases: {
        OpsLead: "234567890123456789",
      },
    },
  },
},
},
}

Les mises à jour de présence sont appliquées lorsque vous définissez un champ de statut ou d’activité, ou lorsque vous activez la présence automatique.

Exemple de statut seul :

{
channels: {
discord: {
  status: "idle",
},
},
}

Exemple d’activité (le statut personnalisé est le type d’activité par défaut) :

{
channels: {
discord: {
  activity: "Focus time",
  activityType: 4,
},
},
}

Exemple de streaming :

{
channels: {
discord: {
  activity: "Live coding",
  activityType: 1,
  activityUrl: "https://twitch.tv/openclaw",
},
},
}

Carte des types d’activité :

• 0 : Jeu en cours
• 1 : Streaming (nécessite activityUrl)
• 2 : Écoute
• 3 : Visionnage
• 4 : Personnalisé (utilise le texte d’activité comme état du statut ; l’emoji est facultatif)
• 5 : Compétition

Exemple de présence automatique (signal d’état de l’exécution) :

{
channels: {
discord: {
  autoPresence: {
    enabled: true,
    intervalMs: 30000,
    minUpdateIntervalMs: 15000,
    exhaustedText: "token exhausted",
  },
},
},
}

La présence automatique mappe la disponibilité à l’exécution au statut Discord : healthy => online, degraded ou unknown => idle, exhausted ou unavailable => dnd. Remplacements de texte facultatifs :

• autoPresence.healthyText
• autoPresence.degradedText
• autoPresence.exhaustedText (prend en charge l’espace réservé {reason})

Discord prend en charge la gestion des approbations par boutons dans les messages privés et peut éventuellement publier les demandes d’approbation dans le canal d’origine.

Chemin de configuration :

• channels.discord.execApprovals.enabled
• channels.discord.execApprovals.approvers (facultatif ; revient à commands.ownerAllowFrom lorsque possible)
• channels.discord.execApprovals.target (dm | channel | both, valeur par défaut : dm)
• agentFilter, sessionFilter, cleanupAfterResolve

Discord active automatiquement les approbations d’exécution natives lorsque enabled n’est pas défini ou vaut "auto" et qu’au moins un approbateur peut être résolu, soit depuis execApprovals.approvers, soit depuis commands.ownerAllowFrom. Discord ne déduit pas les approbateurs d’exécution depuis le canal allowFrom, l’ancien dm.allowFrom, ni le defaultTo des messages directs. Définissez enabled: false pour désactiver explicitement Discord comme client d’approbation natif.

Pour les commandes de groupe sensibles réservées au propriétaire, comme /diagnostics et /export-trajectory, OpenClaw envoie les demandes d’approbation et les résultats finaux en privé. Il essaie d’abord les messages privés Discord lorsque le propriétaire qui invoque la commande dispose d’une route de propriétaire Discord ; si elle n’est pas disponible, il revient à la première route de propriétaire disponible dans commands.ownerAllowFrom, comme Telegram.

Lorsque target vaut channel ou both, la demande d’approbation est visible dans le canal. Seuls les approbateurs résolus peuvent utiliser les boutons ; les autres utilisateurs reçoivent un refus éphémère. Les demandes d’approbation incluent le texte de la commande, donc n’activez la livraison dans un canal que pour des canaux de confiance. Si l’ID du canal ne peut pas être dérivé de la clé de session, OpenClaw revient à la livraison par message privé.

Discord affiche également les boutons d’approbation partagés utilisés par les autres canaux de discussion. L’adaptateur Discord natif ajoute principalement le routage des messages privés vers les approbateurs et la diffusion vers les canaux. Lorsque ces boutons sont présents, ils constituent l’UX d’approbation principale ; OpenClaw ne doit inclure une commande /approve manuelle que lorsque le résultat de l’outil indique que les approbations par discussion sont indisponibles ou que l’approbation manuelle est le seul chemin. Si l’environnement d’exécution d’approbation natif de Discord n’est pas actif, OpenClaw conserve visible la demande locale déterministe /approve <id> <decision>. Si l’environnement d’exécution est actif mais qu’une carte native ne peut être livrée à aucune cible, OpenClaw envoie un avis de secours dans la même discussion avec la commande /approve exacte provenant de l’approbation en attente.

L’authentification du Gateway et la résolution des approbations suivent le contrat client Gateway partagé (les ID plugin: sont résolus via plugin.approval.resolve ; les autres ID via exec.approval.resolve). Les approbations expirent par défaut après 30 minutes.

Voir Approbations d’exécution.

• activez Message Content Intent
• activez Server Members Intent lorsque vous dépendez de la résolution d’utilisateurs/membres
• redémarrez le Gateway après avoir modifié les intentions

• vérifiez groupPolicy
• vérifiez la liste d’autorisation de guilde sous channels.discord.guilds
• si la map channels de guilde existe, seuls les canaux listés sont autorisés
• vérifiez le comportement de requireMention et les motifs de mention

Vérifications utiles :

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

Causes courantes :

• groupPolicy="allowlist" sans liste d’autorisation de guilde/canal correspondante
• requireMention configuré au mauvais endroit (doit se trouver sous channels.discord.guilds ou dans l’entrée de canal)
• expéditeur bloqué par la liste d’autorisation users de guilde/canal

Journaux typiques :

• Slow listener detected ...
• stuck session: sessionKey=agent:...:discord:... state=processing ...

Boutons de réglage de la file d’attente du Gateway Discord :

• compte unique : channels.discord.eventQueue.listenerTimeout
• plusieurs comptes : channels.discord.accounts.<accountId>.eventQueue.listenerTimeout
• cela contrôle uniquement le travail des écouteurs du Gateway Discord, pas la durée de vie du tour de l’agent

Discord n’applique pas de délai d’expiration propre au canal aux tours d’agent en file d’attente. Les écouteurs de messages transmettent immédiatement, et les exécutions Discord en file d’attente préservent l’ordre par session jusqu’à ce que le cycle de vie de la session, de l’outil ou de l’environnement d’exécution se termine ou abandonne le travail.

{
channels: {
discord: {
  accounts: {
    default: {
      eventQueue: {
        listenerTimeout: 120000,
      },
    },
  },
},
},
}

OpenClaw récupère les métadonnées Discord /gateway/bot avant de se connecter. Les échecs transitoires se rabattent sur l’URL de Gateway par défaut de Discord et sont limités en fréquence dans les journaux.

Paramètres de délai d’expiration des métadonnées :

• compte unique : channels.discord.gatewayInfoTimeoutMs
• comptes multiples : channels.discord.accounts.<accountId>.gatewayInfoTimeoutMs
• repli par variable d’environnement lorsque la configuration n’est pas définie : OPENCLAW_DISCORD_GATEWAY_INFO_TIMEOUT_MS
• valeur par défaut : 30000 (30 secondes), max : 120000

OpenClaw attend l’événement READY du Gateway Discord au démarrage et après les reconnexions à l’exécution. Les configurations à comptes multiples avec échelonnement du démarrage peuvent nécessiter une fenêtre READY de démarrage plus longue que la valeur par défaut.

Paramètres de délai d’expiration READY :

• démarrage, compte unique : channels.discord.gatewayReadyTimeoutMs
• démarrage, comptes multiples : channels.discord.accounts.<accountId>.gatewayReadyTimeoutMs
• repli par variable d’environnement au démarrage lorsque la configuration n’est pas définie : OPENCLAW_DISCORD_READY_TIMEOUT_MS
• valeur par défaut au démarrage : 15000 (15 secondes), max : 120000
• exécution, compte unique : channels.discord.gatewayRuntimeReadyTimeoutMs
• exécution, comptes multiples : channels.discord.accounts.<accountId>.gatewayRuntimeReadyTimeoutMs
• repli par variable d’environnement à l’exécution lorsque la configuration n’est pas définie : OPENCLAW_DISCORD_RUNTIME_READY_TIMEOUT_MS
• valeur par défaut à l’exécution : 30000 (30 secondes), max : 120000

Les vérifications de permissions channels status --probe ne fonctionnent que pour les ID de canal numériques.

Si vous utilisez des clés slug, la correspondance à l’exécution peut toujours fonctionner, mais la sonde ne peut pas vérifier entièrement les permissions.

• MP désactivés : channels.discord.dm.enabled=false
• stratégie de MP désactivée : channels.discord.dmPolicy="disabled" (hérité : channels.discord.dm.policy)
• attente de l’approbation d’appairage en mode pairing

Par défaut, les messages rédigés par des bots sont ignorés.

Si vous définissez channels.discord.allowBots=true, utilisez des règles strictes de mention et de liste d’autorisation pour éviter les comportements de boucle. Préférez channels.discord.allowBots="mentions" pour accepter uniquement les messages de bots qui mentionnent le bot.

{
channels: {
discord: {
  accounts: {
    mantis: {
      // Mantis listens to other bots only when they mention her.
      allowBots: "mentions",
    },
    molty: {
      // Molty listens to all bot-authored Discord messages.
      allowBots: true,
      mentionAliases: {
        // Lets Molty write "@Mantis" and send a real Discord mention.
        Mantis: "MANTIS_DISCORD_USER_ID",
      },
    },
  },
},
},
}

• gardez OpenClaw à jour (openclaw update) afin que la logique de récupération de réception vocale Discord soit présente
• confirmez channels.discord.voice.daveEncryption=true (par défaut)
• commencez avec channels.discord.voice.decryptionFailureTolerance=24 (valeur par défaut en amont) et ajustez uniquement si nécessaire
• surveillez les journaux pour :
  • discord voice: DAVE decrypt failures detected
  • discord voice: repeated decrypt failures; attempting rejoin
• si les échecs continuent après une reconnexion automatique, collectez les journaux et comparez-les à l’historique de réception DAVE en amont dans discord.js #11419 et discord.js #11449