Naar hoofdinhoud gaan
Gereed voor DM’s en guildkanalen via de officiële Discord-Gateway.

Koppelen

Discord-DM’s gebruiken standaard de koppelmodus.

Slash-commando's

Native commandogedrag en commandocatalogus.

Kanaalproblemen oplossen

Cross-channel diagnostiek en reparatiestroom.

​
Snelle installatie

Je moet een nieuwe applicatie met een bot maken, de bot aan je server toevoegen en deze aan OpenClaw koppelen. We raden aan je bot aan je eigen privéserver toe te voegen. Als je die nog niet hebt, maak er dan eerst een (kies Create My Own > For me and my friends).
1

Maak een Discord-applicatie en bot

Ga naar de Discord Developer Portal en klik op New Application. Geef deze een naam zoals “OpenClaw”.Klik op Bot in de zijbalk. Stel de Username in op hoe je je OpenClaw-agent noemt.
2

Schakel privileged intents in

Blijf op de pagina Bot, scrol omlaag naar Privileged Gateway Intents en schakel in:
  • Message Content Intent (vereist)
  • Server Members Intent (aanbevolen; vereist voor rol-allowlists en naam-naar-ID-matching)
  • Presence Intent (optioneel; alleen nodig voor aanwezigheidsupdates)
3

Kopieer je bot-token

Scrol weer omhoog op de pagina Bot en klik op Reset Token.
Ondanks de naam genereert dit je eerste token — er wordt niets “gereset”.
Kopieer het token en bewaar het ergens. Dit is je Bot Token en je hebt het zo meteen nodig.
4

Genereer een uitnodigings-URL en voeg de bot toe aan je server

Klik op OAuth2 in de zijbalk. Je genereert een uitnodigings-URL met de juiste machtigingen om de bot aan je server toe te voegen.Scrol omlaag naar OAuth2 URL Generator en schakel in:
  • bot
  • applications.commands
Hieronder verschijnt een sectie Bot Permissions. Schakel minimaal in:General Permissions
  • View Channels
Text Permissions
  • Send Messages
  • Read Message History
  • Embed Links
  • Attach Files
  • Add Reactions (optioneel)
Dit is de basisset voor normale tekstkanalen. Als je van plan bent berichten in Discord-threads te plaatsen, inclusief workflows voor forum- of mediakanalen die een thread maken of voortzetten, schakel dan ook Send Messages in Threads in. Kopieer de gegenereerde URL onderaan, plak deze in je browser, selecteer je server en klik op Continue om te verbinden. Je zou je bot nu in de Discord-server moeten zien.
5

Schakel Developer Mode in en verzamel je ID's

Terug in de Discord-app moet je Developer Mode inschakelen zodat je interne ID’s kunt kopiëren.
  1. Klik op User Settings (tandwielpictogram naast je avatar) → scrol naar Developer in de zijbalk → zet Developer Mode aan (Opmerking: in de mobiele Discord-app staat Developer Mode onder App Settings → Advanced)
  2. Klik met de rechtermuisknop op je serverpictogram in de zijbalk → Copy Server ID
  3. Klik met de rechtermuisknop op je eigen avatar → Copy User ID
Bewaar je Server ID en User ID samen met je Bot Token — je stuurt ze alle drie in de volgende stap naar OpenClaw.
6

Sta DM's van serverleden toe

Om koppelen te laten werken, moet Discord toestaan dat je bot je een DM stuurt. Klik met de rechtermuisknop op je serverpictogram → Privacy Settings → zet Direct Messages aan.Hierdoor kunnen serverleden (inclusief bots) je DM’s sturen. Laat dit ingeschakeld als je Discord-DM’s met OpenClaw wilt gebruiken. Als je alleen guildkanalen wilt gebruiken, kun je DM’s na het koppelen uitschakelen.
7

Stel je bot-token veilig in (stuur het niet in chat)

Je Discord-bot-token is geheim (zoals een wachtwoord). Stel het in op de machine waarop OpenClaw draait voordat je je agent een bericht stuurt.
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" },
    },
  },
}
JSON5
openclaw config patch --file ./discord.patch.json5 --dry-run
openclaw config patch --file ./discord.patch.json5
openclaw gateway
Als OpenClaw al als achtergrondservice draait, herstart je deze via de OpenClaw Mac-app of door het proces openclaw gateway run te stoppen en opnieuw te starten. Voor installaties als beheerde service voer je openclaw gateway install uit vanuit een shell waarin DISCORD_BOT_TOKEN aanwezig is, of sla je de variabele op in ~/.openclaw/.env, zodat de service de env SecretRef na een herstart kan oplossen. Als je host wordt geblokkeerd of geratelimiteerd door Discord’s applicatie-opzoeking bij het opstarten, stel dan de Discord-applicatie-/client-ID in vanuit de Developer Portal zodat het opstarten die REST-call kan overslaan. Gebruik channels.discord.applicationId voor het standaardaccount, of channels.discord.accounts.<accountId>.applicationId wanneer je meerdere Discord-bots draait.
8

Configureer OpenClaw en koppel

Chat met je OpenClaw-agent op een bestaand kanaal (bijv. Telegram) en vertel het hem. Als Discord je eerste kanaal is, gebruik dan in plaats daarvan het tabblad CLI / config.
“Ik heb mijn Discord-bot-token al ingesteld in de config. Rond de Discord-installatie af met User ID <user_id> en Server ID <server_id>.”
9

Keur de eerste DM-koppeling goed

Wacht tot de Gateway draait en stuur je bot daarna een DM in Discord. Deze reageert met een koppelcode.
Stuur de koppelcode naar je agent op je bestaande kanaal:
“Keur deze Discord-koppelcode goed: <CODE>”
Koppelcodes verlopen na 1 uur.Je zou nu via DM met je agent in Discord moeten kunnen chatten.
Tokenresolutie houdt rekening met accounts. Config-tokenwaarden winnen van env-fallback. DISCORD_BOT_TOKEN wordt alleen gebruikt voor het standaardaccount. Als twee ingeschakelde Discord-accounts naar hetzelfde bot-token verwijzen, start OpenClaw slechts één Gateway-monitor voor dat token. Een token uit de config wint van de standaard env-fallback; anders wint het eerste ingeschakelde account en wordt het dubbele account als uitgeschakeld gerapporteerd. Voor geavanceerde uitgaande calls (berichttool/kanaalacties) wordt een expliciete per-call token voor die call gebruikt. Dit geldt voor verzend- en lees-/probe-achtige acties (bijvoorbeeld lezen/zoeken/ophalen/thread/pins/machtigingen). Accountbeleid en retry-instellingen komen nog steeds uit het geselecteerde account in de actieve runtimesnapshot.

​
Aanbevolen: stel een guild-werkruimte in

Zodra DM’s werken, kun je je Discord-server instellen als een volledige werkruimte waarin elk kanaal zijn eigen agentsessie met eigen context krijgt. Dit wordt aanbevolen voor privéservers waar alleen jij en je bot actief zijn.
1

Voeg je server toe aan de guild-allowlist

Hierdoor kan je agent reageren in elk kanaal op je server, niet alleen in DM’s.
“Voeg mijn Discord Server ID <server_id> toe aan de guild-allowlist”
2

Sta reacties zonder @mention toe

Standaard reageert je agent in guildkanalen alleen wanneer hij wordt @mentioned. Voor een privéserver wil je waarschijnlijk dat hij op elk bericht reageert.In guildkanalen worden normale antwoorden standaard automatisch geplaatst. Voor gedeelde altijd-actieve ruimtes kies je voor messages.groupChat.visibleReplies: "message_tool" zodat de agent kan meelezen en alleen post wanneer hij besluit dat een kanaalantwoord nuttig is. Dit werkt het beste met modellen van de nieuwste generatie die betrouwbaar met tools omgaan, zoals GPT 5.5. Omgevingsgebeurtenissen in ruimtes blijven stil tenzij de tool verzendt. Zie Omgevingsgebeurtenissen in ruimtes voor de volledige lurk-mode-configuratie.Als Discord typen toont en de logs tokengebruik tonen maar er geen bericht is geplaatst, controleer dan of de turn was geconfigureerd als een omgevingsgebeurtenis in een ruimte of was ingesteld op zichtbare antwoorden via de berichttool.
“Sta mijn agent toe op deze server te reageren zonder dat hij @mentioned hoeft te worden”
3

Plan voor geheugen in guildkanalen

