Discord

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 antwoordthreads uit. Expliciete [[reply_to_*]]-tags worden nog steeds gerespecteerd. first koppelt de impliciete native antwoordreferentie altijd aan het eerste uitgaande Discord-bericht voor de beurt. batched koppelt de impliciete native antwoordreferentie van Discord alleen wanneer de inkomende beurt een gedebouncete batch van meerdere berichten was. Dit is nuttig wanneer je native antwoorden vooral wilt voor dubbelzinnige chats met veel korte berichten, niet voor elke beurt met één bericht.

Bericht-ID's worden zichtbaar gemaakt in context/geschiedenis zodat agents specifieke berichten kunnen targeten.

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 behoudt één bewerkbaar statusconcept en werkt dit bij met toolvoortgang tot de uiteindelijke levering; streamMode is een verouderde runtime-alias. Voer openclaw doctor --fix uit om persistente configuratie naar de canonieke sleutel te herschrijven.

Stel channels.discord.streaming.mode in op off om Discord-previewbewerkingen uit te schakelen. Als Discord-blockstreaming expliciet is ingeschakeld, slaat OpenClaw de previewstream over om dubbel streamen te voorkomen.

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

• partial bewerkt één previewbericht terwijl tokens binnenkomen.
• block verzendt conceptgrote chunks (gebruik draftChunk om grootte en breekpunten af te stemmen, begrensd op textChunkLimit).
• Media, fouten en expliciete antwoordfinales annuleren wachtende previewbewerkingen.
• streaming.preview.toolProgress (standaard true) bepaalt of tool-/voortgangsupdates het previewbericht hergebruiken.
• 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"
        }
      }
    }
  }
}

Previewstreaming is alleen tekst; media-antwoorden vallen terug op normale levering. Wanneer block-streaming expliciet is ingeschakeld, slaat OpenClaw de previewstream over om dubbel streamen te voorkomen.

Guildgeschiedeniscontext:

• channels.discord.historyLimit standaard 20
• fallback: messages.groupChat.historyLimit
• 0 schakelt uit

Besturing voor DM-geschiedenis:

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

Threadgedrag:

• Discord-threads worden gerouteerd als kanaalsessies en erven bovenliggende kanaalconfiguratie tenzij overschreven.
• Threadsessies erven de sessieniveau-/model-selectie van het bovenliggende kanaal als fallback alleen voor het model; threadlokale /model-selecties krijgen nog steeds voorrang en transcriptgeschiedenis van de parent wordt niet gekopieerd tenzij transcriptovererving is ingeschakeld.
• channels.discord.thread.inheritParent (standaard false) laat nieuwe auto-threads seeden vanuit het parenttranscript. 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 fallback voor activatie in de antwoordfase.

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 aan een sessietarget binden 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/werk automatische inactiviteitsontfocus bij voor gefocuste bindingen
• /session max-age <duration|off> inspecteer/werk harde maximale leeftijd bij voor gefocuste bindingen

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.* overschrijft 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 threadbindingen voor een account zijn uitgeschakeld, zijn /focus en gerelateerde threadbindingsbewerkingen niet beschikbaar.

Zie Subagents, ACP Agents en Configuratiereferentie.

Configureer voor stabiele "altijd-aan" ACP-workspaces topniveau getypeerde ACP-bindingen die op Discord-gesprekken targeten.

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 de plek zelf en houdt toekomstige berichten op dezelfde ACP-sessie. Threadberichten erven de bovenliggende kanaalbinding.
• In een gebonden kanaal of gebonden thread resetten /new en /reset dezelfde ACP-sessie op de plek zelf. Tijdelijke threadbindingen kunnen targetresolutie overschrijven zolang ze actief zijn.
• spawnSessions beheert aanmaken/binden van childthreads via --thread auto|here.

Zie ACP Agents voor details over bindingsgedrag.

Reactiemeldingsmodus per guild:

• off
• own (standaard)
• all
• allowlist (gebruikt guilds.<id>.users)

Reactie-events worden omgezet naar systeemevents en gekoppeld aan de gerouteerde Discord-sessie.

ackReaction verzendt een bevestigings-emoji terwijl OpenClaw een inkomend bericht verwerkt.

Resolutievolgorde:

• channels.discord.accounts.<accountId>.ackReaction
• channels.discord.ackReaction
• messages.ackReaction
• fallback naar emoji van agentidentiteit (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 config-writes zijn standaard ingeschakeld.

Dit beïnvloedt /config set|unset-flows (wanneer opdrachtfuncties zijn ingeschakeld).

Uitschakelen:

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

Routeer Discord Gateway-WebSocketverkeer en REST-lookups bij het opstarten (application ID + allowlistresolutie) via een HTTP(S)-proxy met channels.discord.proxy.

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

Override per account:

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

Schakel PluralKit-resolutie in om geproxiede berichten te mappen naar 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
• lookups gebruiken de originele bericht-ID en zijn beperkt tot een tijdvenster
• als lookup mislukt, worden geproxiede 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 leidende @; 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",
      },
    },
  },
},
},
}

Presence-updates worden toegepast wanneer je een status- of activiteitsveld instelt, of wanneer je automatische presence inschakelt.

