Discord

​

Snel instellen

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

{
  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 discord
openclaw pairing approve discord <CODE>

​

Aanbevolen: een guildwerkruimte instellen

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

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

​

Runtimemodel

• Gateway beheert de Discord-verbinding.
• De routering van antwoorden is deterministisch: inkomende Discord-berichten worden op Discord beantwoord.
• Metadata van Discord-guilds en -kanalen wordt als niet-vertrouwde context aan de modelprompt toegevoegd, niet als een voor de gebruiker zichtbaar antwoordvoorvoegsel. Als een model die envelop terugkopieert, verwijdert OpenClaw de gekopieerde metadata uit uitgaande antwoorden en uit toekomstige herhalingscontext.
• Standaard (session.dmScope=main) delen directe chats 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).
• Native 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 van Cron/Heartbeat met alleen tekst aan Discord wordt samengevoegd tot het uiteindelijke, voor de assistent zichtbare antwoord en eenmaal verzonden. Media en gestructureerde componentpayloads blijven uit meerdere berichten bestaan wanneer de agent meerdere leverbare payloads produceert.

​

Forumkanalen

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

openclaw message send --channel discord --target channel:<forumId> \
  --message "Onderwerptitel\nInhoud van het bericht"

openclaw message thread create --channel discord --target channel:<forumId> \
  --thread-name "Onderwerptitel" --message "Inhoud van het bericht"

​

Interactieve componenten

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

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

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

