Discord

OpenClaw maakt via de officiële Discord Gateway als bot verbinding met Discord. DM's en guildkanalen worden ondersteund.

Snelle installatie

Maak een Discord-toepassing met een bot, voeg de bot toe aan je server en koppel deze aan OpenClaw. Gebruik indien mogelijk een privéserver; maak er eerst een (Create My Own > For me and my friends) als dat nodig is.

export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"cat > discord.patch.json5 <<'JSON5'{channels: {discord: {  enabled: true,  token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },},},}JSON5openclaw config patch --file ./discord.patch.json5 --dry-runopenclaw config patch --file ./discord.patch.json5openclaw gateway

{channels: {discord: {enabled: true,token: {source: "env",provider: "default",id: "DISCORD_BOT_TOKEN",},},},}

DISCORD_BOT_TOKEN=...

{channels: {discord: {enabled: true,accounts: {personal: {  token: { source: "env", provider: "default", id: "DISCORD_PERSONAL_TOKEN" },  applicationId: "111111111111111111",},work: {  token: { source: "env", provider: "default", id: "DISCORD_WORK_TOKEN" },  applicationId: "222222222222222222",},},},},}

openclaw pairing list discordopenclaw pairing approve discord <CODE>

Aanbevolen: een guildwerkruimte instellen

Zodra DM's werken, kun je van je server een volledige werkruimte maken waarin elk kanaal een eigen agentsessie met een eigen context krijgt. Dit wordt aanbevolen voor privéservers waarop alleen jij en je bot aanwezig zijn.

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

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

Maak nu kanalen en begin met chatten. De agent ziet de kanaalnaam en elk kanaal is een geïsoleerde sessie — stel #programmeren, #thuis, #onderzoek of andere kanalen in die bij je werkstroom passen.

Runtimemodel

• De Gateway beheert de Discord-verbinding.
• De routering van antwoorden is deterministisch: inkomende Discord-berichten worden in Discord beantwoord.
• Metagegevens van Discord-guilds en -kanalen worden als niet-vertrouwde context aan de modelprompt toegevoegd, niet als een voor de gebruiker zichtbaar antwoordvoorvoegsel. Als een model die omhulling terugkopieert, verwijdert OpenClaw de gekopieerde metagegevens uit uitgaande antwoorden en uit toekomstige herhalingscontext.
• Directe chats delen standaard (session.dmScope=main) de hoofdsessie van de agent (agent:main:main).
• Guildkanalen hebben geïsoleerde sessiesleutels (agent:<agentId>:discord:channel:<channelId>).
• Groeps-DM's worden standaard genegeerd (channels.discord.dm.groupEnabled=false).
• Systeemeigen slash-opdrachten worden uitgevoerd in geïsoleerde opdrachtsessies (agent:<agentId>:discord:slash:<userId>), waarbij CommandTargetSessionKey nog steeds wordt doorgegeven aan de gerouteerde gesprekssessie.
• De levering van aankondigingen met alleen tekst vanuit Cron/Heartbeat aan Discord wordt samengevoegd tot het uiteindelijke, voor de assistent zichtbare antwoord en eenmaal verzonden. Media en gestructureerde componentladingen blijven uit meerdere berichten bestaan wanneer de agent meerdere leverbare ladingen produceert.

Forumkanalen

Discord-forum- en mediakanalen accepteren alleen threadberichten. OpenClaw ondersteunt twee manieren om deze te maken:

• Stuur een bericht naar het bovenliggende forumkanaal (channel:<forumId>) om automatisch een thread aan te maken. De threadtitel is de eerste niet-lege regel van het bericht (afgekapt tot Discords limiet van 100 tekens voor threadnamen).
• Gebruik openclaw message thread create om rechtstreeks een thread aan te maken. Geef --message-id niet door voor forumkanalen.

Stuur naar het bovenliggende forumkanaal om een thread aan te maken:

openclaw message send --channel discord --target channel:<forumId> \  --message "Topic title\nBody of the post"

Maak expliciet een forumthread aan:

openclaw message thread create --channel discord --target channel:<forumId> \  --thread-name "Topic title" --message "Body of the post"

Bovenliggende forumkanalen accepteren geen Discord-componenten. Als u componenten nodig hebt, stuur dan naar de thread zelf (channel:<threadId>).

Interactieve componenten

OpenClaw ondersteunt Discord-componentcontainers van versie 2 voor agentberichten. Gebruik de berichttool met een components-payload. Interactieresultaten worden als normale inkomende berichten teruggestuurd naar de agent en volgen de bestaande Discord-instellingen voor replyToMode.

Ondersteunde blokken:

• text, section, separator, actions, media-gallery, file
• Actierijen staan maximaal 5 knoppen of één selectiemenu toe
• Selectietypen: string, user, role, mentionable, channel

Componenten zijn standaard voor eenmalig gebruik. Stel components.reusable=true in om toe te staan dat knoppen, selecties en formulieren meerdere keren worden gebruikt totdat ze verlopen.