Voorbeeld 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: Streaming (vereist activityUrl)
• 2: Luisteren
• 3: Kijken
• 4: Aangepast (gebruikt de activiteitstekst als de statusstatus; emoji is optioneel)
• 5: Deelnemen aan competitie

Voorbeeld van automatische presence (runtimegezondheidssignaal):

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

Automatische aanwezigheid koppelt runtimebeschikbaarheid 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 goedkeuringsafhandeling met knoppen 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 uitvoeringsgoedkeuringen automatisch in wanneer enabled niet is ingesteld of "auto" is en ten minste één goedkeurder kan worden herleid, via execApprovals.approvers of via commands.ownerAllowFrom. Discord leidt geen uitvoeringsgoedkeurders 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 groepopdrachten 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 herleide goedkeurders kunnen de knoppen gebruiken; andere gebruikers ontvangen een tijdelijke weigering. Goedkeuringsprompts bevatten de opdrachttekst, 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 kanaalfan-out toe. Wanneer die knoppen aanwezig zijn, vormen ze de primaire goedkeurings-UX; OpenClaw mag alleen een handmatige /approve-opdracht opnemen wanneer het toolresultaat zegt dat chatgoedkeuringen niet beschikbaar zijn of handmatige goedkeuring het enige pad is. Als de native Discord-goedkeuringsruntime niet actief is, houdt OpenClaw de lokale deterministische /approve <id> <decision>-prompt zichtbaar. Als de runtime actief is maar een native kaart niet aan een doel kan worden geleverd, stuurt OpenClaw een fallbackmelding in dezelfde chat met de exacte /approve- opdracht 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 Uitvoeringsgoedkeuringen.

• schakel Message Content Intent in
• schakel Server Members Intent in wanneer je afhankelijk bent van gebruikers-/ledenresolutie
• herstart de gateway na het wijzigen van intents

• verifieer groupPolicy
• verifieer de guild-allowlist onder channels.discord.guilds
• als de guild-channels-map bestaat, zijn alleen vermelde kanalen toegestaan
• verifieer requireMention-gedrag en vermeldingspatronen

Nuttige controles:

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

Veelvoorkomende oorzaken:

• groupPolicy="allowlist" zonder overeenkomende guild-/kanaal-allowlist
• requireMention op de verkeerde plaats 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:

• enkel account: channels.discord.eventQueue.listenerTimeout
• meerdere accounts: channels.discord.accounts.<accountId>.eventQueue.listenerTimeout
• dit regelt alleen Discord Gateway-listenerwerk, niet de levensduur van een agentbeurt

Discord past geen kanaaleigen time-out 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 is voltooid of het werk wordt afgebroken.

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

OpenClaw haalt Discord /gateway/bot-metagegevens op voordat er verbinding wordt gemaakt. Tijdelijke fouten vallen terug op de standaard-Gateway-URL van Discord en worden in logs aan rate limiting onderworpen.

Time-outinstellingen voor metagegevens:

• enkel 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 het Discord Gateway-READY-event. Set-ups met meerdere accounts en gespreid opstarten kunnen een langer READY-venster bij opstarten nodig hebben dan de standaardwaarde.

READY-time-outinstellingen:

• opstarten met enkel account: channels.discord.gatewayReadyTimeoutMs
• opstarten met meerdere accounts: channels.discord.accounts.<accountId>.gatewayReadyTimeoutMs
• env-fallback bij opstarten wanneer configuratie niet is ingesteld: OPENCLAW_DISCORD_READY_TIMEOUT_MS
• standaard bij opstarten: 15000 (15 seconden), max: 120000
• runtime met enkel account: channels.discord.gatewayRuntimeReadyTimeoutMs
• runtime met meerdere accounts: channels.discord.accounts.<accountId>.gatewayRuntimeReadyTimeoutMs
• env-fallback bij runtime wanneer configuratie niet is ingesteld: OPENCLAW_DISCORD_RUNTIME_READY_TIMEOUT_MS
• standaard bij runtime: 30000 (30 seconden), max: 120000

Permissiecontroles met channels status --probe werken alleen voor numerieke kanaal-ID's.

Als je slug-sleutels gebruikt, kan runtime-matching nog steeds werken, maar kan de probe permissies niet volledig verifiëren.

• DM uitgeschakeld: channels.discord.dm.enabled=false
• DM-beleid uitgeschakeld: channels.discord.dmPolicy="disabled" (legacy: channels.discord.dm.policy)
• wachten 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 lusgedrag te voorkomen. Gebruik bij voorkeur channels.discord.allowBots="mentions" om alleen botberichten te accepteren die de bot vermelden.

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

• houd OpenClaw actueel (openclaw update) zodat de herstellogica voor Discord-spraakontvangst aanwezig is
• bevestig channels.discord.voice.daveEncryption=true (standaard)
• begin met channels.discord.voice.decryptionFailureTolerance=24 (upstream-standaard) en pas alleen aan indien nodig
• let in logs op:
  • discord voice: DAVE decrypt failures detected
  • discord voice: repeated decrypt failures; attempting rejoin
• als fouten na automatische herjoin blijven optreden, verzamel logs en vergelijk met de upstream DAVE-ontvangstgeschiedenis in discord.js #11419 en discord.js #11449