{
  channel: "discord",
  action: "send",
  to: "channel:123456789012345678",
  message: "Optionele reservetekst",
  components: {
    reusable: true,
    text: "Kies een pad",
    blocks: [
      {
        type: "actions",
        buttons: [
          {
            label: "Goedkeuren",
            style: "success",
            allowedUsers: ["123456789012345678"],
          },
          { label: "Afwijzen", style: "danger" },
        ],
      },
      {
        type: "actions",
        select: {
          type: "string",
          placeholder: "Kies een optie",
          options: [
            { label: "Optie A", value: "a" },
            { label: "Optie B", value: "b" },
          ],
        },
      },
    ],
    modal: {
      title: "Details",
      triggerLabel: "Formulier openen",
      fields: [
        { type: "text", label: "Aanvrager" },
        {
          type: "select",
          label: "Prioriteit",
          options: [
            { label: "Laag", value: "low" },
            { label: "Hoog", 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

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

​

Systeemeigen opdrachten en opdrachtauthenticatie

• commands.native is standaard "auto" en is ingeschakeld voor Discord.
• Overschrijving per kanaal: channels.discord.commands.native.
• commands.native=false slaat de registratie en opschoning van Discord-slashopdrachten tijdens het opstarten over. Eerder geregistreerde opdrachten kunnen zichtbaar blijven in Discord totdat je ze uit de Discord-app verwijdert.
• Authenticatie van systeemeigen opdrachten gebruikt dezelfde Discord-toelatingslijsten en hetzelfde beleid als normale berichtverwerking.
• Opdrachten kunnen in de Discord-interface nog steeds zichtbaar zijn voor onbevoegde gebruikers; bij uitvoering wordt OpenClaw-authenticatie afgedwongen en wordt “niet geautoriseerd” geantwoord.
• Standaardinstellingen voor slashopdrachten: ephemeral: true (channels.discord.slashCommand.ephemeral).

​

Functiedetails

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

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

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

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

{
  channels: {
    discord: {
      subagentProgress: true,
    },
  },
}

{
  agents: {
    entries: {
      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: {
      intents: { presence: true },
      guilds: {
        "111111111111111111": {
          presenceEvents: {
            channelId: "222222222222222222",
            users: ["333333333333333333"], // optional; further narrow channel viewers
            reconnectSuppressSeconds: 300, // optional; new-session quiet window (0 disables)
            burstLimit: 8, // optional; max events per burst window
            burstWindowSeconds: 60, // optional; sliding burst-detection window
          },
        },
      },
    },
  },
}

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

​

Tools en actiepoorten

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

​

UI met Components v2

• channels.discord.ui.components.accentColor stelt de accentkleur in die door Discord-componentcontainers wordt gebruikt (hex). 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 Components v2 aanwezig zijn.
• Voorvertoningen van gewone URL’s worden standaard onderdrukt. Stel suppressEmbeds: false in voor een berichtactie wanneer één uitgaande link moet worden uitgevouwen.

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

​

Spraak

​

Spraakkanalen

1. Schakel Message Content Intent in de Discord Developer Portal in.
2. Schakel Server Members Intent in wanneer toelatingslijsten voor rollen/gebruikers 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 opdrachten in (commands.native of channels.discord.commands.native).
6. Configureer channels.discord.voice.

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

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

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

• 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 GuildVoiceStates-gatewayintentie in te schakelen. channels.discord.intents.voiceStates kan het intentieabonnement expliciet overschrijven; 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 gespreksbeurten, onderbrekingen en het afspelen, delegeert inhoudelijk werk via openclaw_agent_consult aan de gerouteerde OpenClaw-agent en behandelt het resultaat alsof het een getypte Discord-prompt van die spreker is. stt-tts behoudt de oudere batchflow met STT plus TTS. Met bidi kan het realtimemodel rechtstreeks converseren, terwijl openclaw_agent_consult beschikbaar wordt gesteld 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 gerouteerde agentmodel over te nemen. Dit staat los van voice.realtime.model.
• Met voice.followUsers kan de bot zich bij geselecteerde gebruikers aansluiten bij Discord-spraak, met hen meeverhuizen en het spraakkanaal verlaten. Zie Gebruikers volgen in spraak.
• agent-proxy routeert spraak via discord-voice, waarbij 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 volledige, aan de eigenaar gelijkwaardige tooltoegang voor sprekers die eigenaar zijn (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 worden voltooid terwijl Discord het eerste antwoord nog afspeelt, worden latere antwoorden met exacte spraak in de wachtrij geplaatst totdat het afspelen inactief is, in plaats van spraak halverwege een zin te vervangen.
• In de modus stt-tts gebruikt STT tools.media.audio; voice.model heeft geen invloed op de transcriptie.
• In realtimemodi configureren voice.realtime.provider, voice.realtime.model en voice.realtime.speakerVoice de realtime audiosessie. Gebruik voor OpenAI Realtime 2.1 plus het Codex-brein voice.realtime.model: "gpt-realtime-2.1" en voice.model: "openai/gpt-5.6-sol".
• Realtimespraakmodi nemen standaard kleine profielbestanden IDENTITY.md, USER.md en SOUL.md op in de instructies voor de realtimeprovider, 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 [] om dit uit te schakelen. Alleen die 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.
• In de realtime OpenAI-modus agent-proxy past de activering op weknaam zich standaard aan de ruimte aan: één persoon kan natuurlijk spreken zonder weknaam, terwijl twee of meer personen een beurt met een weknaam moeten beginnen of eindigen. Andere bots tellen niet als personen. Stel voice.realtime.requireWakeName: true in om altijd een weknaam te vereisen of false om er nooit een te vereisen. 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. Een actieve weknaamcontrole schakelt automatische antwoorden van de realtimeprovider uit, routeert geaccepteerde beurten via het raadpleegpad van de OpenClaw-agent en geeft een korte gesproken bevestiging wanneer een weknaam aan het begin wordt herkend uit een gedeeltelijke transcriptie voordat het definitieve transcript binnenkomt. Het beleid volgt live deelnemers die binnenkomen en vertrekken zonder opnieuw verbinding met spraak te maken.
• De realtimeprovider van OpenAI accepteert huidige Realtime 2-gebeurtenisnamen en verouderde Codex-compatibele aliassen voor uitvoeraudio- en transcriptgebeurtenissen, zodat compatibele providersnapshots kunnen afwijken zonder assistentaudio weg te laten.
• voice.realtime.bargeIn bepaalt of Discord-gebeurtenissen voor het begin van spreken het actieve realtime afspelen onderbreken. Als dit niet is ingesteld, volgt het de instelling van de realtimeprovider voor onderbreking door invoeraudio.
• voice.realtime.minBargeInAudioEndMs bepaalt de minimale afspeelduur van de assistent voordat een onderbreking in OpenAI-realtime de audio afkapt. Standaard: 250. Stel 0 in voor onmiddellijke onderbreking in ruimtes met weinig echo, of verhoog dit voor luidsprekeropstellingen met veel echo.
• voice.tts overschrijft tts alleen voor het afspelen van stt-tts-spraak; realtimemodi gebruiken in plaats daarvan voice.realtime.speakerVoice. Stel voor een OpenAI-stem bij afspelen via Discord 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 voor het huidige OpenAI TTS-model.
• Discord-overschrijvingen per kanaal in systemPrompt zijn van toepassing op spraaktranscriptiebeurten voor dat spraakkanaal.
• Wanneer OpenClaw zich bij een spraakkanaal aansluit, ontvangt de gerouteerde agentsessie een stille systeemgebeurtenis met de huidige deelnemerslijst. Latere deelnemers die binnenkomen en vertrekken werken die sessie bij zonder een ongevraagd gesproken antwoord te activeren; Discord-weergavenamen worden behandeld als niet-vertrouwde labels. Geautoriseerde spraakbeurten ontvangen ook een actuele momentopname van de deelnemerslijst.
• Spraaktranscriptiebeurten en /vc-opdrachten gebruiken Discord-vermeldingen in commands.ownerAllowFrom voor de eigenaarsstatus. Wanneer er geen eigenaar voor Discord-opdrachten is geconfigureerd, kan de allowFrom (of verouderde dm.allowFrom) van het geselecteerde Discord-account nog steeds spraaktoegang autoriseren zonder eigenaarsstatus toe te kennen. De zichtbaarheid van agenttools volgt het geconfigureerde toolbeleid voor de gerouteerde sessie.
• Als voice.autoJoin meerdere vermeldingen voor dezelfde guild bevat, sluit OpenClaw zich aan bij het laatst geconfigureerde kanaal voor die guild.
• voice.allowedChannels is een optionele toelatingslijst voor verblijf. Laat dit oningesteld om /vc join in elk geautoriseerd Discord-spraakkanaal toe te staan. Wanneer dit is ingesteld, worden /vc join, automatisch aansluiten 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 aansluitingen bij Discord-spraak te weigeren. Als Discord de bot buiten de toelatingslijst verplaatst, verlaat OpenClaw dat kanaal en sluit het zich opnieuw aan bij het geconfigureerde doel voor automatisch aansluiten wanneer er een beschikbaar is.
• voice.daveEncryption en voice.decryptionFailureTolerance worden doorgegeven aan de aansluitopties van @discordjs/voice; de bovenliggende standaardwaarden zijn daveEncryption=true en decryptionFailureTolerance=24.
• OpenClaw gebruikt de meegeleverde libopus-wasm-codec voor de ontvangst van Discord-spraak en het realtime afspelen van onbewerkte PCM. Deze wordt geleverd met een vastgezette libopus-WebAssembly-build en vereist geen native opus-add-ons.
• voice.connectTimeoutMs bepaalt de initiële wachttijd op @discordjs/voice Ready voor /vc join en pogingen om automatisch aan te sluiten. Standaard: 30000.
• voice.reconnectGraceMs bepaalt hoelang OpenClaw wacht totdat een verbroken spraaksessie opnieuw verbinding begint te maken voordat de sessie 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 nadat het afspelen is voltooid voor de volgende beurt. Realtimemodi sturen het begin van spreken door als onderbrekingssignalen naar de realtimeprovider.
• In realtimemodi kan echo van luidsprekers naar een open microfoon op een onderbreking lijken en het afspelen onderbreken. Stel voor Discord-ruimtes 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 je nog steeds wilt dat Discord-gebeurtenissen voor het begin van spreken het actieve afspelen onderbreken. De OpenAI-realtimebridge negeert afkappingen van het afspelen die korter zijn dan voice.realtime.minBargeInAudioEndMs als waarschijnlijke echo/ruis en registreert ze als overgeslagen in plaats van het afspelen via 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 hakkelende 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 fouten bij het ontsleutelen van ontvangen gegevens en herstelt automatisch door het spraakkanaal te verlaten en er opnieuw aan 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 @discordjs/voice-regel bevat de bovenliggende opvullingscorrectie uit discord.js-PR #11449, waarmee discord.js-issue #11419 werd gesloten.
• The operation was aborted-ontvangstgebeurtenissen worden verwacht wanneer OpenClaw een vastgelegd sprekersegment afrondt; het zijn uitgebreide diagnostische meldingen, geen waarschuwingen.
• Uitgebreide Discord-spraaklogboeken bevatten voor elk geaccepteerd sprekersegment een begrensd STT-transcriptievoorbeeld van één regel, zodat bij foutopsporing zowel de gebruikerszijde als de antwoordzijde van de agent zichtbaar is zonder onbeperkte transcriptietekst te dumpen.
• In de modus agent-proxy slaat de terugval voor afgedwongen raadpleging waarschijnlijk onvolledige transcriptiefragmenten over, zoals tekst die eindigt op ... of een afsluitend verbindingswoord zoals “en”, evenals duidelijk niet-uitvoerbare afsluitingen zoals “ben zo terug” of “dag”. Logboeken tonen forced agent consult skipped reason=... wanneer dit een verouderd antwoord in de wachtrij voorkomt.

​

Gebruikers volgen in spraak

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

• followUsers accepteert onbewerkte Discord-gebruikers-ID’s en discord:<id>-waarden. OpenClaw normaliseert beide vormen voordat spraakstatusgebeurtenissen worden vergeleken.
• followUsersEnabled wordt standaard ingesteld op true wanneer followUsers is geconfigureerd. Stel dit in op false om de opgeslagen lijst te behouden, maar het automatisch volgen van spraak te stoppen.
• followUsers regelt alleen de aanwezigheid in spraakkanalen. Het verleent geen toegang als spreker of eigenaarsbevoegdheid; configureer commands.ownerAllowFrom en gebruikers en rollen voor de server of het kanaal afzonderlijk.
• Wanneer een gevolgde gebruiker deelneemt aan een toegestaan spraakkanaal, neemt OpenClaw deel aan dat kanaal. Wanneer de gebruiker zich verplaatst, verplaatst OpenClaw zich mee. Wanneer de actief gevolgde gebruiker de verbinding verbreekt, verlaat OpenClaw het kanaal.
• Als meerdere gevolgde gebruikers zich op dezelfde server bevinden en de actief gevolgde gebruiker vertrekt, verplaatst OpenClaw zich naar het kanaal van een andere bijgehouden gevolgde gebruiker voordat de server wordt verlaten. Als meerdere gevolgde gebruikers zich tegelijk verplaatsen, is de laatst waargenomen spraakstatusgebeurtenis bepalend.
• allowedChannels blijft van toepassing. Een gevolgde gebruiker in een niet-toegestaan kanaal wordt genegeerd en een sessie die door volgen wordt beheerd, verplaatst zich naar een andere gevolgde gebruiker of vertrekt.
• OpenClaw reconcilieert gemiste spraakstatusgebeurtenissen bij het opstarten en met een begrensd interval. Bij reconciliatie worden geconfigureerde servers steekproefsgewijs gecontroleerd en wordt het aantal REST-opzoekacties per uitvoering begrensd. Daardoor kan het bij zeer grote followUsers-lijsten meer dan één interval duren voordat de status overeenkomt.
• Als Discord of een beheerder de bot verplaatst terwijl deze een gebruiker volgt, bouwt OpenClaw de spraaksessie opnieuw op en blijft het volgen de sessie beheren als 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.
• Bij DAVE-ontvangstherstel kan hetzelfde kanaal na herhaalde ontsleutelingsfouten worden verlaten en opnieuw worden betreden. Sessies die door volgen worden beheerd, blijven tijdens dat herstelpad door volgen beheerd, zodat het kanaal alsnog wordt verlaten wanneer een gevolgde gebruiker later de verbinding verbreekt.

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

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

• De Discord-PCM-opname wordt omgezet in een tijdelijk WAV-bestand.
• tools.media.audio verwerkt STT, bijvoorbeeld openai/gpt-4o-mini-transcribe.
• Het transcript wordt via de Discord-ingang en routering verzonden, terwijl het LLM voor het antwoord wordt uitgevoerd met een beleid voor spraakuitvoer dat het tts-hulpmiddel van de agent verbergt en om geretourneerde tekst vraagt, omdat Discord-spraak het uiteindelijke TTS-afspelen beheert.
• voice.model overschrijft, wanneer ingesteld, alleen het LLM voor het antwoord tijdens deze beurt in het spraakkanaal.
• voice.tts wordt over tts samengevoegd; providers die streaming ondersteunen, leveren rechtstreeks aan de speler. Anders wordt het resulterende audiobestand in het kanaal afgespeeld waaraan is deelgenomen.

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

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

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

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

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

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

• 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/herstellen van het afspelen: discord voice: realtime audio playback stopped reason=... audioMs=... elapsedMs=... chunks=...
• Bij realtime consultatie: discord voice: realtime consult requested ... voiceSession=... supervisorSession=... question=...
• Bij antwoord van de agent: discord voice: agent turn answer ...
• Bij exact in de wachtrij geplaatste spraak: 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/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 inactief afspelen: discord voice: realtime barge-in ignored reason=... outputActive=false ... playbackChunks=0

1. realtime audio playback started betekent dat Discord is begonnen met het afspelen van assistentaudio. Vanaf dit punt begint de bridge assistentuitvoerblokken, Discord-PCM-bytes, realtime providerbytes en de duur van gesynthetiseerde audio te tellen.
2. realtime speaker turn opened markeert dat een Discord-spreker actief wordt. Als het afspelen 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 daadwerkelijk ontvangen audioframe voor die sprekerbeurt. outputActive=true of een niet-nulwaarde voor outputAudioMs betekent hier dat de microfoon invoer verzendt terwijl het afspelen van de assistent nog actief is.
4. barge-in detected source=active-speaker-audio betekent dat OpenClaw live sprekeraudio heeft waargenomen terwijl het afspelen van de assistent actief was. Dit is nuttig om een echte onderbreking te onderscheiden van een Discord-gebeurtenis voor het begin van een spreker zonder bruikbare audio.
5. barge-in requested reason=... betekent dat OpenClaw de realtime provider heeft gevraagd het actieve antwoord 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 herstelpunt voor het afspelen in Discord. De reden geeft aan wie het afspelen 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 sprekerbeurt is geopend, maar dat geen bruikbare audio de realtime bridge heeft bereikt. interruptedPlayback=true betekent dat die invoerbeurt de uitvoer van de assistent overlapte en de onderbrekingslogica activeerde.

• outputAudioMs: duur van de assistentaudio die vóór de logregel door de realtime provider is gegenereerd.
• audioMs: duur van de assistentaudio die OpenClaw heeft geteld voordat het afspelen stopte.
• elapsedMs: verstreken kloktijd tussen het openen en sluiten van de afspeelstream of sprekerbeurt.
• discordBytes: 48 kHz stereo-PCM-bytes die naar Discord-spraak zijn verzonden of daarvan zijn ontvangen.
• realtimeBytes: PCM-bytes in providerindeling die naar de realtime provider zijn verzonden of daarvan zijn ontvangen.
• playbackChunks: assistentaudioblokken die voor het actieve antwoord naar Discord zijn doorgestuurd.
• sinceLastAudioMs: tijdsverschil tussen het laatste opgenomen sprekeraudioframe en het sluiten van de sprekerbeurt.

• Onmiddellijk afbreken 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 meldde dat een spreker begon, maar dat OpenClaw geen audio ontving. Dit kan een tijdelijke Discord-spraakgebeurtenis zijn, gedrag van de ruispoort of een client die de microfoon kort activeert.
• audio playback stopped reason=stream-close zonder een nabijgelegen onderbreking of provider-clear-audio betekent dat de lokale Discord-afspeelstream onverwacht is beëindigd. Controleer de voorafgaande logboeken van de provider en de 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 je wilt dat spraak het afspelen onderbreekt.
• barge-in ignored ... outputActive=false betekent dat Discord of de VAD van de provider spraak heeft gemeld, maar OpenClaw geen actieve afspeelsessie had om te onderbreken. Hierdoor mag audio niet worden afgebroken.

​

Spraakberichten

• 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 zo nodig naar OGG/Opus.

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

​

Problemen oplossen

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

{
  channels: {
    defaults: {
      botLoopProtection: {
        maxEventsPerWindow: 20,
        windowSeconds: 60,
        cooldownSeconds: 60,
      },
    },
    discord: {
      // Optionele overschrijving voor heel Discord. Accountblokken overschrijven afzonderlijke
      // velden en nemen weggelaten velden van hier over.
      botLoopProtection: {
        maxEventsPerWindow: 4,
      },
      accounts: {
        alpha: {
          // Alpha luistert alleen naar andere bots wanneer zij Alpha vermelden.
          allowBots: "mentions",
        },
        bravo: {
          // Bravo luistert naar alle Discord-berichten van bots.
          allowBots: true,
          mentionAliases: {
            // Hiermee kan Bravo een Discord-vermelding van Alpha schrijven met de 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

​

Discord Activities

• activities.clientSecret: OAuth2-clientgeheim voor de Discord-applicatie; valt terug op DISCORD_CLIENT_SECRET
• activities.applicationId: optionele Activity-applicatie-ID; standaard de botapplicatie-ID die bij het opstarten van de Gateway wordt verkregen

​

Veiligheid en beheer

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

​

Gerelateerd