Om te beperken wie op een knop kan klikken, stelt u allowedUsers in voor die knop (Discord-gebruikers-ID's, tags of *). Niet-overeenkomende gebruikers ontvangen een tijdelijke afwijzing.

Componentcallbacks verlopen standaard na 30 minuten. Stel channels.discord.agentComponents.ttlMs in om de levensduur van het callbackregister voor het standaardaccount te wijzigen, of channels.discord.accounts.<accountId>.agentComponents.ttlMs per account. De waarde is in milliseconden, moet een positief geheel getal zijn en is begrensd op 86400000 (24 uur). Langere TTL's zijn geschikt voor beoordelings- en goedkeuringswerkstromen waarbij knoppen bruikbaar moeten blijven, maar verlengen het tijdvenster waarin een oud Discord-bericht nog een actie kan activeren. Kies bij voorkeur de kortst passende TTL en behoud de standaardwaarde wanneer verouderde callbacks onverwacht zouden zijn.

De slash-opdrachten /model en /models openen een interactieve modelkiezer met vervolgkeuzelijsten voor provider, model en compatibele runtime, plus een indieningsstap. /models add is verouderd en retourneert een verouderingsmelding in plaats van modellen vanuit de chat te registreren. Het antwoord van de kiezer is tijdelijk en kan alleen worden gebruikt door de gebruiker die de opdracht heeft aangeroepen. Discord-selectiemenu's zijn beperkt tot 25 opties. Voeg daarom provider/*-vermeldingen toe aan agents.defaults.models wanneer u wilt dat de kiezer dynamisch ontdekte modellen alleen toont voor geselecteerde providers zoals openai of vllm.

Bestandsbijlagen:

• file-blokken moeten verwijzen naar een bijlagereferentie (attachment://<filename>)
• Lever de bijlage aan via media/path/filePath (één bestand); gebruik media-gallery voor meerdere bestanden
• Gebruik filename om de uploadnaam te overschrijven wanneer deze met de bijlagereferentie moet overeenkomen

Modale formulieren:

• Voeg components.modal toe met maximaal 5 velden
• Veldtypen: text, checkbox, radio, select, role-select, user-select
• OpenClaw voegt automatisch een activeringsknop toe

Voorbeeld:

{  channel: "discord",  action: "send",  to: "channel:123456789012345678",  message: "Optional fallback text",  components: {    reusable: true,    text: "Choose a path",    blocks: [      {        type: "actions",        buttons: [          {            label: "Approve",            style: "success",            allowedUsers: ["123456789012345678"],          },          { label: "Decline", style: "danger" },        ],      },      {        type: "actions",        select: {          type: "string",          placeholder: "Pick an option",          options: [            { label: "Option A", value: "a" },            { label: "Option B", value: "b" },          ],        },      },    ],    modal: {      title: "Details",      triggerLabel: "Open form",      fields: [        { type: "text", label: "Requester" },        {          type: "select",          label: "Priority",          options: [            { label: "Low", value: "low" },            { label: "High", value: "high" },          ],        },      ],    },  },}

Toegangsbeheer en routering

{accessGroups: {operators: {  type: "message.senders",  members: {    "*": ["global-owner-id"],    discord: ["discord:123456789012345678"],    telegram: ["987654321"],  },},},channels: {discord: {  dmPolicy: "allowlist",  allowFrom: ["accessGroup:operators"],},},}

{accessGroups: {maintainers: {  type: "discord.channelAudience",  guildId: "1456350064065904867",  channelId: "1456744319972282449",  membership: "canViewChannel",},},channels: {discord: {  dmPolicy: "allowlist",  allowFrom: ["accessGroup:maintainers"],},},}

{accessGroups: {maintainers: {  type: "discord.channelAudience",  guildId: "1456350064065904867",  channelId: "1456744319972282449",},},channels: {discord: {  dmPolicy: "allowlist",  allowFrom: ["accessGroup:maintainers", "discord:123456789012345678"],},},}

{channels: {discord: {  groupPolicy: "allowlist",  guilds: {    "123456789012345678": {      requireMention: true,      ignoreOtherMentions: true,      users: ["987654321098765432"],      roles: ["123456789012345678"],      channels: {        general: { enabled: true },        help: { enabled: true, requireMention: true },      },    },  },},},}

Agentroutering op basis van rollen

Gebruik bindings[].match.roles om Discord-serverleden op basis van rol-ID naar verschillende agents te routeren. Rolgebaseerde bindingen accepteren alleen rol-ID's en worden geëvalueerd na bindingen voor peers of bovenliggende peers en vóór bindingen die alleen voor servers gelden. Als een binding ook andere overeenkomstvelden instelt (bijvoorbeeld peer + guildId + roles), moeten alle geconfigureerde velden overeenkomen.

{  bindings: [    {      agentId: "opus",      match: {        channel: "discord",        guildId: "123456789012345678",        roles: ["111111111111111111"],      },    },    {      agentId: "sonnet",      match: {        channel: "discord",        guildId: "123456789012345678",      },    },  ],}

Systeemeigen opdrachten en opdracht­autorisatie

• commands.native is standaard ingesteld op "auto" en is ingeschakeld voor Discord.
• Overschrijving per kanaal: channels.discord.commands.native.
• Met commands.native=false worden registratie en opschoning van Discord-slashcommando's tijdens het opstarten overgeslagen. Eerder geregistreerde commando's kunnen zichtbaar blijven in Discord totdat u ze uit de Discord-app verwijdert.
• Autorisatie voor systeemeigen commando's gebruikt dezelfde Discord-toelatingslijsten en hetzelfde beleid als normale berichtverwerking.
• Commando's kunnen in de Discord-interface nog steeds zichtbaar zijn voor onbevoegde gebruikers; bij uitvoering wordt OpenClaw-autorisatie afgedwongen en wordt "niet geautoriseerd" geantwoord.
• Standaardinstellingen voor slashcommando's: ephemeral: true (channels.discord.slashCommand.ephemeral).

Zie Slashcommando's voor de commandocatalogus en het gedrag.

Functiedetails

{channels: {discord: {  suppressEmbeds: false,},},}

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

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

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

{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,        },      },    },  },},},}

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

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

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

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

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

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

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

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

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

Gereedschappen en actiedrempels

Discord-berichtacties omvatten berichten, kanaalbeheer, moderatie, aanwezigheid en metagegevens.

Kernvoorbeelden:

• berichten: sendMessage, readMessages, editMessage, deleteMessage, threadReply
• reacties: react, reactions, emojiList
• moderatie: timeout, kick, ban
• aanwezigheid: setPresence