Standaard wordt langetermijngeheugen (MEMORY.md) alleen geladen in DM-sessies. Guildkanalen laden MEMORY.md niet automatisch.
“Wanneer ik vragen stel in Discord-kanalen, gebruik memory_search of memory_get als je langetermijncontext uit MEMORY.md nodig hebt.”
Maak nu enkele kanalen op je Discord-server en begin met chatten. Je agent kan de kanaalnaam zien en elk kanaal krijgt zijn eigen geïsoleerde sessie — zodat je #coding, #home, #research of iets anders dat bij je workflow past kunt instellen.

​
Runtimemodel

  • Gateway beheert de Discord-verbinding.
  • Antwoordroutering is deterministisch: inkomende Discord-antwoorden gaan terug naar Discord.
  • Discord-gilde-/kanaalmetadata wordt toegevoegd aan de modelprompt als niet-vertrouwde context, niet als een voor gebruikers zichtbaar antwoordvoorvoegsel. Als een model die envelop terugkopieert, verwijdert OpenClaw de gekopieerde metadata uit uitgaande antwoorden en uit toekomstige replay-context.
  • Standaard (session.dmScope=main) delen directe chats de hoofdsessie van de agent (agent:main:main).
  • Gildekanalen zijn geïsoleerde sessiesleutels (agent:<agentId>:discord:channel:<channelId>).
  • Groeps-DM’s worden standaard genegeerd (channels.discord.dm.groupEnabled=false).
  • Native slash commands draaien in geïsoleerde opdrachtsessies (agent:<agentId>:discord:slash:<userId>), terwijl ze nog steeds CommandTargetSessionKey meenemen naar de gerouteerde conversatiesessie.
  • Tekst-only cron-/heartbeat-aankondigingslevering aan Discord gebruikt het uiteindelijke voor de assistant zichtbare antwoord één keer. Media en gestructureerde componentpayloads blijven meerdere berichten wanneer de agent meerdere leverbare payloads uitstuurt.

​
Forumkanalen

Discord-forum- en mediakanalen accepteren alleen threadberichten. OpenClaw ondersteunt twee manieren om ze te maken:
  • Stuur een bericht naar de forumparent (channel:<forumId>) om automatisch een thread te maken. De threadtitel gebruikt de eerste niet-lege regel van je bericht.
  • Gebruik openclaw message thread create om direct een thread te maken. Geef geen --message-id door voor forumkanalen.
Voorbeeld: stuur naar de forumparent om een thread te maken 
openclaw message send --channel discord --target channel:<forumId> \
  --message "Topic title\nBody of the post"
Voorbeeld: maak expliciet een forumthread 
openclaw message thread create --channel discord --target channel:<forumId> \
  --thread-name "Topic title" --message "Body of the post"
Forumparents accepteren geen Discord-componenten. Als je componenten nodig hebt, stuur dan naar de thread zelf (channel:<threadId>).

​
Interactieve componenten