De actie event-create accepteert een optionele parameter image (URL of lokaal bestandspad) om de omslagafbeelding van de geplande gebeurtenis in te stellen.

Actiedrempels bevinden zich onder channels.discord.actions.*.

Standaardgedrag van drempels:

Gebruikersinterface met componenten v2

OpenClaw gebruikt Discord-componenten v2 voor uitvoeringsgoedkeuringen en markeringen tussen contexten. Discord-berichtacties kunnen ook components accepteren voor een aangepaste gebruikersinterface (geavanceerd; vereist het samenstellen van een componentpayload via het Discord-gereedschap), terwijl verouderde embeds beschikbaar blijven maar niet worden aanbevolen.

• channels.discord.ui.components.accentColor stelt de accentkleur in die door Discord-componentcontainers wordt gebruikt (hexadecimaal). Per account: channels.discord.accounts.<id>.ui.components.accentColor.
• channels.discord.agentComponents.ttlMs bepaalt hoelang callbacks van verzonden Discord-componenten geregistreerd blijven (standaard 1800000, maximaal 86400000). Per account: channels.discord.accounts.<id>.agentComponents.ttlMs.
• embeds worden genegeerd wanneer componenten v2 aanwezig zijn.
• Voorvertoningen van gewone URL's worden standaard onderdrukt. Stel suppressEmbeds: false in voor een berichtactie wanneer één uitgaande koppeling moet worden uitgevouwen.

Voorbeeld:

{  channels: {    discord: {      ui: {        components: {          accentColor: "#5865F2",        },      },    },  },}

Spraak

Discord heeft twee afzonderlijke spraakmogelijkheden: realtime spraakkanalen (doorlopende gesprekken) en spraakberichtbijlagen (de indeling met golfvormvoorvertoning). De Gateway ondersteunt beide.

Spraakkanalen

Controlelijst voor de configuratie:

1. Schakel Message Content Intent in het Discord Developer Portal in.
2. Schakel Server Members Intent in wanneer toelatingslijsten voor rollen/gebruikers worden gebruikt.
3. Nodig de bot uit met de bereiken bot en applications.commands.
4. Verleen Connect, Speak, Send Messages en Read Message History in het doelspraakkanaal.
5. Schakel systeemeigen opdrachten in (commands.native of channels.discord.commands.native).
6. Configureer channels.discord.voice.

Gebruik /vc join|leave|status om sessies te beheren. De opdracht gebruikt de standaardagent van het account en volgt dezelfde regels voor toelatingslijsten en groepsbeleid als andere Discord-opdrachten.

/vc join channel:<voice-channel-id>/vc status/vc leave

Om de effectieve machtigingen van de bot te controleren voordat deze deelneemt:

openclaw channels capabilities --channel discord --target channel:<voice-channel-id>

Voorbeeld van automatisch deelnemen:

{  channels: {    discord: {      voice: {        enabled: true,        model: "openai/gpt-5.6-sol",        autoJoin: [          {            guildId: "123456789012345678",            channelId: "234567890123456789",          },        ],        allowedChannels: [          {            guildId: "123456789012345678",            channelId: "234567890123456789",          },        ],        daveEncryption: true,        decryptionFailureTolerance: 24,        connectTimeoutMs: 30000,        reconnectGraceMs: 15000,        realtime: {          provider: "openai",          model: "gpt-realtime-2.1",          speakerVoice: "cedar",        },      },    },  },}

Opmerkingen:

• Discord-spraak is opt-in voor configuraties met alleen tekst; stel channels.discord.voice.enabled=true in (of behoud een bestaand channels.discord.voice-blok) om /vc-opdrachten, de spraakruntime en de Gateway-intentie GuildVoiceStates in te schakelen. Met channels.discord.intents.voiceStates kan het abonnement op de intentie expliciet worden overschreven; laat dit oningesteld om de effectieve inschakeling van spraak te volgen.
• voice.mode bepaalt het gesprekspad. De standaard is agent-proxy: een realtime spraakfrontend verwerkt de timing van beurten, onderbrekingen en het afspelen, delegeert inhoudelijk werk via openclaw_agent_consult aan de gerouteerde OpenClaw-agent en behandelt het resultaat als een door die spreker getypte Discord-prompt. stt-tts behoudt de oudere batchflow met STT en TTS. Met bidi kan het realtime model rechtstreeks converseren, terwijl openclaw_agent_consult beschikbaar blijft voor het OpenClaw-brein.
• voice.agentSession bepaalt welk OpenClaw-gesprek spraakbeurten ontvangt. Laat dit oningesteld voor de eigen sessie van het spraakkanaal, of stel { mode: "target", target: "channel:<text-channel-id>" } in om het spraakkanaal te laten fungeren als microfoon-/luidsprekeruitbreiding van een bestaande Discord-tekstkanaalsessie, zoals #maintainers.
• voice.model overschrijft het OpenClaw-agentbrein voor Discord-spraakantwoorden en realtime raadplegingen. Laat dit oningesteld om het model van de gerouteerde agent over te nemen. Dit staat los van voice.realtime.model.
• Met voice.followUsers kan de bot samen met geselecteerde gebruikers deelnemen aan Discord-spraak, van kanaal wisselen en vertrekken. Zie Gebruikers volgen in spraak.
• agent-proxy routeert spraak via discord-voice, waardoor de normale autorisatie van de eigenaar en tools voor de spreker en doelsessie behouden blijft, maar de agenttool tts wordt verborgen omdat Discord-spraak het afspelen beheert. Standaard geeft agent-proxy de raadpleging voor eigenaarsprekers volledige tooltoegang die gelijkwaardig is aan die van de eigenaar (voice.realtime.toolPolicy: "owner") en wordt sterk de voorkeur gegeven aan het raadplegen van de OpenClaw-agent vóór inhoudelijke antwoorden (voice.realtime.consultPolicy: "always"). In die standaardmodus always spreekt de realtimelaag niet automatisch opvultekst uit vóór het antwoord van de raadpleging; de laag legt spraak vast en transcribeert deze, en spreekt vervolgens het gerouteerde OpenClaw-antwoord uit. Als meerdere afgedwongen raadpleegantwoorden gereedkomen terwijl Discord het eerste antwoord nog afspeelt, worden latere antwoorden met exact uit te spreken tekst in de wachtrij geplaatst totdat het afspelen inactief is, in plaats van spraak midden in een zin te vervangen.
• In de modus stt-tts gebruikt STT tools.media.audio; voice.model heeft geen invloed op transcriptie.
• In realtimemodi configureren voice.realtime.provider, voice.realtime.model en voice.realtime.speakerVoice de realtime audiosessie. Gebruik voor OpenAI Realtime 2.1 met het Codex-brein voice.realtime.model: "gpt-realtime-2.1" en voice.model: "openai/gpt-5.6-sol".
• Realtime spraakmodi nemen standaard kleine profielbestanden IDENTITY.md, USER.md en SOUL.md op in de instructies voor de realtime provider, zodat snelle rechtstreekse beurten dezelfde identiteit, gebruikerscontext en persona behouden als de gerouteerde OpenClaw-agent. Stel voice.realtime.bootstrapContextFiles in op een subset om dit aan te passen, of op [] om het uit te schakelen. Alleen deze profielbestanden worden ondersteund; AGENTS.md blijft in de normale agentcontext. De geïnjecteerde profielcontext vervangt openclaw_agent_consult niet voor werk in de werkruimte, actuele feiten, het opzoeken van geheugen of door tools ondersteunde acties.
• Stel in de OpenAI-realtimemodus agent-proxy voice.realtime.requireWakeName: true in om Discord-realtimespraak stil te houden totdat een transcript begint of eindigt met een weknaam. Geconfigureerde weknamen moeten uit één of twee woorden bestaan. Als voice.realtime.wakeNames niet is ingesteld, gebruikt OpenClaw de name van de gerouteerde agent plus OpenClaw, met als terugval de agent-id plus OpenClaw. Filteren op weknaam schakelt automatische antwoorden van de realtime provider uit, routeert geaccepteerde beurten via het raadpleegpad van de OpenClaw-agent en geeft een korte gesproken bevestiging wanneer een voorafgaande weknaam in een gedeeltelijke transcriptie wordt herkend voordat het definitieve transcript binnenkomt.
• De OpenAI-realtimeprovider accepteert huidige Realtime 2-gebeurtenisnamen en oudere Codex-compatibele aliassen voor gebeurtenissen voor uitvoeraudio en transcripties, zodat compatibele providersnapshots kunnen afwijken zonder assistentaudio te verliezen.
• voice.realtime.bargeIn bepaalt of gebeurtenissen waarbij een Discord-spreker begint te spreken het actieve realtime afspelen onderbreken. Als dit niet is ingesteld, volgt het de instelling van de realtime provider voor onderbreking door invoeraudio.
• voice.realtime.minBargeInAudioEndMs bepaalt de minimale afspeelduur van de assistent voordat een realtime onderbreking van OpenAI de audio afkapt. Standaard: 250. Stel 0 in voor onmiddellijke onderbreking in ruimten met weinig echo, of verhoog de waarde voor luidsprekeropstellingen met veel echo.
• voice.tts overschrijft messages.tts uitsluitend voor spraakweergave met stt-tts; realtimemodi gebruiken in plaats daarvan voice.realtime.speakerVoice. Stel voor een OpenAI-stem bij afspelen op Discord voice.tts.provider: "openai" in en kies een tekst-naar-spraakstem onder voice.tts.providers.openai.speakerVoice. cedar is een goede keuze met een mannelijke klank in het huidige OpenAI TTS-model.
• Discord-overschrijvingen van systemPrompt per kanaal zijn van toepassing op transcriptbeurten voor dat spraakkanaal.
• Spraaktranscriptbeurten leiden voor opdrachten en kanaalacties die aan de eigenaar zijn voorbehouden de eigenaarstatus af uit Discord allowFrom (of dm.allowFrom). De zichtbaarheid van agenttools volgt het geconfigureerde toolbeleid voor de gerouteerde sessie.
• Als voice.autoJoin meerdere vermeldingen voor dezelfde server bevat, neemt OpenClaw deel aan het laatst geconfigureerde kanaal voor die server.
• voice.allowedChannels is een optionele toelatingslijst voor verblijf. Laat dit oningesteld om /vc join deelname te laten toestaan aan elk geautoriseerd Discord-spraakkanaal. Wanneer dit is ingesteld, worden /vc join, automatisch deelnemen bij het opstarten en verplaatsingen van de spraakstatus van de bot beperkt tot de vermelde { guildId, channelId }-vermeldingen. Stel dit in op een lege array om alle deelnames aan Discord-spraak te weigeren. Als Discord de bot buiten de toelatingslijst verplaatst, verlaat OpenClaw dat kanaal en neemt het opnieuw deel aan het geconfigureerde doel voor automatisch deelnemen wanneer dat beschikbaar is.
• voice.daveEncryption en voice.decryptionFailureTolerance worden doorgegeven aan de opties voor deelname van @discordjs/voice; de bovenliggende standaardwaarden zijn daveEncryption=true en decryptionFailureTolerance=24.
• OpenClaw gebruikt de meegeleverde codec libopus-wasm voor het ontvangen van Discord-spraak en het realtime afspelen van onbewerkte PCM. Deze bevat een vastgezette libopus-WebAssembly-build en vereist geen systeemeigen opus-add-ons.
• voice.connectTimeoutMs bepaalt de initiële wachttijd op Ready van @discordjs/voice voor /vc join en pogingen om automatisch deel te nemen. Standaard: 30000.
• voice.reconnectGraceMs bepaalt hoelang OpenClaw wacht tot een verbroken spraaksessie opnieuw verbinding begint te maken voordat deze wordt vernietigd. Standaard: 15000.
• In de modus stt-tts stopt het afspelen van spraak niet alleen omdat een andere gebruiker begint te spreken. Om feedbacklussen te voorkomen negeert OpenClaw nieuwe spraakopname terwijl TTS wordt afgespeeld; spreek na afloop van het afspelen voor de volgende beurt. Realtimemodi sturen het begin van spraak door als onderbrekingssignaal naar de realtime provider.
• In realtimemodi kan echo van luidsprekers naar een open microfoon op een onderbreking lijken en het afspelen onderbreken. Stel voor Discord-ruimten met veel echo voice.realtime.providers.openai.interruptResponseOnInputAudio: false in om te voorkomen dat OpenAI automatisch onderbreekt bij invoeraudio. Voeg voice.realtime.bargeIn: true toe als gebeurtenissen waarbij een Discord-spreker begint te spreken het actieve afspelen nog steeds moeten onderbreken. De realtimebrug van OpenAI negeert afkappingen van het afspelen die korter zijn dan voice.realtime.minBargeInAudioEndMs als waarschijnlijke echo of ruis en registreert deze als overgeslagen, in plaats van het afspelen in Discord te wissen.
• voice.captureSilenceGraceMs bepaalt hoelang OpenClaw wacht nadat Discord meldt dat een spreker is gestopt, voordat dat audiosegment voor STT wordt afgerond. Standaard: 2000; verhoog dit als Discord normale pauzes opsplitst in schokkerige gedeeltelijke transcripties.
• Wanneer ElevenLabs de geselecteerde TTS-provider is, gebruikt het afspelen van Discord-spraak streaming-TTS en begint het vanuit de antwoordstream van de provider. Providers zonder ondersteuning voor streaming vallen terug op het pad met een gesynthetiseerd tijdelijk bestand.
• OpenClaw bewaakt ontsleutelingsfouten bij ontvangst en herstelt automatisch door het spraakkanaal te verlaten en opnieuw deel te nemen na herhaalde fouten binnen een kort tijdsvenster.
• Als ontvangstlogboeken na een update herhaaldelijk DecryptionFailed(UnencryptedWhenPassthroughDisabled) tonen, verzamel dan een afhankelijkheidsrapport en logboeken. De meegeleverde versie van @discordjs/voice bevat de bovenliggende oplossing voor opvulling uit discord.js-PR #11449, waarmee discord.js-issue #11419 werd gesloten.
• Ontvangstgebeurtenissen met The operation was aborted zijn te verwachten wanneer OpenClaw een vastgelegd sprekersegment afrondt; het zijn uitgebreide diagnostische meldingen, geen waarschuwingen.
• Uitgebreide logboeken voor Discord-spraak bevatten voor elk geaccepteerd sprekersegment een begrensd transcriptievoorbeeld van één regel voor STT, zodat bij foutopsporing zowel de kant van de gebruiker als die van het agentantwoord zichtbaar is zonder onbeperkte transcriptietekst te dumpen.
• In de modus agent-proxy slaat de afgedwongen terugval naar raadpleging waarschijnlijk onvolledige transcriptfragmenten over, zoals tekst die eindigt op ... of op een afsluitend verbindingswoord zoals "en", evenals duidelijke afsluitingen zonder uitvoerbare actie zoals "ben zo terug" of "doei". De logboeken tonen forced agent consult skipped reason=... wanneer dit een verouderd antwoord in de wachtrij voorkomt.