OpenClaw ondersteunt Discord components v2-containers voor agentberichten. Gebruik de berichttool met een components-payload. Interactieresultaten worden teruggerouteerd naar de agent als normale inkomende berichten 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
Standaard zijn componenten eenmalig te gebruiken. Stel components.reusable=true in om knoppen, selecties en formulieren meerdere keren te kunnen gebruiken totdat ze verlopen. Om te beperken wie op een knop kan klikken, stel je allowedUsers in op die knop (Discord-gebruikers-ID’s, tags of *). Wanneer dit is geconfigureerd, ontvangen niet-overeenkomende gebruikers een ephemeral weigering. Componentcallbacks verlopen standaard na 30 minuten. Stel channels.discord.agentComponents.ttlMs in om die callbackregisterlevensduur te wijzigen voor het standaard Discord-account, of channels.discord.accounts.<accountId>.agentComponents.ttlMs om één account in een multi-accountconfiguratie te overschrijven. De waarde is in milliseconden, moet een positief geheel getal zijn en is begrensd op 86400000 (24 uur). Langere TTL’s zijn nuttig voor review- of goedkeuringsworkflows waarbij knoppen bruikbaar moeten blijven, maar ze verlengen ook het venster waarin een oud Discord-bericht nog steeds een actie kan triggeren. Gebruik bij voorkeur de kortste TTL die bij de workflow past, en behoud de standaardwaarde wanneer verouderde callbacks verrassend zouden zijn. De slash commands /model en /models openen een interactieve modelkiezer met dropdowns voor provider, model en compatibele runtime plus een stap Indienen. /models add is verouderd en retourneert nu een verouderingsbericht in plaats van modellen vanuit chat te registreren. Het kiezerantwoord is ephemeral en alleen de aanroepende gebruiker kan het gebruiken. Discord-selectiemenu’s zijn beperkt tot 25 opties, dus voeg provider/*-items toe aan agents.defaults.models wanneer je 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>)
  • Geef de bijlage op via media/path/filePath (één bestand); gebruik media-gallery voor meerdere bestanden
  • Gebruik filename om de uploadnaam te overschrijven wanneer die moet overeenkomen met de bijlagereferentie
Modal-formulieren:
  • Voeg components.modal toe met maximaal 5 velden
  • Veldtypen: text, checkbox, radio, select, role-select, user-select
  • OpenClaw voegt automatisch een triggerknop 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" },
          ],
        },
      ],
    },
  },
}

​
Toegangscontrole en routering

channels.discord.dmPolicy beheert DM-toegang. channels.discord.allowFrom is de canonieke DM-allowlist.
  • pairing (standaard)
  • allowlist
  • open (vereist dat channels.discord.allowFrom "*" bevat)
  • disabled
Als DM-beleid niet open is, worden onbekende gebruikers geblokkeerd (of gevraagd om te pairen in de modus pairing).Precedentie bij meerdere accounts:
  • channels.discord.accounts.default.allowFrom is alleen van toepassing op het account default.
  • Voor één account heeft allowFrom voorrang op legacy dm.allowFrom.
  • Benoemde accounts erven channels.discord.allowFrom wanneer hun eigen allowFrom en legacy dm.allowFrom niet zijn ingesteld.
  • Benoemde accounts erven channels.discord.accounts.default.allowFrom niet.
Legacy channels.discord.dm.policy en channels.discord.dm.allowFrom worden nog steeds gelezen voor compatibiliteit. openclaw doctor --fix migreert ze naar dmPolicy en allowFrom wanneer dat kan zonder de toegang te wijzigen.DM-doelindeling voor levering:
  • user:<id>
  • <@id>-vermelding
Kale numerieke ID’s worden normaal als kanaal-ID’s opgelost wanneer een kanaalstandaard actief is, maar ID’s die in de effectieve DM-allowFrom van het account staan, worden voor compatibiliteit behandeld als gebruiker-DM-doelen.

​
Rolgebaseerde agentroutering

Gebruik bindings[].match.roles om Discord-gildeleden op basis van rol-ID naar verschillende agents te routeren. Rolgebaseerde bindings accepteren alleen rol-ID’s en worden geëvalueerd na peer- of parent-peer-bindings en vóór guild-only-bindings. Als een binding ook andere matchvelden 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",
      },
    },
  ],
}

​
Native opdrachten en opdracht-authenticatie

  • commands.native staat standaard op "auto" en is ingeschakeld voor Discord.
  • Override per kanaal: channels.discord.commands.native.
  • commands.native=false slaat registratie en opschoning van Discord-slash-opdrachten tijdens het opstarten over. Eerder geregistreerde opdrachten kunnen zichtbaar blijven in Discord totdat je ze uit de Discord-app verwijdert.
  • Authenticatie voor native opdrachten gebruikt dezelfde Discord-allowlists en beleidsregels als normale berichtverwerking.
  • Opdrachten kunnen nog steeds zichtbaar zijn in de Discord-UI voor gebruikers die niet gemachtigd zijn; uitvoering dwingt nog steeds OpenClaw-authenticatie af en retourneert “not authorized”.
Zie Slash-opdrachten voor de opdrachtcatalogus en het gedrag. Standaardinstellingen voor slash-opdrachten:
  • ephemeral: true

​
Functiedetails

Discord ondersteunt antwoordtags in agentuitvoer:
  • [[reply_to_current]]
  • [[reply_to:<id>]]
Beheerd door channels.discord.replyToMode:
  • off (standaard)
  • first
  • all
  • batched
Opmerking: off schakelt impliciete antwoordthreading uit. Expliciete [[reply_to_*]]-tags worden nog steeds gerespecteerd. first koppelt de impliciete native antwoordverwijzing altijd aan het eerste uitgaande Discord-bericht voor de beurt. batched koppelt Discord’s impliciete native antwoordverwijzing alleen wanneer de inkomende gebeurtenis een gedebouncete batch van meerdere berichten was. Dit is handig wanneer je native antwoorden vooral wilt gebruiken voor dubbelzinnige, bursty chats, niet voor elke beurt met één bericht.Bericht-ID’s worden in context/geschiedenis beschikbaar gemaakt, zodat agents specifieke berichten kunnen targeten.
Discord genereert standaard rijke link-embeds voor URL’s. OpenClaw onderdrukt die gegenereerde embeds standaard op uitgaande Discord-berichten, zodat door agents verzonden URL’s gewone links blijven, tenzij je dit expliciet inschakelt:
{
  channels: {
    discord: {
      suppressEmbeds: false,
    },
  },
}
Stel channels.discord.accounts.<id>.suppressEmbeds in om één account te overriden. Verzendingen via de berichttool van agents kunnen ook suppressEmbeds: false doorgeven voor één bericht. Expliciete Discord-embeds-payloads worden niet onderdrukt door de standaardinstelling voor linkvoorbeelden.
OpenClaw kan conceptantwoorden streamen door een tijdelijk bericht te verzenden en dit te bewerken terwijl tekst binnenkomt. channels.discord.streaming accepteert off | partial | block | progress (standaard). progress houdt één bewerkbaar statusconcept bij en werkt dit bij met toolvoortgang tot de definitieve levering; het gedeelde startlabel is een rollende regel, dus het scrollt weg zoals de rest zodra er genoeg werk verschijnt. streamMode is een legacy runtime-alias. Voer openclaw doctor --fix uit om opgeslagen configuratie naar de canonieke sleutel te herschrijven.Stel channels.discord.streaming.mode in op off om Discord-voorbeeldbewerkingen uit te schakelen. Als Discord-blokstreaming expliciet is ingeschakeld, slaat OpenClaw de voorbeeldstream over om dubbel streamen te voorkomen.
{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "auto",
          maxLines: 8,
          maxLineChars: 120,
          toolProgress: true,
          commentary: false,
        },
      },
    },
  },
}
  • partial bewerkt één voorbeeldbericht terwijl tokens binnenkomen.
  • block zendt conceptgrote chunks uit (gebruik draftChunk om grootte en breekpunten af te stemmen, begrensd op textChunkLimit).
  • Media, fouten en expliciete antwoordfinals annuleren wachtende voorbeeldbewerkingen.
  • streaming.preview.toolProgress (standaard true) bepaalt of tool-/voortgangsupdates het voorbeeldbericht hergebruiken.
  • Tool-/voortgangsrijen worden weergegeven als compacte emoji + titel + detail wanneer beschikbaar, bijvoorbeeld 🛠️ Bash: run tests of 🔎 Web Search: for "query".
  • streaming.progress.commentary (standaard false) schakelt assistentcommentaar/introductietekst in het tijdelijke voortgangsconcept in. Commentaar wordt vóór weergave opgeschoond, blijft tijdelijk en verandert de levering van het definitieve antwoord niet.
  • streaming.progress.maxLineChars bepaalt het budget per regel voor de voortgangsweergave. Proza wordt op woordgrenzen ingekort; opdracht- en paddetails behouden nuttige suffixen.
  • streaming.preview.commandText / streaming.progress.commandText bepaalt opdracht-/exec-details in compacte voortgangsregels: raw (standaard) of status (alleen toollabel).
Verberg ruwe opdracht-/exec-tekst terwijl compacte voortgangsregels behouden blijven:
{
  "channels": {
    "discord": {
      "streaming": {
        "mode": "progress",
        "progress": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}
Voorbeeldstreaming is alleen tekst; media-antwoorden vallen terug op normale levering. Wanneer block-streaming expliciet is ingeschakeld, slaat OpenClaw de voorbeeldstream over om dubbel streamen te voorkomen.
Gildegeschiedeniscontext:
  • channels.discord.historyLimit standaard 20
  • fallback: messages.groupChat.historyLimit
  • 0 schakelt uit
DM-geschiedenisinstellingen:
  • channels.discord.dmHistoryLimit
  • channels.discord.dms["<user_id>"].historyLimit
Threadgedrag:
  • Discord-threads routeren als kanaalsessies en erven de configuratie van het bovenliggende kanaal, tenzij overridden.
  • Threadsessies erven de sessieniveau-/model-selectie van het bovenliggende kanaal als model-only fallback; threadlokale /model-selecties hebben nog steeds voorrang en bovenliggende transcriptgeschiedenis wordt niet gekopieerd tenzij transcriptovererving is ingeschakeld.
  • channels.discord.thread.inheritParent (standaard false) laat nieuwe auto-threads starten met seeddata uit het bovenliggende transcript. Overrides per account staan onder channels.discord.accounts.<id>.thread.inheritParent.
  • Berichttoolreacties kunnen user:<id>-DM-targets oplossen.
  • guilds.<guild>.channels.<channel>.requireMention: false blijft behouden tijdens reply-stage activation fallback.
Kanaalonderwerpen worden geïnjecteerd als niet-vertrouwde context. Allowlists bepalen wie de agent kan triggeren, niet een volledige redactiegrens voor aanvullende context.
Discord kan een thread binden aan een sessietarget, zodat vervolgberichten in die thread naar dezelfde sessie blijven routeren (inclusief subagentsessies).Opdrachten:
  • /focus <target> bind huidige/nieuwe thread aan een subagent-/sessietarget
  • /unfocus verwijder de huidige threadbinding
  • /agents toon actieve runs en bindingsstatus
  • /session idle <duration|off> inspecteer/update automatische inactiviteits-unfocus voor gefocuste bindings
  • /session max-age <duration|off> inspecteer/update harde maximale leeftijd voor gefocuste bindings
Configuratie:
{
  session: {
    threadBindings: {
      enabled: true,
      idleHours: 24,
      maxAgeHours: 0,
    },
  },
  channels: {
    discord: {
      threadBindings: {
        enabled: true,
        idleHours: 24,
        maxAgeHours: 0,
        spawnSessions: true,
        defaultSpawnContext: "fork",
      },
    },
  },
}
Opmerkingen:
  • session.threadBindings.* stelt globale standaarden in.
  • channels.discord.threadBindings.* overridet Discord-gedrag.
  • spawnSessions beheert automatisch aanmaken/binden van threads voor sessions_spawn({ thread: true }) en ACP-threadspawns. Standaard: true.
  • defaultSpawnContext beheert native subagentcontext voor threadgebonden spawns. Standaard: "fork".
  • Verouderde sleutels spawnSubagentSessions/spawnAcpSessions worden gemigreerd door openclaw doctor --fix.
  • Als threadbindings voor een account zijn uitgeschakeld, zijn /focus en gerelateerde threadbindingsbewerkingen niet beschikbaar.
Zie Subagents, ACP-agents en Configuratiereferentie.
Configureer top-level getypeerde ACP-bindings die op Discord-gesprekken targeten voor stabiele “always-on” ACP-werkruimten.Configuratiepad:
  • bindings[] met type: "acp" en match.channel: "discord"
Voorbeeld:
{
  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,
            },
          },
        },
      },
    },
  },
}
Opmerkingen:
  • /acp spawn codex --bind here bindt het huidige kanaal of de huidige thread op zijn plek en houdt toekomstige berichten op dezelfde ACP-sessie. Threadberichten erven de binding van het bovenliggende kanaal.
  • In een gebonden kanaal of thread resetten /new en /reset dezelfde ACP-sessie op zijn plek. Tijdelijke threadbindings kunnen targetresolutie overriden terwijl ze actief zijn.
  • spawnSessions beheert het maken/binden van child-threads via --thread auto|here.
Zie ACP-agents voor details over bindingsgedrag.
Reactiemeldingsmodus per gilde:
  • off
  • own (standaard)
  • all
  • allowlist (gebruikt guilds.<id>.users)
Reactiegebeurtenissen worden omgezet in systeemgebeurtenissen en gekoppeld aan de gerouteerde Discord-sessie.
ackReaction verzendt een bevestigingsemoji terwijl OpenClaw een inkomend bericht verwerkt.Resolutievolgorde:
  • channels.discord.accounts.<accountId>.ackReaction
  • channels.discord.ackReaction
  • messages.ackReaction
  • fallback naar agentidentiteitsemoji (agents.list[].identity.emoji, anders ”👀”)
Opmerkingen:
  • Discord accepteert unicode-emoji of aangepaste emojinamen.
  • Gebruik "" om de reactie voor een kanaal of account uit te schakelen.
Door kanalen geïnitieerde configuratieschrijfacties zijn standaard ingeschakeld.Dit beïnvloedt /config set|unset-flows (wanneer opdrachtfuncties zijn ingeschakeld).Uitschakelen:
{
  channels: {
    discord: {
      configWrites: false,
    },
  },
}
Routeer Discord Gateway WebSocket-verkeer en REST-lookups bij opstarten (applicatie-ID + allowlistresolutie) via een HTTP(S)-proxy met channels.discord.proxy. Discord Gateway WebSocket-proxying is expliciet; WebSocket-verbindingen erven geen omgevingsproxyvariabelen uit het Gateway-proces. REST-lookups bij opstarten gebruiken deze proxy wanneer channels.discord.proxy is geconfigureerd.
{
  channels: {
    discord: {
      proxy: "http://proxy.example:8080",
    },
  },
}
Override per account:
{
  channels: {
    discord: {
      accounts: {
        primary: {
          proxy: "http://proxy.example:8080",
        },
      },
    },
  },
}
Schakel PluralKit-resolutie in om proxied berichten te koppelen aan de identiteit van systeemleden:
{
  channels: {
    discord: {
      pluralkit: {
        enabled: true,
        token: "pk_live_...", // optional; needed for private systems
      },
    },
  },
}
Opmerkingen:
  • allowlists kunnen pk:<memberId> gebruiken
  • weergavenamen van leden worden alleen op naam/slug gematcht wanneer channels.discord.dangerouslyAllowNameMatching: true
  • zoekacties gebruiken de oorspronkelijke bericht-ID en zijn beperkt tot een tijdvenster
  • als de zoekactie mislukt, worden proxied berichten behandeld als botberichten en verwijderd, tenzij allowBots=true
Gebruik mentionAliases wanneer agents deterministische uitgaande vermeldingen nodig hebben voor bekende Discord-gebruikers. Sleutels zijn handles zonder de voorafgaande @; waarden zijn Discord-gebruikers-ID’s. Onbekende handles, @everyone, @here en vermeldingen binnen Markdown-codespans blijven ongewijzigd.
{
  channels: {
    discord: {
      mentionAliases: {
        Vladislava: "123456789012345678",
      },
      accounts: {
        ops: {
          mentionAliases: {
            OpsLead: "234567890123456789",
          },
        },
      },
    },
  },
}
Aanwezigheidsupdates worden toegepast wanneer je een status- of activiteitsveld instelt, of wanneer je automatische aanwezigheid inschakelt.Voorbeeld met alleen status:
{
  channels: {
    discord: {
      status: "idle",
    },
  },
}
Activiteitsvoorbeeld (aangepaste status is het standaardactiviteitstype):
{
  channels: {
    discord: {
      activity: "Focus time",
      activityType: 4,
    },
  },
}
Streamingvoorbeeld:
{
  channels: {
    discord: {
      activity: "Live coding",
      activityType: 1,
      activityUrl: "https://twitch.tv/openclaw",
    },
  },
}
Activiteitstypemap:
  • 0: Spelen
  • 1: Streamen (vereist activityUrl)
  • 2: Luisteren
  • 3: Kijken
  • 4: Aangepast (gebruikt de activiteitstekst als statustoestand; emoji is optioneel)
  • 5: Deelnemen
Voorbeeld van automatische aanwezigheid (runtime-gezondheidssignaal):
{
  channels: {
    discord: {
      autoPresence: {
        enabled: true,
        intervalMs: 30000,
        minUpdateIntervalMs: 15000,
        exhaustedText: "token exhausted",
      },
    },
  },
}
Automatische aanwezigheid koppelt runtime-beschikbaarheid aan Discord-status: gezond => online, verminderd of onbekend => inactief, uitgeput of niet beschikbaar => niet storen. Optionele tekstoverschrijvingen:
  • autoPresence.healthyText
  • autoPresence.degradedText
  • autoPresence.exhaustedText (ondersteunt {reason}-placeholder)
Discord ondersteunt knopgebaseerde afhandeling van goedkeuringen in DM’s en kan optioneel goedkeuringsprompts plaatsen in het oorspronkelijke kanaal.Configuratiepad:
  • channels.discord.execApprovals.enabled
  • channels.discord.execApprovals.approvers (optioneel; valt waar mogelijk terug op commands.ownerAllowFrom)
  • channels.discord.execApprovals.target (dm | channel | both, standaard: dm)
  • agentFilter, sessionFilter, cleanupAfterResolve
Discord schakelt native exec-goedkeuringen automatisch in wanneer enabled niet is ingesteld of "auto" is en ten minste één goedkeurder kan worden opgelost, hetzij vanuit execApprovals.approvers, hetzij vanuit commands.ownerAllowFrom. Discord leidt exec-goedkeurders niet af uit kanaal-allowFrom, legacy dm.allowFrom of direct-message defaultTo. Stel enabled: false in om Discord expliciet uit te schakelen als native goedkeuringsclient.Voor gevoelige groepscommando’s die alleen voor eigenaren zijn, zoals /diagnostics en /export-trajectory, stuurt OpenClaw goedkeuringsprompts en eindresultaten privé. Het probeert eerst een Discord-DM wanneer de aanroepende eigenaar een Discord-eigenaarroute heeft; als die niet beschikbaar is, valt het terug op de eerste beschikbare eigenaarroute uit commands.ownerAllowFrom, zoals Telegram.Wanneer target channel of both is, is de goedkeuringsprompt zichtbaar in het kanaal. Alleen opgeloste goedkeurders kunnen de knoppen gebruiken; andere gebruikers ontvangen een vluchtige weigering. Goedkeuringsprompts bevatten de commandotekst, dus schakel kanaallevering alleen in vertrouwde kanalen in. Als de kanaal-ID niet uit de sessiesleutel kan worden afgeleid, valt OpenClaw terug op levering via DM.Discord rendert ook de gedeelde goedkeuringsknoppen die door andere chatkanalen worden gebruikt. De native Discord-adapter voegt vooral DM-routering voor goedkeurders en kanaalfanout toe. Wanneer die knoppen aanwezig zijn, vormen ze de primaire goedkeurings-UX; OpenClaw mag alleen een handmatig /approve-commando opnemen wanneer het toolresultaat zegt dat chatgoedkeuringen niet beschikbaar zijn of dat handmatige goedkeuring het enige pad is. Als de native Discord-goedkeuringsruntime niet actief is, houdt OpenClaw de lokale deterministische prompt /approve <id> <decision> zichtbaar. Als de runtime actief is maar een native kaart niet aan een doel kan worden geleverd, stuurt OpenClaw een fallback-melding in dezelfde chat met het exacte /approve- commando uit de wachtende goedkeuring.Gateway-authenticatie en goedkeuringsresolutie volgen het gedeelde Gateway-clientcontract (plugin:-ID’s worden opgelost via plugin.approval.resolve; andere ID’s via exec.approval.resolve). Goedkeuringen verlopen standaard na 30 minuten.Zie Exec-goedkeuringen.

​
Tools en actiegates

Discord-berichtacties omvatten berichten, kanaalbeheer, moderatie, aanwezigheid en metadata-acties. 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. Actiegates staan onder channels.discord.actions.*. Standaard gate-gedrag:
ActiegroepStandaard
reactions, messages, threads, pins, polls, search, memberInfo, roleInfo, channelInfo, channels, voiceStatus, events, stickers, emojiUploads, stickerUploads, permissionsingeschakeld
rolesuitgeschakeld
moderationuitgeschakeld
presenceuitgeschakeld

​
Components v2-UI

OpenClaw gebruikt Discord-components v2 voor exec-goedkeuringen en cross-contextmarkeringen. Discord-berichtacties kunnen ook components accepteren voor aangepaste UI (geavanceerd; vereist het construeren van een componentpayload via de discord-tool), terwijl legacy embeds beschikbaar blijven maar niet worden aanbevolen.
  • channels.discord.ui.components.accentColor stelt de accentkleur in die door Discord-componentcontainers wordt gebruikt (hex).
  • Stel dit per account in met channels.discord.accounts.<id>.ui.components.accentColor.
  • channels.discord.agentComponents.ttlMs bepaalt hoe lang verzonden Discord-componentcallbacks geregistreerd blijven (standaard 1800000, maximum 86400000). Stel dit per account in met channels.discord.accounts.<id>.agentComponents.ttlMs.
  • embeds worden genegeerd wanneer components v2 aanwezig zijn.
  • Voorvertoningen van gewone URL’s worden standaard onderdrukt. Stel suppressEmbeds: false in op een berichtactie wanneer één uitgaande link moet uitklappen.
Voorbeeld: 
{
  channels: {
    discord: {
      ui: {
        components: {
          accentColor: "#5865F2",
        },
      },
    },
  },
}

​
Spraak

Discord heeft twee afzonderlijke spraakoppervlakken: realtime spraakkanalen (doorlopende gesprekken) en spraakberichtbijlagen (het waveform-previewformaat). De gateway ondersteunt beide.

​
Spraakkanalen

Setupchecklist:
  1. Schakel Message Content Intent in het Discord Developer Portal in.
  2. Schakel Server Members Intent in wanneer rol-/gebruikersallowlists worden gebruikt.
  3. Nodig de bot uit met de scopes bot en applications.commands.
  4. Verleen Connect, Speak, Send Messages en Read Message History in het doelspraakkanaal.
  5. Schakel native commando’s in (commands.native of channels.discord.commands.native).
  6. Configureer channels.discord.voice.
Gebruik /vc join|leave|status om sessies te beheren. Het commando gebruikt de standaardagent van het account en volgt dezelfde allowlist- en groepsbeleidsregels als andere Discord-commando’s. 
/vc join channel:<voice-channel-id>
/vc status
/vc leave
Voer het volgende uit om de effectieve machtigingen van de bot te inspecteren voordat je deelneemt: 
openclaw channels capabilities --channel discord --target channel:<voice-channel-id>
Voorbeeld van automatisch deelnemen: 
{
  channels: {
    discord: {
      voice: {
        enabled: true,
        model: "openai/gpt-5.5",
        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",
          speakerVoice: "cedar",
        },
      },
    },
  },
}
Opmerkingen:
  • voice.tts overschrijft messages.tts alleen voor stt-tts-spraakweergave. Realtime-modi gebruiken voice.realtime.speakerVoice.
  • voice.mode bepaalt het gesprekspad. De standaardwaarde is agent-proxy: een realtime spraakfrontend handelt beurtiming, onderbreking en weergave af, delegeert inhoudelijk werk aan de geroute OpenClaw-agent via openclaw_agent_consult, en behandelt het resultaat als een getypte Discord-prompt van die spreker. stt-tts behoudt de oudere batch-STT plus TTS-flow. Met bidi kan het realtime model rechtstreeks converseren terwijl openclaw_agent_consult voor het OpenClaw-brein beschikbaar blijft.
  • 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 consults. Laat dit oningesteld om het geroute agentmodel te erven. Het staat los van voice.realtime.model.
  • Met voice.followUsers kan de bot Discord-spraak joinen, verplaatsen en verlaten met geselecteerde gebruikers. Zie Gebruikers volgen in spraak voor gedragsregels en voorbeelden.
  • agent-proxy route spraak via discord-voice, waardoor normale owner-/toolautorisatie voor de spreker en doelsessie behouden blijft, maar de agenttool tts wordt verborgen omdat Discord-spraak de weergave bezit. Standaard geeft agent-proxy het consult volledige owner-equivalente tooltoegang voor owner-sprekers (voice.realtime.toolPolicy: "owner") en geeft het sterk de voorkeur aan het raadplegen van de OpenClaw-agent vóór inhoudelijke antwoorden (voice.realtime.consultPolicy: "always"). In die standaardmodus always spreekt de realtime laag niet automatisch opvulling uit vóór het consultantwoord; hij legt spraak vast en transcribeert die, en spreekt daarna het geroute OpenClaw-antwoord uit. Als meerdere afgedwongen consultantwoorden klaar zijn terwijl Discord het eerste antwoord nog afspeelt, worden latere exact-spraakantwoorden in de wachtrij gezet totdat de weergave idle 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 realtime-modi configureren voice.realtime.provider, voice.realtime.model en voice.realtime.speakerVoice de realtime audiosessie. Gebruik voor OpenAI Realtime 2 plus het Codex-brein voice.realtime.model: "gpt-realtime-2" en voice.model: "openai/gpt-5.5".
  • Realtime spraakmodi nemen standaard kleine profielbestanden IDENTITY.md, USER.md en SOUL.md op in de instructies voor de realtime provider, zodat snelle directe beurten dezelfde identiteit, gebruikersgronding en persona behouden als de geroute OpenClaw-agent. Stel voice.realtime.bootstrapContextFiles in op een subset om dit aan te passen, of op [] om het uit te schakelen. De ondersteunde realtime bootstrap-bestanden zijn beperkt tot die profielbestanden; AGENTS.md blijft in de normale agentcontext. De geïnjecteerde profielcontext vervangt openclaw_agent_consult niet voor werkruimtetaken, actuele feiten, geheugenopzoeking of tool-ondersteunde acties.
  • Stel in de OpenAI realtime modus agent-proxy voice.realtime.requireWakeName: true in om Discord-realtime spraak 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 geroute agent-name plus OpenClaw, met een fallback naar de agent-id plus OpenClaw. Weknaam-gating schakelt automatische antwoorden van de realtime provider uit, route geaccepteerde beurten via het OpenClaw-agentconsultpad, en geeft een korte gesproken bevestiging wanneer een leidende weknaam wordt herkend uit gedeeltelijke transcriptie voordat het definitieve transcript arriveert.
  • De OpenAI realtime provider accepteert huidige Realtime 2-eventnamen en legacy Codex-compatibele aliassen voor outputaudio- en transcriptevents, zodat compatibele providersnapshots kunnen afwijken zonder assistentaudio te laten vallen.
  • voice.realtime.bargeIn bepaalt of Discord speaker-start-events actieve realtime weergave onderbreken. Als dit oningesteld is, volgt het de inputaudio-onderbrekingsinstelling van de realtime provider.
  • voice.realtime.minBargeInAudioEndMs bepaalt de minimale afspeelduur van de assistant voordat een OpenAI realtime barge-in audio afkapt. Standaard: 250. Stel 0 in voor onmiddellijke onderbreking in ruimtes met weinig echo, of verhoog dit voor luidsprekeropstellingen met veel echo.
  • Stel voor een OpenAI-stem bij Discord-weergave voice.tts.provider: "openai" in en kies een Text-to-speech-stem onder voice.tts.providers.openai.speakerVoice. cedar is een goede mannelijk klinkende keuze op het huidige OpenAI TTS-model.
  • Per-kanaal Discord-overschrijvingen van systemPrompt gelden voor spraaktranscriptbeurten voor dat spraakkanaal.
  • Spraaktranscriptbeurten leiden de owner-status af van Discord allowFrom (of dm.allowFrom) voor owner-gated opdrachten en kanaalacties. Zichtbaarheid van agenttools volgt het geconfigureerde toolbeleid voor de geroute sessie.
  • Discord-spraak is opt-in voor tekst-only configuraties; stel channels.discord.voice.enabled=true in (of behoud een bestaand channels.discord.voice-blok) om /vc-opdrachten, de spraakruntime en de Gateway-intent GuildVoiceStates in te schakelen.
  • channels.discord.intents.voiceStates kan het abonnement op de voice-state-intent expliciet overschrijven. Laat dit oningesteld zodat de intent de effectieve spraakinschakeling volgt.
  • Als voice.autoJoin meerdere vermeldingen voor dezelfde guild heeft, joint OpenClaw het laatst geconfigureerde kanaal voor die guild.
  • voice.allowedChannels is een optionele allowlist voor verblijf. Laat dit oningesteld om /vc join toe te staan naar elk geautoriseerd Discord-spraakkanaal. Wanneer dit is ingesteld, zijn /vc join, startup auto-join en bot voice-state-verplaatsingen beperkt tot de vermelde { guildId, channelId }-vermeldingen. Stel dit in op een lege array om alle Discord-spraakjoins te weigeren. Als Discord de bot buiten de allowlist verplaatst, verlaat OpenClaw dat kanaal en joint opnieuw het geconfigureerde auto-join-doel wanneer er een beschikbaar is.
  • voice.daveEncryption en voice.decryptionFailureTolerance worden doorgegeven aan de join-opties van @discordjs/voice.
  • De standaardwaarden van @discordjs/voice zijn daveEncryption=true en decryptionFailureTolerance=24 als ze oningesteld zijn.
  • OpenClaw gebruikt de gebundelde libopus-wasm-codec voor Discord-spraakontvangst en realtime raw PCM-weergave. Deze levert een vastgepinde libopus WebAssembly-build mee en vereist geen native opus-add-ons.
  • voice.connectTimeoutMs bepaalt de initiële @discordjs/voice Ready-wachttijd voor /vc join en auto-join-pogingen. Standaard: 30000.
  • voice.reconnectGraceMs bepaalt hoelang OpenClaw wacht tot een verbroken spraaksessie begint met opnieuw verbinden voordat die wordt vernietigd. Standaard: 15000.
  • In de modus stt-tts stopt spraakweergave niet alleen omdat een andere gebruiker begint te spreken. Om feedbacklussen te voorkomen, negeert OpenClaw nieuwe spraakopname terwijl TTS speelt; spreek nadat de weergave is afgelopen voor de volgende beurt. Realtime-modi sturen speaker-starts door als barge-in-signalen naar de realtime provider.
  • In realtime-modi kan echo van luidsprekers in een open microfoon lijken op barge-in en de weergave onderbreken. Stel voor Discord-ruimtes met veel echo voice.realtime.providers.openai.interruptResponseOnInputAudio: false in om te voorkomen dat OpenAI automatisch onderbreekt bij inputaudio. Voeg voice.realtime.bargeIn: true toe als je nog steeds wilt dat Discord speaker-start-events actieve weergave onderbreken. De OpenAI realtime bridge negeert afspeelafkappingen korter dan voice.realtime.minBargeInAudioEndMs als waarschijnlijke echo/ruis en logt ze als overgeslagen in plaats van Discord-weergave 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 Discord-spraakweergave streaming-TTS en start die vanuit de providerresponsstream. Providers zonder streamingondersteuning vallen terug op het gesynthetiseerde tijdelijke-bestandspad.
  • OpenClaw bewaakt ook ontvangstdecryptiefouten en herstelt automatisch door het spraakkanaal te verlaten en opnieuw te joinen na herhaalde fouten binnen een korte periode.
  • Als ontvangstlogs na een update herhaaldelijk DecryptionFailed(UnencryptedWhenPassthroughDisabled) tonen, verzamel dan een dependencyrapport en logs. De gebundelde @discordjs/voice-lijn bevat de upstream padding-fix uit discord.js PR #11449, die discord.js-issue #11419 heeft gesloten.
  • The operation was aborted-ontvangstevents zijn verwacht wanneer OpenClaw een vastgelegd sprekersegment afrondt; het zijn uitgebreide diagnostische meldingen, geen waarschuwingen.
  • Uitgebreide Discord-spraaklogs bevatten een begrensde transcriptpreview van één regel voor elk geaccepteerd sprekersegment, zodat debugging zowel de gebruikerskant als de agentantwoordkant toont zonder onbeperkte transcripttekst te dumpen.
  • In de modus agent-proxy slaat afgedwongen consultfallback waarschijnlijk onvolledige transcriptfragmenten over, zoals tekst die eindigt op ... of een afsluitende verbinding zoals and, plus duidelijk niet-actiegerichte afsluitingen zoals “ben zo terug” of “doei”. Logs 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 een vast kanaal te joinen of op /vc join te wachten. 
{
  channels: {
    discord: {
      voice: {
        enabled: true,
        followUsersEnabled: true,
        followUsers: ["discord:123456789012345678"],
        allowedChannels: [
          {
            guildId: "123456789012345678",
            channelId: "234567890123456789",
          },
        ],
      },
    },
  },
}
Gedrag:
  • followUsers accepteert raw Discord-gebruikers-ID’s en waarden van discord:<id>. OpenClaw normaliseert beide vormen voordat voice-state-events worden gematcht.
  • followUsersEnabled is standaard true wanneer followUsers is geconfigureerd. Stel dit in op false om de opgeslagen lijst te behouden maar automatisch spraakvolgen te stoppen.
  • Wanneer een gevolgde gebruiker een toegestaan spraakkanaal joint, joint OpenClaw dat kanaal. Wanneer de gebruiker verplaatst, verplaatst OpenClaw mee. Wanneer de actieve gevolgde gebruiker de verbinding verbreekt, verlaat OpenClaw het kanaal.
  • Als meerdere gevolgde gebruikers zich in dezelfde guild bevinden en de actieve gevolgde gebruiker vertrekt, verplaatst OpenClaw naar het kanaal van een andere bijgehouden gevolgde gebruiker voordat de guild wordt verlaten. Als meerdere gevolgde gebruikers tegelijk verplaatsen, wint het laatst waargenomen voice-state-event.
  • allowedChannels blijft van toepassing. Een gevolgde gebruiker in een niet-toegestaan kanaal wordt genegeerd, en een follow-owned sessie verplaatst naar een andere gevolgde gebruiker of verlaat het kanaal.
  • OpenClaw reconcileert gemiste voice-state-events bij het opstarten en met een begrensd interval. Reconciliatie samplet geconfigureerde guilds en begrenst REST-lookups per run, dus zeer grote followUsers-lijsten kunnen meer dan één interval nodig hebben om te convergeren.
  • Als Discord of een admin de bot verplaatst terwijl deze een gebruiker volgt, bouwt OpenClaw de spraaksessie opnieuw op en behoudt follow ownership wanneer de bestemming is toegestaan. Als de bot buiten allowedChannels wordt verplaatst, verlaat OpenClaw het kanaal en joint het geconfigureerde doel opnieuw wanneer er een bestaat.
  • DAVE-ontvangstherstel kan hetzelfde kanaal verlaten en opnieuw joinen na herhaalde decryptiefouten. Follow-owned sessies behouden hun follow ownership via dat herstelpad, zodat een latere verbreking door een gevolgde gebruiker het kanaal nog steeds verlaat.
Kies tussen de join-modi:
  • Gebruik followUsers voor persoonlijke of operatoropstellingen waarbij de bot automatisch in spraak moet zijn wanneer jij dat bent.
  • Gebruik autoJoin voor bots in vaste ruimtes die aanwezig moeten zijn, zelfs wanneer er geen bijgehouden gebruiker in spraak is.
  • Gebruik /vc join voor eenmalige joins of ruimtes waar automatische spraakaanwezigheid verrassend zou zijn.
Discord-spraakcodec:
  • Spraakontvangstlogs tonen discord voice: opus decoder: libopus-wasm.
  • Realtime afspelen codeert ruwe 48 kHz stereo-PCM naar Opus met hetzelfde gebundelde libopus-wasm-pakket voordat pakketten aan @discordjs/voice worden doorgegeven.
  • Afspelen van bestanden en providerstreams transcodeert met ffmpeg naar ruwe 48 kHz stereo-PCM en gebruikt daarna libopus-wasm voor de Opus-pakketstream die naar Discord wordt gestuurd.
STT-plus-TTS-pijplijn:
  • Discord-PCM-opname wordt geconverteerd naar een tijdelijk WAV-bestand.
  • tools.media.audio handelt STT af, bijvoorbeeld openai/gpt-4o-mini-transcribe.
  • Het transcript wordt via Discord-ingang en routering verzonden terwijl de respons-LLM draait met een spraakuitvoerbeleid dat de agenttool tts verbergt en om teruggegeven tekst vraagt, omdat Discord-spraak eigenaar is van de uiteindelijke TTS-weergave.
  • voice.model, wanneer ingesteld, overschrijft alleen de respons-LLM voor deze spraakkanaalbeurt.
  • voice.tts wordt over messages.tts samengevoegd; providers die streaming ondersteunen voeden de speler rechtstreeks, anders wordt het resulterende audiobestand afgespeeld in het gekoppelde kanaal.
Voorbeeld van standaard agent-proxy-spraakkanaalsessie: 
{
  channels: {
    discord: {
      voice: {
        enabled: true,
        model: "openai/gpt-5.5",
        followUsersEnabled: true,
        followUsers: ["123456789012345678"],
        realtime: {
          provider: "openai",
          model: "gpt-realtime-2",
          speakerVoice: "cedar",
        },
      },
    },
  },
}
Zonder voice.agentSession-blok krijgt elk spraakkanaal zijn eigen gerouteerde OpenClaw-sessie. Bijvoorbeeld: /vc join channel:234567890123456789 praat met de sessie voor dat Discord-spraakkanaal. Het realtime model is alleen de spraakfrontend; inhoudelijke verzoeken worden aan de geconfigureerde OpenClaw-agent doorgegeven. Als het realtime model een definitief transcript produceert zonder de consulttool aan te roepen, forceert OpenClaw de consult als fallback zodat de standaard nog steeds werkt alsof je met de agent praat. Voorbeeld van legacy 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 bidi: 
{
  channels: {
    discord: {
      voice: {
        enabled: true,
        mode: "bidi",
        model: "openai/gpt-5.5",
        realtime: {
          provider: "openai",
          model: "gpt-realtime-2",
          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.5",
        agentSession: {
          mode: "target",
          target: "channel:123456789012345678",
        },
        realtime: {
          provider: "openai",
          model: "gpt-realtime-2",
          speakerVoice: "cedar",
        },
      },
    },
  },
}
In agent-proxy-modus 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 teruggegeven resultaat terug in het spraakkanaal. De supervisoragent kan nog steeds normale berichttools gebruiken volgens zijn toolbeleid, inclusief het verzenden van een apart Discord-bericht als dat de juiste actie is. Terwijl een gedelegeerde OpenClaw-run actief is, worden nieuwe Discord-spraaktranscripten behandeld als live runbesturing voordat een andere agentbeurt wordt gestart. Zinnen zoals “status”, “cancel that”, “use the smaller fix” of “when you’re done also check tests” worden geclassificeerd als status-, annulerings-, bijsturings- of follow-up-invoer voor de actieve sessie. Status-, annulerings-, geaccepteerde bijsturings- en follow-up-uitkomsten worden teruggesproken in het spraakkanaal zodat de beller weet of OpenClaw het verzoek heeft afgehandeld. Nuttige 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-message-sessie.
OpenAI Realtime-voorbeeld met veel echo: 
{
  channels: {
    discord: {
      voice: {
        enabled: true,
        mode: "bidi",
        model: "openai/gpt-5.5",
        realtime: {
          provider: "openai",
          model: "gpt-realtime-2",
          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 je het nog steeds wilt onderbreken door te spreken. OpenClaw voorkomt dat OpenAI automatisch onderbreekt op ruwe invoeraudio, terwijl bargeIn: true ervoor zorgt dat Discord-gebeurtenissen voor sprekerstart en al actieve sprekeraudio actieve realtime reacties kunnen annuleren voordat de volgende vastgelegde beurt OpenAI bereikt. Zeer vroege barge-in-signalen met audioEndMs onder minBargeInAudioEndMs worden behandeld als waarschijnlijke echo/ruis en genegeerd zodat het model niet bij het eerste weergaveframe wordt afgekapt. Verwachte spraaklogs:
  • Bij deelnemen: discord voice: joining ... voiceSession=... supervisorSession=... agentSessionMode=... voiceModel=... realtimeModel=...
  • Bij realtime start: 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 realtime respons: discord voice: realtime audio playback finishing reason=response.done ... audioMs=... chunks=...
  • Bij stoppen/resetten van weergave: discord voice: realtime audio playback stopped reason=... audioMs=... elapsedMs=... chunks=...
  • Bij realtime consult: discord voice: realtime consult requested ... voiceSession=... supervisorSession=... question=...
  • Bij agentantwoord: discord voice: agent turn answer ...
  • Bij in de wachtrij geplaatste exacte spraak: discord voice: realtime exact speech queued ... queued=... outputAudioMs=... outputActive=..., gevolgd door discord voice: realtime exact speech dequeued reason=player-idle ...
  • Bij barge-in-detectie: 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 ofwel 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/ruis: discord voice: realtime model interrupt ignored client:conversation.item.truncate.skipped reason=barge-in audioEndMs=0 minAudioEndMs=250
  • Bij uitgeschakelde barge-in: 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 spraaklogs als tijdlijn om afgekapt geluid te debuggen:
  1. realtime audio playback started betekent dat Discord is begonnen met het afspelen van assistentaudio. De bridge begint vanaf dit punt assistentuitvoerchunks, Discord-PCM-bytes, realtime providerbytes en gesynthetiseerde audioduur te tellen.
  2. realtime speaker turn opened markeert dat een Discord-spreker actief wordt. Als 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 sprekerbeurt is ontvangen. outputActive=true of een niet-nul outputAudioMs hier betekent dat de microfoon invoer verzendt terwijl assistentweergave nog actief is.
  4. barge-in detected source=active-speaker-audio betekent dat OpenClaw live sprekeraudio zag terwijl assistentweergave actief was. Dit is nuttig om een echte onderbreking te onderscheiden van een Discord-gebeurtenis voor sprekerstart zonder bruikbare audio.
  5. barge-in requested reason=... betekent dat OpenClaw de realtime provider heeft gevraagd de actieve respons te annuleren of af te kappen. Het bevat outputAudioMs, outputActive en playbackChunks zodat je kunt zien hoeveel assistentaudio daadwerkelijk was afgespeeld vóór de onderbreking.
  6. realtime audio playback stopped reason=... is het lokale resetpunt voor Discord-weergave. De reden geeft aan wie de weergave stopte: barge-in, player-idle, provider-clear-audio, forced-agent-consult, stream-close of session-close.
  7. realtime speaker turn closed vat de vastgelegde invoerbeurt samen. chunks=0 of hasAudio=false betekent dat de sprekerbeurt werd geopend maar geen bruikbare audio de realtime bridge bereikte. interruptedPlayback=true betekent dat die invoerbeurt overlapte met assistentuitvoer en barge-in-logica activeerde.
Nuttige velden:
  • outputAudioMs: duur van assistentaudio die vóór de logregel door de realtime provider is gegenereerd.
  • audioMs: duur van assistentaudio die OpenClaw telde voordat de weergave stopte.
  • elapsedMs: wall-clock-tijd tussen het openen en sluiten van de weergavestream of sprekerbeurt.
  • discordBytes: 48 kHz stereo-PCM-bytes die naar of van Discord-spraak zijn verzonden of ontvangen.
  • realtimeBytes: PCM-bytes in providerformaat die naar of van de realtime provider zijn verzonden of ontvangen.
  • playbackChunks: assistentaudiochunks die voor de actieve respons naar Discord zijn doorgestuurd.
  • sinceLastAudioMs: tijdsverschil tussen het laatste vastgelegde sprekeraudioframe en het sluiten van de sprekerbeurt.
Veelvoorkomende patronen:
  • Direct afkappen met source=active-speaker-audio, 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 koptelefoon of stel voice.realtime.providers.openai.interruptResponseOnInputAudio: false in.
  • source=speaker-start gevolgd door speaker turn closed ... hasAudio=false betekent dat Discord een sprekerstart meldde, maar dat geen audio OpenClaw bereikte. Dat kan een tijdelijke Discord-spraakgebeurtenis zijn, gedrag van een noise gate, of een client die de microfoon kort activeert.
  • audio playback stopped reason=stream-close zonder nabije barge-in of provider-clear-audio betekent dat de lokale Discord-weergavestream onverwacht is beëindigd. Controleer de voorafgaande provider- en Discord-spelerlogs.
  • capture ignored during playback (barge-in disabled) betekent dat OpenClaw invoer bewust heeft laten vallen terwijl assistentaudio actief was. Schakel voice.realtime.bargeIn in als je wilt dat spraak de weergave onderbreekt.
  • barge-in ignored ... outputActive=false betekent dat Discord of provider-VAD spraak meldde, maar dat OpenClaw geen actieve weergave had om te onderbreken. Dit zou audio niet mogen afkappen.
Referenties worden per component opgelost: LLM-routeauthenticatie voor voice.model, STT-authenticatie voor tools.media.audio, TTS-authenticatie voor messages.tts/voice.tts en realtime providerauthenticatie 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 nodig op de Gateway-host om te inspecteren en te converteren.
  • Geef een lokaal bestandspad op (URL’s worden geweigerd).
  • Laat tekstinhoud weg (Discord weigert tekst + spraakbericht in dezelfde payload).
  • Elk audioformaat wordt geaccepteerd; OpenClaw converteert indien nodig naar OGG/Opus.
message(action="send", channel="discord", target="channel:123", path="/path/to/audio.mp3", asVoice=true)

​
Probleemoplossing

  • schakel Message Content Intent in
  • schakel Server Members Intent in wanneer je afhankelijk bent van gebruiker-/lidresolutie
  • start de Gateway opnieuw na het wijzigen van intents
  • controleer groupPolicy
  • controleer de guild-allowlist onder channels.discord.guilds
  • als de guild-channels-map bestaat, zijn alleen vermelde kanalen toegestaan
  • controleer requireMention-gedrag en vermeldingspatronen
Nuttige controles:
openclaw doctor
openclaw channels status --probe
openclaw logs --follow
Veelvoorkomende oorzaken:
  • groupPolicy="allowlist" zonder overeenkomende guild-/kanaalallowlist
  • requireMention op de verkeerde plek geconfigureerd (moet onder channels.discord.guilds of kanaalvermelding staan)
  • afzender geblokkeerd door guild-/kanaal-users-allowlist
Typische logs:
  • Slow listener detected ...
  • stuck session: sessionKey=agent:...:discord:... state=processing ...
Discord Gateway-wachtrij-instellingen:
  • één account: channels.discord.eventQueue.listenerTimeout
  • meerdere accounts: channels.discord.accounts.<accountId>.eventQueue.listenerTimeout
  • dit beheert alleen listenerwerk van de Discord Gateway, niet de levensduur van agentbeurten
Discord past geen kanaaleigen timeout toe op agentbeurten in de wachtrij. Berichtlisteners dragen direct over, en Discord-runs in de wachtrij behouden de volgorde per sessie totdat de sessie-/tool-/runtimelevenscyclus het werk voltooit of afbreekt.
{
  channels: {
    discord: {
      accounts: {
        default: {
          eventQueue: {
            listenerTimeout: 120000,
          },
        },
      },
    },
  },
}
OpenClaw haalt Discord-/gateway/bot-metadata op voordat verbinding wordt gemaakt. Tijdelijke fouten vallen terug op Discord’s standaard-Gateway-URL en worden in logs beperkt in frequentie.Metadata-timeoutinstellingen:
  • één account: channels.discord.gatewayInfoTimeoutMs
  • meerdere accounts: channels.discord.accounts.<accountId>.gatewayInfoTimeoutMs
  • env-fallback wanneer configuratie niet is ingesteld: OPENCLAW_DISCORD_GATEWAY_INFO_TIMEOUT_MS
  • standaard: 30000 (30 seconden), max: 120000
OpenClaw wacht tijdens het opstarten en na runtime-herverbindingen op Discord’s Gateway-READY-event. Set-ups met meerdere accounts en gespreid opstarten kunnen een langer READY-venster bij opstarten nodig hebben dan de standaard.READY-timeoutinstellingen:
  • opstarten, één account: channels.discord.gatewayReadyTimeoutMs
  • opstarten, meerdere accounts: channels.discord.accounts.<accountId>.gatewayReadyTimeoutMs
  • opstart-env-fallback wanneer configuratie niet is ingesteld: OPENCLAW_DISCORD_READY_TIMEOUT_MS
  • opstartstandaard: 15000 (15 seconden), max: 120000
  • runtime, één account: channels.discord.gatewayRuntimeReadyTimeoutMs
  • runtime, meerdere accounts: channels.discord.accounts.<accountId>.gatewayRuntimeReadyTimeoutMs
  • runtime-env-fallback wanneer configuratie niet is ingesteld: OPENCLAW_DISCORD_RUNTIME_READY_TIMEOUT_MS
  • runtime-standaard: 30000 (30 seconden), max: 120000
channels status --probe-rechtencontroles werken alleen voor numerieke kanaal-ID’s.Als je slug-sleutels gebruikt, kan runtime-matching nog steeds werken, maar kan probe rechten niet volledig verifiëren.
  • DM uitgeschakeld: channels.discord.dm.enabled=false
  • DM-beleid uitgeschakeld: channels.discord.dmPolicy="disabled" (legacy: channels.discord.dm.policy)
  • wacht op koppelingsgoedkeuring in pairing-modus
Standaard worden berichten die door bots zijn geschreven genegeerd.Als je channels.discord.allowBots=true instelt, gebruik dan strikte vermeldings- en allowlistregels om loopgedrag te voorkomen. Geef de voorkeur aan channels.discord.allowBots="mentions" om alleen botberichten te accepteren die de bot vermelden.OpenClaw levert ook gedeelde bot-loopbescherming. Wanneer allowBots toestaat dat door bots geschreven berichten dispatch bereiken, koppelt Discord het inkomende event aan (account, channel, bot pair)-feiten en onderdrukt de generieke paarbewaker het paar nadat het het geconfigureerde eventbudget overschrijdt. De bewaker voorkomt uit de hand lopende loops tussen twee bots die eerder door Discord-rate limits moesten worden gestopt; dit heeft geen invloed op implementaties met één bot of eenmalige botantwoorden die onder het budget blijven.Standaardinstellingen (actief wanneer allowBots is ingesteld):
  • maxEventsPerWindow: 20 — botpaar kan 20 berichten uitwisselen binnen het schuivende venster
  • windowSeconds: 60 — lengte van het schuivende venster
  • cooldownSeconds: 60 — zodra het budget wordt overschreden, wordt elk extra bot-naar-botbericht in beide richtingen één minuut lang gedropt
Configureer de gedeelde standaard eenmaal onder channels.defaults.botLoopProtection en overschrijf Discord daarna wanneer een legitieme workflow meer ruimte nodig heeft. De prioriteit is:
  • channels.discord.accounts.<account>.botLoopProtection
  • channels.discord.botLoopProtection
  • channels.defaults.botLoopProtection
  • ingebouwde standaarden
Discord gebruikt de generieke sleutels maxEventsPerWindow, windowSeconds en cooldownSeconds.
{
  channels: {
    defaults: {
      botLoopProtection: {
        maxEventsPerWindow: 20,
        windowSeconds: 60,
        cooldownSeconds: 60,
      },
    },
    discord: {
      // Optional Discord-wide override. Account blocks override individual
      // fields and inherit omitted fields from here.
      botLoopProtection: {
        maxEventsPerWindow: 4,
      },
      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 a Mantis Discord mention with the configured user id.
            Mantis: "MANTIS_DISCORD_USER_ID",
          },
          botLoopProtection: {
            // Allow up to five messages per minute before suppressing the pair.
            maxEventsPerWindow: 5,
            windowSeconds: 60,
            cooldownSeconds: 90,
          },
        },
      },
    },
  },
}
  • houd OpenClaw actueel (openclaw update) zodat de herstel-logica voor Discord-spraakontvangst aanwezig is
  • bevestig channels.discord.voice.daveEncryption=true (standaard)
  • begin met channels.discord.voice.decryptionFailureTolerance=24 (upstream-standaard) en stem alleen af indien nodig
  • bekijk logs op:
    • discord voice: DAVE decrypt failures detected
    • discord voice: repeated decrypt failures; attempting rejoin
  • als fouten doorgaan na automatisch opnieuw deelnemen, verzamel logs en vergelijk met de upstream DAVE-ontvangstgeschiedenis in discord.js #11419 en discord.js #11449

​
Configuratiereferentie

Primaire referentie: Configuratiereferentie - Discord.
  • opstarten/auth: enabled, token, accounts.*, allowBots
  • beleid: groupPolicy, dm.*, guilds.*, guilds.*.channels.*
  • commando: commands.native, commands.useAccessGroups, configWrites, slashCommand.*
  • eventwachtrij: eventQueue.listenerTimeout (listenerbudget), eventQueue.maxQueueSize, eventQueue.maxConcurrency
  • Gateway: gatewayInfoTimeoutMs, gatewayReadyTimeoutMs, gatewayRuntimeReadyTimeoutMs
  • antwoord/geschiedenis: replyToMode, historyLimit, dmHistoryLimit, dms.*.historyLimit
  • levering: textChunkLimit, chunkMode, maxLinesPerMessage
  • streaming: streaming (legacy-alias: streamMode), streaming.preview.toolProgress, draftChunk, blockStreaming, blockStreamingCoalesce
  • media/opnieuw proberen: mediaMaxMb (beperkt uitgaande Discord-uploads, standaard 100MB), retry
  • acties: actions.*
  • aanwezigheid: activity, status, activityType, activityUrl
  • UI: ui.components.accentColor
  • functies: threadBindings, top-level bindings[] (type: "acp"), pluralkit, execApprovals, intents, agentComponents.enabled, agentComponents.ttlMs, heartbeat, responsePrefix

​
Veiligheid en beheer

  • Behandel bottokens als geheimen (DISCORD_BOT_TOKEN heeft de voorkeur in beheerde omgevingen).
  • Verleen Discord-rechten volgens het principe van minimale rechten.
  • Als commandodeploy/-status verouderd is, start dan de Gateway opnieuw en controleer opnieuw met openclaw channels status --probe.

​
Gerelateerd

Koppelen

Koppel een Discord-gebruiker aan de Gateway.

Groepen

Groepschat- en allowlistgedrag.

Kanaalroutering

Routeer inkomende berichten naar agents.

Beveiliging

Dreigingsmodel en hardening.

Multi-agentroutering

Koppel guilds en kanalen aan agents.

Slash commands

Native commandogedrag.