Gebruikers volgen in spraak

Gebruik voice.followUsers wanneer je wilt dat de Discord-spraakbot bij een of meer bekende Discord-gebruikers blijft, in plaats van bij het opstarten deel te nemen aan een vast kanaal of op /vc join te wachten.

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

Gedrag:

• followUsers accepteert onbewerkte Discord-gebruikers-id's en waarden van de vorm discord:<id>. OpenClaw normaliseert beide vormen voordat spraakstatusgebeurtenissen worden vergeleken.
• followUsersEnabled is standaard true wanneer followUsers is geconfigureerd. Stel dit in op false om de opgeslagen lijst te behouden maar automatisch volgen in spraak te stoppen.
• Wanneer een gevolgde gebruiker deelneemt aan een toegestaan spraakkanaal, neemt OpenClaw deel aan dat kanaal. Wanneer de gebruiker van kanaal wisselt, gaat OpenClaw mee. Wanneer de actieve gevolgde gebruiker de verbinding verbreekt, vertrekt OpenClaw.
• Als meerdere gevolgde gebruikers zich op dezelfde server bevinden en de actieve gevolgde gebruiker vertrekt, gaat OpenClaw naar het kanaal van een andere bijgehouden gevolgde gebruiker voordat het de server verlaat. Als meerdere gevolgde gebruikers tegelijk van kanaal wisselen, is de laatst waargenomen spraakstatusgebeurtenis bepalend.
• allowedChannels blijft van toepassing. Een gevolgde gebruiker in een niet-toegestaan kanaal wordt genegeerd en een door volgen beheerde sessie gaat naar een andere gevolgde gebruiker of vertrekt.
• OpenClaw stemt gemiste spraakstatusgebeurtenissen bij het opstarten en met een begrensd interval af. Bij de afstemming worden geconfigureerde servers steekproefsgewijs gecontroleerd en wordt het aantal REST-opzoekacties per uitvoering begrensd, waardoor het bij zeer grote followUsers-lijsten meer dan één interval kan duren voordat alles is afgestemd.
• Als Discord of een beheerder de bot verplaatst terwijl deze een gebruiker volgt, bouwt OpenClaw de spraaksessie opnieuw op en blijft het eigenaarschap van het volgen behouden wanneer de bestemming is toegestaan. Als de bot buiten allowedChannels wordt verplaatst, vertrekt OpenClaw en neemt het opnieuw deel aan het geconfigureerde doel wanneer dat bestaat.
• DAVE-herstel bij ontvangst kan hetzelfde kanaal na herhaalde ontsleutelingsfouten verlaten en er opnieuw aan deelnemen. Door volgen beheerde sessies behouden tijdens dat herstelpad het eigenaarschap van het volgen, zodat het kanaal alsnog wordt verlaten wanneer een gevolgde gebruiker later de verbinding verbreekt.

Kies uit de deelnamemodi:

• Gebruik followUsers voor persoonlijke opstellingen of beheerdersopstellingen waarbij de bot automatisch in een spraakkanaal moet zijn wanneer jij dat bent.
• Gebruik autoJoin voor bots in vaste ruimten die aanwezig moeten zijn, zelfs wanneer geen bijgehouden gebruiker in een spraakkanaal aanwezig is.
• Gebruik /vc join voor eenmalige deelnames of ruimten waarin automatische aanwezigheid in een spraakkanaal onverwacht zou zijn.

Codec voor Discord-spraak:

• Logboeken voor spraakontvangst tonen discord voice: opus decoder: libopus-wasm.
• Bij realtime afspelen wordt onbewerkte 48kHz-stereo-PCM met hetzelfde meegeleverde pakket libopus-wasm naar Opus gecodeerd voordat pakketten aan @discordjs/voice worden doorgegeven.
• Bij het afspelen van bestanden en providerstreams wordt met ffmpeg getranscodeerd naar onbewerkte 48kHz-stereo-PCM, waarna libopus-wasm wordt gebruikt voor de Opus-pakketstream die naar Discord wordt verzonden.

STT- plus TTS-pijplijn:

• Discord PCM-opname wordt geconverteerd naar een tijdelijk WAV-bestand.
• tools.media.audio verwerkt STT, bijvoorbeeld openai/gpt-4o-mini-transcribe.
• Het transcript wordt via Discord-invoer en -routering verzonden, terwijl het respons-LLM wordt uitgevoerd met een beleid voor spraakuitvoer dat de agenttool tts verbergt en om geretourneerde tekst vraagt, omdat Discord-spraak verantwoordelijk is voor de uiteindelijke TTS-weergave.
• Als voice.model is ingesteld, overschrijft dit alleen het respons-LLM voor deze beurt in het spraakkanaal.
• voice.tts wordt over messages.tts heen samengevoegd; providers die streaming ondersteunen leveren rechtstreeks aan de speler, anders wordt het resulterende audiobestand afgespeeld in het kanaal waaraan is deelgenomen.

Voorbeeld van een standaardsessie voor een agentproxy-spraakkanaal:

{  channels: {    discord: {      voice: {        enabled: true,        model: "openai/gpt-5.6-sol",        followUsersEnabled: true,        followUsers: ["123456789012345678"],        realtime: {          provider: "openai",          model: "gpt-realtime-2.1",          speakerVoice: "cedar",        },      },    },  },}

Zonder een voice.agentSession-blok krijgt elk spraakkanaal een eigen gerouteerde OpenClaw-sessie. Zo communiceert /vc join channel:234567890123456789 bijvoorbeeld met de sessie voor dat Discord-spraakkanaal. Het realtimemodel is alleen de spraakfrontend; inhoudelijke verzoeken worden doorgegeven aan de geconfigureerde OpenClaw-agent. Als het realtimemodel een definitief transcript produceert zonder de consultatietool aan te roepen, dwingt OpenClaw de consultatie als terugvaloptie af, zodat de standaard zich nog steeds gedraagt alsof er met de agent wordt gesproken.

Voorbeeld van oudere STT plus TTS:

{  channels: {    discord: {      voice: {        enabled: true,        mode: "stt-tts",        model: "openai/gpt-5.4-mini",        tts: {          provider: "openai",          providers: {            openai: {              model: "gpt-4o-mini-tts",              speakerVoice: "cedar",            },          },        },      },    },  },}

Voorbeeld van realtime bidirectionele communicatie:

{  channels: {    discord: {      voice: {        enabled: true,        mode: "bidi",        model: "openai/gpt-5.6-sol",        realtime: {          provider: "openai",          model: "gpt-realtime-2.1",          speakerVoice: "cedar",          toolPolicy: "safe-read-only",          consultPolicy: "always",        },      },    },  },}

Spraak als uitbreiding van een bestaande Discord-kanaalsessie:

{  channels: {    discord: {      voice: {        enabled: true,        mode: "agent-proxy",        model: "openai/gpt-5.6-sol",        agentSession: {          mode: "target",          target: "channel:123456789012345678",        },        realtime: {          provider: "openai",          model: "gpt-realtime-2.1",          speakerVoice: "cedar",        },      },    },  },}

In de modus agent-proxy neemt de bot deel aan het geconfigureerde spraakkanaal, maar OpenClaw-agentbeurten gebruiken de normale gerouteerde sessie en agent van het doelkanaal. De realtime-spraaksessie spreekt het geretourneerde resultaat weer uit in het spraakkanaal. De supervisoragent kan volgens zijn toolbeleid nog steeds normale berichttools gebruiken, waaronder het verzenden van een afzonderlijk Discord-bericht als dat de juiste actie is.

Terwijl een gedelegeerde OpenClaw-uitvoering actief is, worden nieuwe Discord-spraaktranscripten behandeld als live besturing van de uitvoering voordat een nieuwe agentbeurt wordt gestart. Zinnen als ‘status’, ‘annuleer dat’, ‘gebruik de kleinere oplossing’ of ‘controleer ook de tests wanneer je klaar bent’ worden geclassificeerd als status-, annulerings-, bijsturings- of vervolginvoer voor de actieve sessie. De resultaten van status, annulering, geaccepteerde bijsturing en vervolgacties worden teruggesproken in het spraakkanaal, zodat de beller weet of OpenClaw het verzoek heeft verwerkt.

Bruikbare doelvormen:

• target: "channel:123456789012345678" routeert via een Discord-tekstkanaalsessie.
• target: "123456789012345678" wordt behandeld als een kanaaldoel.
• target: "dm:123456789012345678" of target: "user:123456789012345678" routeert via die direct-berichtsessie.

Voorbeeld voor OpenAI Realtime met veel echo:

{  channels: {    discord: {      voice: {        enabled: true,        mode: "bidi",        model: "openai/gpt-5.6-sol",        realtime: {          provider: "openai",          model: "gpt-realtime-2.1",          speakerVoice: "cedar",          bargeIn: true,          minBargeInAudioEndMs: 500,          consultPolicy: "always",          providers: {            openai: {              interruptResponseOnInputAudio: false,            },          },        },      },    },  },}

Gebruik dit wanneer het model zijn eigen Discord-weergave via een open microfoon hoort, maar u het nog steeds wilt kunnen onderbreken door te spreken. OpenClaw voorkomt dat OpenAI automatisch onderbreekt bij onbewerkte invoeraudio, terwijl bargeIn: true ervoor zorgt dat gebeurtenissen waarbij een Discord-spreker begint en audio van een reeds actieve spreker actieve realtime-antwoorden kunnen annuleren voordat de volgende opgenomen beurt OpenAI bereikt. Zeer vroege onderbrekingssignalen met een audioEndMs onder minBargeInAudioEndMs worden beschouwd als waarschijnlijke echo of ruis en genegeerd, zodat het model niet bij het eerste weergaveframe wordt afgekapt.

Verwachte spraaklogboeken:

• Bij deelname: discord voice: joining ... voiceSession=... supervisorSession=... agentSessionMode=... voiceModel=... realtimeModel=...
• Bij het starten van realtime: discord voice: realtime bridge starting ... autoRespond=false interruptResponse=false bargeIn=false minBargeInAudioEndMs=...
• Bij sprekeraudio: discord voice: realtime speaker turn opened ..., discord voice: realtime input audio started ... outputAudioMs=... outputActive=... en discord voice: realtime speaker turn closed ... chunks=... discordBytes=... realtimeBytes=... interruptedPlayback=...
• Bij overgeslagen verouderde spraak: discord voice: realtime forced agent consult skipped reason=incomplete-transcript ... of reason=non-actionable-closing ...
• Bij voltooiing van een realtime-antwoord: discord voice: realtime audio playback finishing reason=response.done ... audioMs=... chunks=...
• Bij stoppen of opnieuw instellen van de weergave: discord voice: realtime audio playback stopped reason=... audioMs=... elapsedMs=... chunks=...
• Bij realtime-consultatie: discord voice: realtime consult requested ... voiceSession=... supervisorSession=... question=...
• Bij het antwoord van de agent: discord voice: agent turn answer ...
• Bij exact uitgesproken tekst in de wachtrij: discord voice: realtime exact speech queued ... queued=... outputAudioMs=... outputActive=..., gevolgd door discord voice: realtime exact speech dequeued reason=player-idle ...
• Bij detectie van een onderbreking: discord voice: realtime barge-in detected source=speaker-start ... of discord voice: realtime barge-in detected source=active-speaker-audio ..., gevolgd door discord voice: realtime barge-in requested reason=... outputAudioMs=... outputActive=...
• Bij realtime-onderbreking: discord voice: realtime model interrupt requested client:response.cancel reason=barge-in, gevolgd door discord voice: realtime model audio truncated client:conversation.item.truncate reason=barge-in audioEndMs=... of discord voice: realtime model interrupt confirmed server:response.done status=cancelled ...
• Bij genegeerde echo of ruis: discord voice: realtime model interrupt ignored client:conversation.item.truncate.skipped reason=barge-in audioEndMs=0 minAudioEndMs=250
• Bij uitgeschakelde onderbreking: discord voice: realtime capture ignored during playback (barge-in disabled) ...
• Bij inactieve weergave: discord voice: realtime barge-in ignored reason=... outputActive=false ... playbackChunks=0

Lees de realtime-spraaklogboeken als een tijdlijn om afgekapt geluid te onderzoeken:

1. realtime audio playback started betekent dat Discord is begonnen met het afspelen van assistentaudio. Vanaf dit punt begint de bridge assistentuitvoerfragmenten, Discord PCM-bytes, realtimebytes van de provider en de duur van gesynthetiseerde audio te tellen.
2. realtime speaker turn opened markeert dat een Discord-spreker actief wordt. Als de weergave al actief is en bargeIn is ingeschakeld, kan dit worden gevolgd door barge-in detected source=speaker-start.
3. realtime input audio started markeert het eerste daadwerkelijke audioframe dat voor die spreekbeurt is ontvangen. outputActive=true of een niet-nulwaarde voor outputAudioMs betekent hier dat de microfoon invoer verzendt terwijl de assistentweergave nog actief is.
4. barge-in detected source=active-speaker-audio betekent dat OpenClaw live sprekeraudio heeft gedetecteerd terwijl de assistentweergave actief was. Dit is nuttig om een echte onderbreking te onderscheiden van een Discord-gebeurtenis waarbij een spreker begint zonder bruikbare audio.
5. barge-in requested reason=... betekent dat OpenClaw de realtimeprovider heeft gevraagd het actieve antwoord te annuleren of af te kappen. Dit bevat outputAudioMs, outputActive en playbackChunks, zodat u kunt zien hoeveel assistentaudio daadwerkelijk was afgespeeld voordat de onderbreking plaatsvond.
6. realtime audio playback stopped reason=... is het lokale resetpunt voor Discord-weergave. De reden geeft aan wie de weergave heeft gestopt: barge-in, player-idle, provider-clear-audio, forced-agent-consult, stream-close of session-close.
7. realtime speaker turn closed vat de opgenomen invoerbeurt samen. chunks=0 of hasAudio=false betekent dat de spreekbeurt is geopend, maar dat geen bruikbare audio de realtime-bridge heeft bereikt. interruptedPlayback=true betekent dat die invoerbeurt overlapte met assistentuitvoer en de onderbrekingslogica activeerde.

Bruikbare velden:

• outputAudioMs: duur van de assistentaudio die vóór de logregel door de realtimeprovider is gegenereerd.
• audioMs: duur van de assistentaudio die OpenClaw heeft geteld voordat de weergave stopte.
• elapsedMs: verstreken kloktijd tussen het openen en sluiten van de weergavestream of spreekbeurt.
• discordBytes: 48kHz-stereo-PCM-bytes die naar Discord-spraak zijn verzonden of ervan zijn ontvangen.
• realtimeBytes: PCM-bytes in providerindeling die naar de realtimeprovider zijn verzonden of ervan zijn ontvangen.
• playbackChunks: fragmenten van assistentaudio die voor het actieve antwoord naar Discord zijn doorgestuurd.
• sinceLastAudioMs: tijd tussen het laatst opgenomen audioframe van de spreker en het sluiten van de spreekbeurt.

Veelvoorkomende patronen:

• Onmiddellijk afkappen met source=active-speaker-audio, een kleine outputAudioMs en dezelfde gebruiker in de buurt wijst meestal op luidsprekerecho die de microfoon binnenkomt. Verhoog voice.realtime.minBargeInAudioEndMs, verlaag het luidsprekervolume, gebruik een hoofdtelefoon of stel voice.realtime.providers.openai.interruptResponseOnInputAudio: false in.
• source=speaker-start gevolgd door speaker turn closed ... hasAudio=false betekent dat Discord het begin van een spreker heeft gemeld, maar dat geen audio OpenClaw heeft bereikt. Dit kan een tijdelijke Discord-spraakgebeurtenis, gedrag van de ruispoort of een client zijn die de microfoon kort activeert.
• audio playback stopped reason=stream-close zonder een onderbreking of provider-clear-audio in de buurt betekent dat de lokale Discord-weergavestream onverwacht is beëindigd. Controleer de voorafgaande logboeken van de provider en Discord-speler.
• capture ignored during playback (barge-in disabled) betekent dat OpenClaw invoer opzettelijk heeft genegeerd terwijl assistentaudio actief was. Schakel voice.realtime.bargeIn in als u wilt dat spraak de weergave onderbreekt.
• barge-in ignored ... outputActive=false betekent dat Discord of de VAD van de provider spraak heeft gemeld, maar dat OpenClaw geen actieve weergave had om te onderbreken. Dit hoort geen audio af te kappen.

Referenties worden per component opgezocht: authenticatie van de LLM-route voor voice.model, STT-authenticatie voor tools.media.audio, TTS-authenticatie voor messages.tts/voice.tts en authenticatie van de realtimeprovider voor voice.realtime.providers of de normale authenticatieconfiguratie van de provider.

Spraakberichten

Discord-spraakberichten tonen een golfvormvoorbeeld en vereisen OGG/Opus-audio. OpenClaw genereert de golfvorm automatisch, maar heeft ffmpeg en ffprobe op de Gateway-host nodig om de audio te inspecteren en converteren.

• Geef een lokaal bestandspad op (URL's worden geweigerd).
• Laat tekstinhoud weg (Discord weigert tekst en een spraakbericht in dezelfde payload).
• Elke audio-indeling wordt geaccepteerd; OpenClaw converteert deze zo nodig naar OGG/Opus.

message(action="send", channel="discord", target="channel:123", path="/path/to/audio.mp3", asVoice=true)

Problemen oplossen

openclaw doctoropenclaw channels status --probeopenclaw logs --follow

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

{channels: {defaults: {  botLoopProtection: {    maxEventsPerWindow: 20,    windowSeconds: 60,    cooldownSeconds: 60,  },},discord: {  // Optionele Discord-brede overschrijving. Accountblokken overschrijven afzonderlijke  // velden en nemen weggelaten velden hiervandaan over.  botLoopProtection: {    maxEventsPerWindow: 4,  },  accounts: {    alpha: {      // Alpha luistert alleen naar andere bots wanneer die Alpha vermelden.      allowBots: "mentions",    },    bravo: {      // Bravo luistert naar alle door bots geschreven Discord-berichten.      allowBots: true,      mentionAliases: {        // Hiermee kan Bravo een Discord-vermelding van Alpha schrijven met het geconfigureerde gebruikers-ID.        Alpha: "ALPHA_DISCORD_USER_ID",      },      botLoopProtection: {        // Sta maximaal vijf berichten per minuut toe voordat het paar wordt onderdrukt.        maxEventsPerWindow: 5,        windowSeconds: 60,        cooldownSeconds: 90,      },    },  },},},}

Configuratiereferentie

Primaire referentie: Configuratiereferentie - Discord.

Veiligheid en beheer

• Behandel bottokens als geheimen (DISCORD_BOT_TOKEN heeft de voorkeur in beheerde omgevingen).
• Verleen Discord-permissies volgens het principe van minimale bevoegdheden.
• Als de implementatie of status van opdrachten verouderd is, start je de Gateway opnieuw en controleer je deze opnieuw met openclaw channels status --probe.

Gerelateerd