--- read_when: - Een kanaal-Plugin configureren (authenticatie, toegangscontrole, meerdere accounts) - Probleemoplossing voor configuratiesleutels per kanaal - Controle van DM-beleid, groepsbeleid of vermeldingsgating summary: 'Kanaalconfiguratie: toegangscontrole, koppeling, sleutels per kanaal voor Slack, Discord, Telegram, WhatsApp, Matrix, iMessage en meer' title: Configuratie — kanalen x-i18n: generated_at: "2026-05-11T20:29:56Z" model: gpt-5.5 provider: openai source_hash: 4199725cdf1216f639ee1c02d5f510e1373edfecacf56977ac3a15d63f207f41 source_path: gateway/config-channels.md workflow: 16 --- Configuratiesleutels per kanaal onder `channels.*`. Behandelt DM- en groepstoegang, set-ups met meerdere accounts, mention-gating en kanaalspecifieke sleutels voor Slack, Discord, Telegram, WhatsApp, Matrix, iMessage en de andere meegeleverde kanaalplugins. Zie voor agents, tools, Gateway-runtime en andere sleutels op het hoogste niveau [Configuratiereferentie](/nl/gateway/configuration-reference). ## Kanalen Elk kanaal start automatisch wanneer de configuratiesectie ervan bestaat (tenzij `enabled: false`). ### DM- en groepstoegang Alle kanalen ondersteunen DM-beleid en groepsbeleid: | DM-beleid | Gedrag | | ------------------- | --------------------------------------------------------------- | | `pairing` (standaard) | Onbekende afzenders krijgen een eenmalige koppelingscode; eigenaar moet goedkeuren | | `allowlist` | Alleen afzenders in `allowFrom` (of gekoppelde allow-opslag) | | `open` | Alle inkomende DM's toestaan (vereist `allowFrom: ["*"]`) | | `disabled` | Alle inkomende DM's negeren | | Groepsbeleid | Gedrag | | --------------------- | ------------------------------------------------------ | | `allowlist` (standaard) | Alleen groepen die overeenkomen met de geconfigureerde allowlist | | `open` | Groeps-allowlists overslaan (mention-gating blijft van toepassing) | | `disabled` | Alle groeps-/roomberichten blokkeren | `channels.defaults.groupPolicy` stelt de standaard in wanneer de `groupPolicy` van een provider niet is ingesteld. Koppelingscodes verlopen na 1 uur. Wachtende DM-koppelingsverzoeken zijn beperkt tot **3 per kanaal**. Als een providerblok volledig ontbreekt (`channels.` afwezig), valt het runtime-groepsbeleid terug op `allowlist` (fail-closed) met een opstartwaarschuwing. ### Modeloverschrijvingen per kanaal Gebruik `channels.modelByChannel` om specifieke kanaal-ID's aan een model vast te zetten. Waarden accepteren `provider/model` of geconfigureerde modelaliassen. De kanaaltoewijzing wordt toegepast wanneer een sessie nog geen modeloverschrijving heeft (bijvoorbeeld ingesteld via `/model`). ```json5 { channels: { modelByChannel: { discord: { "123456789012345678": "anthropic/claude-opus-4-6", }, slack: { C1234567890: "openai/gpt-4.1", }, telegram: { "-1001234567890": "openai/gpt-4.1-mini", "-1001234567890:topic:99": "anthropic/claude-sonnet-4-6", }, }, }, } ``` ### Kanaalstandaarden en Heartbeat Gebruik `channels.defaults` voor gedeeld groepsbeleid en Heartbeat-gedrag over providers heen: ```json5 { channels: { defaults: { groupPolicy: "allowlist", // open | allowlist | disabled contextVisibility: "all", // all | allowlist | allowlist_quote heartbeat: { showOk: false, showAlerts: true, useIndicator: true, }, }, }, } ``` - `channels.defaults.groupPolicy`: fallback-groepsbeleid wanneer een `groupPolicy` op providerniveau niet is ingesteld. - `channels.defaults.contextVisibility`: standaardmodus voor aanvullende contextzichtbaarheid voor alle kanalen. Waarden: `all` (standaard, neem alle geciteerde/thread-/geschiedeniscontext op), `allowlist` (neem alleen context van afzenders op de allowlist op), `allowlist_quote` (hetzelfde als allowlist maar behoud expliciete citaat-/antwoordcontext). Overschrijving per kanaal: `channels..contextVisibility`. - `channels.defaults.heartbeat.showOk`: neem gezonde kanaalstatussen op in Heartbeat-uitvoer. - `channels.defaults.heartbeat.showAlerts`: neem gedegradeerde/foutstatussen op in Heartbeat-uitvoer. - `channels.defaults.heartbeat.useIndicator`: render compacte Heartbeat-uitvoer in indicatorstijl. ### WhatsApp WhatsApp draait via het webkanaal van de Gateway (Baileys Web). Het start automatisch wanneer er een gekoppelde sessie bestaat. ```json5 { web: { enabled: true, heartbeatSeconds: 60, whatsapp: { keepAliveIntervalMs: 25000, connectTimeoutMs: 60000, defaultQueryTimeoutMs: 60000, }, reconnect: { initialMs: 2000, maxMs: 120000, factor: 1.4, jitter: 0.2, maxAttempts: 0, }, }, channels: { whatsapp: { dmPolicy: "pairing", // pairing | allowlist | open | disabled allowFrom: ["+15555550123", "+447700900123"], textChunkLimit: 4000, chunkMode: "length", // length | newline mediaMaxMb: 50, sendReadReceipts: true, // blue ticks (false in self-chat mode) groups: { "*": { requireMention: true }, }, groupPolicy: "allowlist", groupAllowFrom: ["+15551234567"], }, }, } ``` ```json5 { channels: { whatsapp: { accounts: { default: {}, personal: {}, biz: { // authDir: "~/.openclaw/credentials/whatsapp/biz", }, }, }, }, } ``` - Uitgaande opdrachten gebruiken standaard account `default` als dat aanwezig is; anders de eerste geconfigureerde account-ID (gesorteerd). - Optionele `channels.whatsapp.defaultAccount` overschrijft die fallbackselectie van het standaardaccount wanneer deze overeenkomt met een geconfigureerde account-ID. - Verouderde Baileys-auth-dir voor één account wordt door `openclaw doctor` gemigreerd naar `whatsapp/default`. - Overschrijvingen per account: `channels.whatsapp.accounts..sendReadReceipts`, `channels.whatsapp.accounts..dmPolicy`, `channels.whatsapp.accounts..allowFrom`. ### Telegram ```json5 { channels: { telegram: { enabled: true, botToken: "your-bot-token", dmPolicy: "pairing", allowFrom: ["tg:123456789"], groups: { "*": { requireMention: true }, "-1001234567890": { allowFrom: ["@admin"], systemPrompt: "Keep answers brief.", topics: { "99": { requireMention: false, skills: ["search"], systemPrompt: "Stay on topic.", }, }, }, }, customCommands: [ { command: "backup", description: "Git backup" }, { command: "generate", description: "Create an image" }, ], historyLimit: 50, replyToMode: "first", // off | first | all | batched linkPreview: true, streaming: "partial", // off | partial | block | progress (default: off; opt in explicitly to avoid preview-edit rate limits) actions: { reactions: true, sendMessage: true }, reactionNotifications: "own", // off | own | all mediaMaxMb: 100, retry: { attempts: 3, minDelayMs: 400, maxDelayMs: 30000, jitter: 0.1, }, network: { autoSelectFamily: true, dnsResultOrder: "ipv4first", }, apiRoot: "https://api.telegram.org", proxy: "socks5://localhost:9050", webhookUrl: "https://example.com/telegram-webhook", webhookSecret: "secret", webhookPath: "/telegram-webhook", }, }, } ``` - Bottoken: `channels.telegram.botToken` of `channels.telegram.tokenFile` (alleen regulier bestand; symlinks geweigerd), met `TELEGRAM_BOT_TOKEN` als fallback voor het standaardaccount. - `apiRoot` is alleen de Telegram Bot API-root. Gebruik `https://api.telegram.org` of je zelf gehoste/proxy-root, niet `https://api.telegram.org/bot`; `openclaw doctor --fix` verwijdert een onbedoeld achtervoegsel `/bot`. - Optionele `channels.telegram.defaultAccount` overschrijft de standaardaccountselectie wanneer deze overeenkomt met een geconfigureerde account-ID. - Stel in set-ups met meerdere accounts (2+ account-ID's) een expliciete standaard in (`channels.telegram.defaultAccount` of `channels.telegram.accounts.default`) om fallbackroutering te voorkomen; `openclaw doctor` waarschuwt wanneer deze ontbreekt of ongeldig is. - `configWrites: false` blokkeert door Telegram geïnitieerde configuratieschrijfacties (supergroup-ID-migraties, `/config set|unset`). - Items op het hoogste niveau in `bindings[]` met `type: "acp"` configureren persistente ACP-bindingen voor forumtopics (gebruik canonieke `chatId:topic:topicId` in `match.peer.id`). Veldsemantiek wordt gedeeld in [ACP-agenten](/nl/tools/acp-agents#persistent-channel-bindings). - Telegram-streamvoorbeelden gebruiken `sendMessage` + `editMessageText` (werkt in directe en groepschats). - Retrybeleid: zie [Retrybeleid](/nl/concepts/retry). ### Discord ```json5 { channels: { discord: { enabled: true, token: "your-bot-token", mediaMaxMb: 100, allowBots: false, actions: { reactions: true, stickers: true, polls: true, permissions: true, messages: true, threads: true, pins: true, search: true, memberInfo: true, roleInfo: true, roles: false, channelInfo: true, voiceStatus: true, events: true, moderation: false, }, replyToMode: "off", // off | first | all | batched dmPolicy: "pairing", allowFrom: ["1234567890", "123456789012345678"], dm: { enabled: true, groupEnabled: false, groupChannels: ["openclaw-dm"] }, guilds: { "123456789012345678": { slug: "friends-of-openclaw", requireMention: false, ignoreOtherMentions: true, reactionNotifications: "own", users: ["987654321098765432"], channels: { general: { allow: true }, help: { allow: true, requireMention: true, users: ["987654321098765432"], skills: ["docs"], systemPrompt: "Short answers only.", }, }, }, }, historyLimit: 20, textChunkLimit: 2000, chunkMode: "length", // length | newline streaming: { mode: "progress", // off | partial | block | progress (Discord default: progress) progress: { label: "auto", maxLines: 8, toolProgress: true, }, }, maxLinesPerMessage: 17, ui: { components: { accentColor: "#5865F2", }, }, threadBindings: { enabled: true, idleHours: 24, maxAgeHours: 0, spawnSessions: true, defaultSpawnContext: "fork", }, voice: { enabled: true, autoJoin: [ { guildId: "123456789012345678", channelId: "234567890123456789", }, ], daveEncryption: true, decryptionFailureTolerance: 24, connectTimeoutMs: 30000, reconnectGraceMs: 15000, tts: { provider: "openai", openai: { voice: "alloy" }, }, }, execApprovals: { enabled: "auto", // true | false | "auto" approvers: ["987654321098765432"], agentFilter: ["default"], sessionFilter: ["discord:"], target: "dm", // dm | channel | both cleanupAfterResolve: false, }, retry: { attempts: 3, minDelayMs: 500, maxDelayMs: 30000, jitter: 0.1, }, }, }, } ``` - Token: `channels.discord.token`, met `DISCORD_BOT_TOKEN` als terugvalwaarde voor het standaardaccount. - Directe uitgaande oproepen die een expliciete Discord-`token` opgeven, gebruiken die token voor de oproep; instellingen voor accountherhaling/-beleid komen nog steeds uit het geselecteerde account in de actieve runtime-snapshot. - Optioneel `channels.discord.defaultAccount` overschrijft de standaardaccountselectie wanneer dit overeenkomt met een geconfigureerde account-id. - Gebruik `user:` (DM) of `channel:` (guild-kanaal) voor bezorgdoelen; kale numerieke ID's worden geweigerd. - Guild-slugs zijn kleine letters met spaties vervangen door `-`; kanaalsleutels gebruiken de slug-vorm van de naam (zonder `#`). Geef de voorkeur aan guild-ID's. - Door bots geschreven berichten worden standaard genegeerd. `allowBots: true` schakelt ze in; gebruik `allowBots: "mentions"` om alleen botberichten te accepteren die de bot vermelden (eigen berichten blijven gefilterd). - `channels.discord.guilds..ignoreOtherMentions` (en kanaaloverschrijvingen) laat berichten vallen die een andere gebruiker of rol vermelden maar niet de bot (met uitzondering van @everyone/@here). - `channels.discord.mentionAliases` koppelt stabiele uitgaande `@handle`-tekst aan Discord-gebruikers-ID's vóór verzending, zodat bekende teamgenoten deterministisch kunnen worden vermeld, zelfs wanneer de tijdelijke directorycache leeg is. Accountspecifieke overschrijvingen staan onder `channels.discord.accounts..mentionAliases`. - `maxLinesPerMessage` (standaard 17) splitst hoge berichten, zelfs wanneer ze onder 2000 tekens blijven. - `channels.discord.threadBindings` beheert Discord-threadgebonden routering: - `enabled`: Discord-overschrijving voor threadgebonden sessiefuncties (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age` en gebonden bezorging/routering) - `idleHours`: Discord-overschrijving voor automatisch ontfocussen bij inactiviteit in uren (`0` schakelt uit) - `maxAgeHours`: Discord-overschrijving voor harde maximale leeftijd in uren (`0` schakelt uit) - `spawnSessions`: schakelaar voor `sessions_spawn({ thread: true })` en automatische threadaanmaak/-binding voor ACP-thread-spawn (standaard: `true`) - `defaultSpawnContext`: native subagentcontext voor threadgebonden spawns (standaard `"fork"`) - Top-level `bindings[]`-items met `type: "acp"` configureren permanente ACP-bindingen voor kanalen en threads (gebruik kanaal-/thread-id in `match.peer.id`). Veldsemantiek wordt gedeeld in [ACP-agenten](/nl/tools/acp-agents#persistent-channel-bindings). - `channels.discord.ui.components.accentColor` stelt de accentkleur in voor Discord components v2-containers. - `channels.discord.voice` schakelt Discord-spraakkanaalgesprekken en optionele auto-join + LLM + TTS-overschrijvingen in. Tekst-only Discord-configuraties laten spraak standaard uit; stel `channels.discord.voice.enabled=true` in om je aan te melden. - `channels.discord.voice.model` overschrijft optioneel het LLM-model dat wordt gebruikt voor antwoorden in Discord-spraakkanalen. - `channels.discord.voice.daveEncryption` en `channels.discord.voice.decryptionFailureTolerance` worden doorgegeven aan DAVE-opties van `@discordjs/voice` (standaard `true` en `24`). - `channels.discord.voice.connectTimeoutMs` beheert de initiële `@discordjs/voice` Ready-wachttijd voor `/vc join` en auto-join-pogingen (standaard `30000`). - `channels.discord.voice.reconnectGraceMs` bepaalt hoe lang een verbroken spraaksessie mag doen over het binnengaan van reconnect-signalering voordat OpenClaw deze vernietigt (standaard `15000`). - Discord-spraakweergave wordt niet onderbroken door een speaking-start-gebeurtenis van een andere gebruiker. Om feedbackloops te vermijden, negeert OpenClaw nieuwe spraakopname terwijl TTS wordt afgespeeld. - OpenClaw probeert daarnaast spraakontvangst te herstellen door een spraaksessie te verlaten en opnieuw te joinen na herhaalde decryptiefouten. - `channels.discord.streaming` is de canonieke sleutel voor streammodus. Discord gebruikt standaard `streaming.mode: "progress"`, zodat voortgang van tools/werk in één bewerkt voorbeeldbericht verschijnt; stel `streaming.mode: "off"` in om dit uit te schakelen. Verouderde `streamMode`- en booleaanse `streaming`-waarden blijven runtime-aliassen; voer `openclaw doctor --fix` uit om persistente configuratie te herschrijven. - `channels.discord.autoPresence` koppelt runtimebeschikbaarheid aan botpresence (healthy => online, degraded => idle, exhausted => dnd) en staat optionele overschrijvingen voor statustekst toe. - `channels.discord.dangerouslyAllowNameMatching` schakelt veranderlijke naam-/tagmatching opnieuw in (break-glass-compatibiliteitsmodus). - `channels.discord.execApprovals`: Discord-native bezorging van exec-goedkeuringen en autorisatie van goedkeurders. - `enabled`: `true`, `false` of `"auto"` (standaard). In auto-modus worden exec-goedkeuringen geactiveerd wanneer goedkeurders kunnen worden herleid uit `approvers` of `commands.ownerAllowFrom`. - `approvers`: Discord-gebruikers-ID's die exec-verzoeken mogen goedkeuren. Valt terug op `commands.ownerAllowFrom` wanneer weggelaten. - `agentFilter`: optionele toestemmingslijst met agent-ID's. Laat weg om goedkeuringen voor alle agenten door te sturen. - `sessionFilter`: optionele sessiesleutelpatronen (substring of regex). - `target`: waar goedkeuringsprompts naartoe worden gestuurd. `"dm"` (standaard) stuurt naar DM's van goedkeurders, `"channel"` stuurt naar het oorspronkelijke kanaal, `"both"` stuurt naar beide. Wanneer het doel `"channel"` bevat, zijn knoppen alleen bruikbaar door herleide goedkeurders. - `cleanupAfterResolve`: wanneer `true`, verwijdert goedkeurings-DM's na goedkeuring, weigering of timeout. **Meldingsmodi voor reacties:** `off` (geen), `own` (berichten van de bot, standaard), `all` (alle berichten), `allowlist` (van `guilds..users` op alle berichten). ### Google Chat ```json5 { channels: { googlechat: { enabled: true, serviceAccountFile: "/path/to/service-account.json", audienceType: "app-url", // app-url | project-number audience: "https://gateway.example.com/googlechat", webhookPath: "/googlechat", botUser: "users/1234567890", dm: { enabled: true, policy: "pairing", allowFrom: ["users/1234567890"], }, groupPolicy: "allowlist", groups: { "spaces/AAAA": { allow: true, requireMention: true }, }, actions: { reactions: true }, typingIndicator: "message", mediaMaxMb: 20, }, }, } ``` - Serviceaccount-JSON: inline (`serviceAccount`) of bestandsgebaseerd (`serviceAccountFile`). - Serviceaccount-SecretRef wordt ook ondersteund (`serviceAccountRef`). - Env-terugvalwaarden: `GOOGLE_CHAT_SERVICE_ACCOUNT` of `GOOGLE_CHAT_SERVICE_ACCOUNT_FILE`. - Gebruik `spaces/` of `users/` voor bezorgdoelen. - `channels.googlechat.dangerouslyAllowNameMatching` schakelt veranderlijke matching van e-mailprincipals opnieuw in (break-glass-compatibiliteitsmodus). ### Slack ```json5 { channels: { slack: { enabled: true, botToken: "xoxb-...", appToken: "xapp-...", socketMode: { clientPingTimeout: 15000, serverPingTimeout: 30000, pingPongLoggingEnabled: false, }, dmPolicy: "pairing", allowFrom: ["U123", "U456", "*"], dm: { enabled: true, groupEnabled: false, groupChannels: ["G123"] }, channels: { C123: { allow: true, requireMention: true, allowBots: false }, "#general": { allow: true, requireMention: true, allowBots: false, users: ["U123"], skills: ["docs"], systemPrompt: "Short answers only.", }, }, historyLimit: 50, allowBots: false, reactionNotifications: "own", reactionAllowlist: ["U123"], replyToMode: "off", // off | first | all | batched thread: { historyScope: "thread", // thread | channel inheritParent: false, }, actions: { reactions: true, messages: true, pins: true, memberInfo: true, emojiList: true, }, slashCommand: { enabled: true, name: "openclaw", sessionPrefix: "slack:slash", ephemeral: true, }, typingReaction: "hourglass_flowing_sand", unfurlLinks: false, unfurlMedia: false, textChunkLimit: 4000, chunkMode: "length", streaming: { mode: "partial", // off | partial | block | progress nativeTransport: true, // use Slack native streaming API when mode=partial }, mediaMaxMb: 20, execApprovals: { enabled: "auto", // true | false | "auto" approvers: ["U123"], agentFilter: ["default"], sessionFilter: ["slack:"], target: "dm", // dm | channel | both }, }, }, } ``` - **Socketmodus** vereist zowel `botToken` als `appToken` (`SLACK_BOT_TOKEN` + `SLACK_APP_TOKEN` voor env-terugval van het standaardaccount). - **HTTP-modus** vereist `botToken` plus `signingSecret` (op rootniveau of per account). - `socketMode` geeft transporttuning voor Slack SDK Socket Mode door aan de publieke Bolt receiver-API. Gebruik dit alleen bij onderzoek naar ping/pong-timeouts of verouderd websocketgedrag. - `botToken`, `appToken`, `signingSecret` en `userToken` accepteren plattetekststrings of SecretRef-objecten. - Slack-account-snapshots tonen per-credential bron-/statusvelden zoals `botTokenSource`, `botTokenStatus`, `appTokenStatus` en, in HTTP-modus, `signingSecretStatus`. `configured_unavailable` betekent dat het account is geconfigureerd via SecretRef, maar dat het huidige command-/runtimepad de geheime waarde niet kon herleiden. - `configWrites: false` blokkeert door Slack geïnitieerde config-writes. - Optioneel `channels.slack.defaultAccount` overschrijft de standaardaccountselectie wanneer dit overeenkomt met een geconfigureerde account-id. - `channels.slack.streaming.mode` is de canonieke sleutel voor Slack-streammodus. `channels.slack.streaming.nativeTransport` beheert Slacks native streamingtransport. Verouderde `streamMode`-, booleaanse `streaming`- en `nativeStreaming`-waarden blijven runtime-aliassen; voer `openclaw doctor --fix` uit om persistente configuratie te herschrijven. - `unfurlLinks` en `unfurlMedia` geven Slacks `chat.postMessage`-booleans voor link- en media-unfurling door voor botantwoorden. Laat ze weg om Slacks standaardgedrag te behouden; stel ze in op `channels.slack.accounts.` om de top-level standaard voor één account te overschrijven. - Gebruik `user:` (DM) of `channel:` voor bezorgdoelen. **Meldingsmodi voor reacties:** `off`, `own` (standaard), `all`, `allowlist` (van `reactionAllowlist`). **Threadsessie-isolatie:** `thread.historyScope` is per thread (standaard) of gedeeld over het kanaal. `thread.inheritParent` kopieert het transcript van het bovenliggende kanaal naar nieuwe threads. - Slack native streaming plus de Slack assistant-stijl threadstatus "is typing..." vereisen een antwoordthreaddoel. Top-level DM's blijven standaard buiten threads, zodat ze nog steeds kunnen streamen via Slack-conceptvoorbeelden met posten-en-bewerken in plaats van de thread-stijl native stream-/statuspreview te tonen. - `typingReaction` voegt een tijdelijke reactie toe aan het inkomende Slack-bericht terwijl een antwoord loopt, en verwijdert deze na voltooiing. Gebruik een Slack-emoji-shortcode zoals `"hourglass_flowing_sand"`. - `channels.slack.execApprovals`: Slack-native bezorging van exec-goedkeuringen en autorisatie van goedkeurders. Zelfde schema als Discord: `enabled` (`true`/`false`/`"auto"`), `approvers` (Slack-gebruikers-ID's), `agentFilter`, `sessionFilter` en `target` (`"dm"`, `"channel"` of `"both"`). | Actiegroep | Standaard | Opmerkingen | | ---------- | --------- | ------------------------ | | reactions | enabled | Reageren + reacties tonen | | messages | enabled | Lezen/verzenden/bewerken/verwijderen | | pins | enabled | Vastzetten/losmaken/lijst | | memberInfo | enabled | Lidgegevens | | emojiList | enabled | Aangepaste emoji-lijst | ### Mattermost Mattermost wordt meegeleverd als gebundelde Plugin in huidige OpenClaw-releases. Oudere of aangepaste builds kunnen een actueel npm-pakket installeren met `openclaw plugins install @openclaw/mattermost`. Controleer [npmjs.com/package/@openclaw/mattermost](https://www.npmjs.com/package/@openclaw/mattermost) voor de huidige dist-tags voordat je een versie pint. ```json5 { channels: { mattermost: { enabled: true, botToken: "mm-token", baseUrl: "https://chat.example.com", dmPolicy: "pairing", chatmode: "oncall", // oncall | onmessage | onchar oncharPrefixes: [">", "!"], groups: { "*": { requireMention: true }, "team-channel-id": { requireMention: false }, }, commands: { native: true, // opt-in nativeSkills: true, callbackPath: "/api/channels/mattermost/command", // Optional explicit URL for reverse-proxy/public deployments callbackUrl: "https://gateway.example.com/api/channels/mattermost/command", }, textChunkLimit: 4000, chunkMode: "length", }, }, } ``` Chatmodi: `oncall` (reageer op @-vermelding, standaard), `onmessage` (elk bericht), `onchar` (berichten die beginnen met triggerprefix). Wanneer native Mattermost-commando's zijn ingeschakeld: - `commands.callbackPath` moet een pad zijn (bijvoorbeeld `/api/channels/mattermost/command`), geen volledige URL. - `commands.callbackUrl` moet verwijzen naar het OpenClaw Gateway-eindpunt en bereikbaar zijn vanaf de Mattermost-server. - Native slash-callbacks worden geverifieerd met de tokens per commando die door Mattermost worden geretourneerd tijdens slash-commandoregistratie. Als registratie mislukt of er geen commando's worden geactiveerd, weigert OpenClaw callbacks met `Unauthorized: invalid command token.` - Voor private/tailnet/interne callbackhosts kan Mattermost vereisen dat `ServiceSettings.AllowedUntrustedInternalConnections` de callbackhost/het callbackdomein bevat. Gebruik host-/domeinwaarden, geen volledige URL's. - `channels.mattermost.configWrites`: sta door Mattermost geïnitieerde configuratieschrijfacties toe of weiger ze. - `channels.mattermost.requireMention`: vereis `@mention` voordat in kanalen wordt geantwoord. - `channels.mattermost.groups..requireMention`: override voor vermeldingspoort per kanaal (`"*"` voor standaard). - Optioneel overschrijft `channels.mattermost.defaultAccount` de standaardaccountselectie wanneer deze overeenkomt met een geconfigureerde account-id. ### Signal ```json5 { channels: { signal: { enabled: true, account: "+15555550123", // optional account binding dmPolicy: "pairing", allowFrom: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"], configWrites: true, reactionNotifications: "own", // off | own | all | allowlist reactionAllowlist: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"], historyLimit: 50, }, }, } ``` **Meldingsmodi voor reacties:** `off`, `own` (standaard), `all`, `allowlist` (van `reactionAllowlist`). - `channels.signal.account`: koppel het opstarten van het kanaal aan een specifieke Signal-accountidentiteit. - `channels.signal.configWrites`: sta door Signal geïnitieerde configuratieschrijfacties toe of weiger ze. - Optioneel overschrijft `channels.signal.defaultAccount` de standaardaccountselectie wanneer deze overeenkomt met een geconfigureerde account-id. ### iMessage OpenClaw start `imsg rpc` (JSON-RPC via stdio). Geen daemon of poort vereist. Dit is het voorkeursproces voor nieuwe OpenClaw iMessage-setups wanneer de host machtigingen kan geven voor de Messages-database en Automation. BlueBubbles-ondersteuning is verwijderd. `channels.bluebubbles` is geen ondersteund runtimeconfiguratievlak in de huidige OpenClaw. Migreer oude configuraties naar `channels.imessage`; gebruik [BlueBubbles-verwijdering en het imsg iMessage-pad](/nl/announcements/bluebubbles-imessage) voor de korte versie en [Overstappen vanaf BlueBubbles](/nl/channels/imessage-from-bluebubbles) voor de volledige vertaaltabel. Als de Gateway niet draait op de Mac waarop Messages is aangemeld, laat `channels.imessage.enabled=true` staan en stel `channels.imessage.cliPath` in op een SSH-wrapper die `imsg "$@"` op die Mac uitvoert. Het standaard lokale `imsg`-pad is alleen voor macOS. ```json5 { channels: { imessage: { enabled: true, cliPath: "imsg", dbPath: "~/Library/Messages/chat.db", remoteHost: "user@gateway-host", dmPolicy: "pairing", allowFrom: ["+15555550123", "user@example.com", "chat_id:123"], historyLimit: 50, includeAttachments: false, attachmentRoots: ["/Users/*/Library/Messages/Attachments"], remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"], mediaMaxMb: 16, service: "auto", region: "US", actions: { reactions: true, edit: true, unsend: true, reply: true, sendWithEffect: true, sendAttachment: true, }, catchup: { enabled: false, }, }, }, } ``` - Optioneel overschrijft `channels.imessage.defaultAccount` de standaardaccountselectie wanneer deze overeenkomt met een geconfigureerde account-id. - Vereist volledige schijftoegang tot de Messages-DB. - Geef de voorkeur aan `chat_id:`-doelen. Gebruik `imsg chats --limit 20` om chats weer te geven. - `cliPath` kan naar een SSH-wrapper wijzen; stel `remoteHost` (`host` of `user@host`) in voor het ophalen van SCP-bijlagen. - `attachmentRoots` en `remoteAttachmentRoots` beperken inkomende bijlagepaden (standaard: `/Users/*/Library/Messages/Attachments`). - SCP gebruikt strikte controle van hostsleutels, dus zorg dat de relayhostsleutel al bestaat in `~/.ssh/known_hosts`. - `channels.imessage.configWrites`: sta door iMessage geïnitieerde configuratieschrijfacties toe of weiger ze. - `channels.imessage.actions.*`: schakel private API-acties in die ook worden afgeschermd door `imsg status` / `openclaw channels status --probe`. - `channels.imessage.includeAttachments` staat standaard uit; stel dit in op `true` voordat je inkomende media in agentbeurten verwacht. - `channels.imessage.catchup.enabled`: meld je aan om inkomende berichten opnieuw af te spelen die zijn aangekomen terwijl de Gateway offline was. - `channels.imessage.groups`: groepsregister en instellingen per groep. Configureer met `groupPolicy: "allowlist"` expliciete `chat_id`-sleutels of een `"*"`-wildcardvermelding zodat groepsberichten de registerpoort kunnen passeren. - Top-level `bindings[]`-vermeldingen met `type: "acp"` kunnen iMessage-gesprekken aan persistente ACP-sessies koppelen. Gebruik een genormaliseerde handle of expliciet chatdoel (`chat_id:*`, `chat_guid:*`, `chat_identifier:*`) in `match.peer.id`. Gedeelde veldsemantiek: [ACP-agenten](/nl/tools/acp-agents#persistent-channel-bindings). ```bash #!/usr/bin/env bash exec ssh -T gateway-host imsg "$@" ``` ### Matrix Matrix wordt door een Plugin ondersteund en geconfigureerd onder `channels.matrix`. ```json5 { channels: { matrix: { enabled: true, homeserver: "https://matrix.example.org", accessToken: "syt_bot_xxx", proxy: "http://127.0.0.1:7890", encryption: true, initialSyncLimit: 20, defaultAccount: "ops", accounts: { ops: { name: "Ops", userId: "@ops:example.org", accessToken: "syt_ops_xxx", }, alerts: { userId: "@alerts:example.org", password: "secret", proxy: "http://127.0.0.1:7891", }, }, }, }, } ``` - Tokenauthenticatie gebruikt `accessToken`; wachtwoordauthenticatie gebruikt `userId` + `password`. - `channels.matrix.proxy` routeert Matrix HTTP-verkeer via een expliciete HTTP(S)-proxy. Benoemde accounts kunnen dit overschrijven met `channels.matrix.accounts..proxy`. - `channels.matrix.network.dangerouslyAllowPrivateNetwork` staat private/interne homeservers toe. `proxy` en deze netwerkopt-in zijn onafhankelijke controles. - `channels.matrix.defaultAccount` selecteert het voorkeursaccount in setups met meerdere accounts. - `channels.matrix.autoJoin` is standaard `off`, dus uitgenodigde kamers en nieuwe DM-achtige uitnodigingen worden genegeerd totdat je `autoJoin: "allowlist"` met `autoJoinAllowlist` of `autoJoin: "always"` instelt. - `channels.matrix.execApprovals`: Matrix-native levering van exec-goedkeuringen en autorisatie van goedkeurders. - `enabled`: `true`, `false`, of `"auto"` (standaard). In automodus worden exec-goedkeuringen geactiveerd wanneer goedkeurders kunnen worden opgelost vanuit `approvers` of `commands.ownerAllowFrom`. - `approvers`: Matrix-gebruikers-ID's (bijv. `@owner:example.org`) die exec-verzoeken mogen goedkeuren. - `agentFilter`: optionele allowlist voor agent-ID's. Laat weg om goedkeuringen voor alle agenten door te sturen. - `sessionFilter`: optionele sessiesleutelpatronen (substring of regex). - `target`: waar goedkeuringsprompts naartoe moeten worden gestuurd. `"dm"` (standaard), `"channel"` (oorspronkelijke kamer), of `"both"`. - Overrides per account: `channels.matrix.accounts..execApprovals`. - `channels.matrix.dm.sessionScope` bepaalt hoe Matrix-DM's in sessies worden gegroepeerd: `per-user` (standaard) deelt per gerouteerde peer, terwijl `per-room` elke DM-kamer isoleert. - Matrix-statusprobes en live directory-lookups gebruiken hetzelfde proxybeleid als runtimeverkeer. - Volledige Matrix-configuratie, doelregels en setupvoorbeelden zijn gedocumenteerd in [Matrix](/nl/channels/matrix). ### Microsoft Teams Microsoft Teams wordt door een Plugin ondersteund en geconfigureerd onder `channels.msteams`. ```json5 { channels: { msteams: { enabled: true, configWrites: true, // appId, appPassword, tenantId, webhook, team/channel policies: // see /channels/msteams }, }, } ``` - Belangrijkste kernpaden die hier worden behandeld: `channels.msteams`, `channels.msteams.configWrites`. - Volledige Teams-configuratie (inloggegevens, webhook, DM-/groepsbeleid, overrides per team/per kanaal) is gedocumenteerd in [Microsoft Teams](/nl/channels/msteams). ### IRC IRC wordt door een Plugin ondersteund en geconfigureerd onder `channels.irc`. ```json5 { channels: { irc: { enabled: true, dmPolicy: "pairing", configWrites: true, nickserv: { enabled: true, service: "NickServ", password: "${IRC_NICKSERV_PASSWORD}", register: false, registerEmail: "bot@example.com", }, }, }, } ``` - Belangrijkste kernpaden die hier worden behandeld: `channels.irc`, `channels.irc.dmPolicy`, `channels.irc.configWrites`, `channels.irc.nickserv.*`. - Optioneel overschrijft `channels.irc.defaultAccount` de standaardaccountselectie wanneer deze overeenkomt met een geconfigureerde account-id. - Volledige IRC-kanaalconfiguratie (host/poort/TLS/kanalen/allowlists/vermeldingspoort) is gedocumenteerd in [IRC](/nl/channels/irc). ### Meerdere accounts (alle kanalen) Voer meerdere accounts per kanaal uit (elk met een eigen `accountId`): ```json5 { channels: { telegram: { accounts: { default: { name: "Primary bot", botToken: "123456:ABC...", }, alerts: { name: "Alerts bot", botToken: "987654:XYZ...", }, }, }, }, } ``` - `default` wordt gebruikt wanneer `accountId` is weggelaten (CLI + routering). - Env-tokens zijn alleen van toepassing op het **standaard**account. - Basiskanaalinstellingen gelden voor alle accounts tenzij ze per account worden overschreven. - Gebruik `bindings[].match.accountId` om elk account naar een andere agent te routeren. - Als je een niet-standaardaccount toevoegt via `openclaw channels add` (of kanaalonboarding) terwijl je nog een single-account top-level kanaalconfiguratie gebruikt, promoveert OpenClaw eerst account-gescopeerde top-level single-accountwaarden naar de accountmap van het kanaal, zodat het oorspronkelijke account blijft werken. De meeste kanalen verplaatsen ze naar `channels..accounts.default`; Matrix kan in plaats daarvan een bestaand overeenkomend benoemd/standaarddoel behouden. - Bestaande bindings alleen voor kanalen (zonder `accountId`) blijven overeenkomen met het standaardaccount; account-gescopeerde bindings blijven optioneel. - `openclaw doctor --fix` repareert ook gemengde vormen door account-gescopeerde top-level single-accountwaarden te verplaatsen naar het gepromoveerde account dat voor dat kanaal is gekozen. De meeste kanalen gebruiken `accounts.default`; Matrix kan in plaats daarvan een bestaand overeenkomend benoemd/standaarddoel behouden. ### Andere Plugin-kanalen Veel Plugin-kanalen worden geconfigureerd als `channels.` en gedocumenteerd op hun eigen kanaalpagina's (bijvoorbeeld Feishu, Matrix, LINE, Nostr, Zalo, Nextcloud Talk, Synology Chat en Twitch). Zie de volledige kanaalindex: [Kanalen](/nl/channels). ### Vermeldingspoort voor groepschats Groepsberichten vereisen standaard **een vermelding** (metadatavermelding of veilige regexpatronen). Geldt voor WhatsApp, Telegram, Discord, Google Chat en iMessage-groepschats. Zichtbare antwoorden worden afzonderlijk beheerd. Groeps-/kanaalruimtes gebruiken standaard `messages.groupChat.visibleReplies: "message_tool"`: OpenClaw verwerkt de beurt nog steeds, maar normale eindantwoorden blijven privé en zichtbare room-uitvoer vereist `message(action=send)`. Stel `"automatic"` alleen in wanneer je het legacy-gedrag wilt waarbij normale antwoorden terug naar de room worden geplaatst. Om hetzelfde tool-only gedrag voor zichtbare antwoorden ook op directe chats toe te passen, stel je `messages.visibleReplies: "message_tool"` in; de Codex harness gebruikt dat tool-only gedrag ook als zijn niet-ingestelde standaard voor directe chats. Tool-only zichtbare antwoorden vereisen een model/runtime die betrouwbaar tools aanroept. Als het sessielogboek assistenttekst toont met `didSendViaMessagingTool: false`, heeft het model een privé-eindantwoord geproduceerd in plaats van de message tool aan te roepen. Schakel over naar een sterker model voor tool-calling voor dat kanaal, of stel `messages.groupChat.visibleReplies: "automatic"` in om legacy zichtbare eindantwoorden te herstellen. Als de message tool niet beschikbaar is onder het actieve toolbeleid, valt OpenClaw terug op automatische zichtbare antwoorden in plaats van het antwoord stilzwijgend te onderdrukken. `openclaw doctor` waarschuwt voor deze mismatch. De Gateway herlaadt de `messages`-configuratie live nadat het bestand is opgeslagen. Herstart alleen wanneer bestandsbewaking of config-herladen in de deployment is uitgeschakeld. **Vermeldingstypen:** - **Metadata-vermeldingen**: Native platform @-vermeldingen. Genegeerd in WhatsApp self-chat-modus. - **Tekstpatronen**: Veilige regex-patronen in `agents.list[].groupChat.mentionPatterns`. Ongeldige patronen en onveilige geneste herhaling worden genegeerd. - Vermeldingsafscherming wordt alleen afgedwongen wanneer detectie mogelijk is (native vermeldingen of ten minste één patroon). ```json5 { messages: { visibleReplies: "automatic", // global default for direct/source chats; Codex harness defaults unset direct chats to message_tool groupChat: { historyLimit: 50, visibleReplies: "message_tool", // default; use "automatic" for legacy final replies }, }, agents: { list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }], }, } ``` `messages.groupChat.historyLimit` stelt de globale standaard in. Kanalen kunnen dit overschrijven met `channels..historyLimit` (of per account). Stel `0` in om uit te schakelen. `messages.visibleReplies` is de globale standaard voor source-turns; `messages.groupChat.visibleReplies` overschrijft deze voor groeps-/kanaal-source-turns. Wanneer `messages.visibleReplies` niet is ingesteld, kan een harness zijn eigen standaard voor direct/source leveren; de Codex harness gebruikt standaard `message_tool`. Kanaal-allowlists en vermeldingsafscherming bepalen nog steeds of een beurt wordt verwerkt. #### DM-geschiedenislimaieten ```json5 { channels: { telegram: { dmHistoryLimit: 30, dms: { "123456789": { historyLimit: 50 }, }, }, }, } ``` Resolutie: per-DM-override → providerstandaard → geen limiet (alles behouden). Ondersteund: `telegram`, `whatsapp`, `discord`, `slack`, `signal`, `imessage`, `msteams`. #### Self-chat-modus Neem je eigen nummer op in `allowFrom` om self-chat-modus in te schakelen (negeert native @-vermeldingen, reageert alleen op tekstpatronen): ```json5 { channels: { whatsapp: { allowFrom: ["+15555550123"], groups: { "*": { requireMention: true } }, }, }, agents: { list: [ { id: "main", groupChat: { mentionPatterns: ["reisponde", "@openclaw"] }, }, ], }, } ``` ### Opdrachten (afhandeling van chatopdrachten) ```json5 { commands: { native: "auto", // register native commands when supported nativeSkills: "auto", // register native skill commands when supported text: true, // parse /commands in chat messages bash: false, // allow ! (alias: /bash) bashForegroundMs: 2000, config: false, // allow /config mcp: false, // allow /mcp plugins: false, // allow /plugins debug: false, // allow /debug restart: true, // allow /restart + gateway restart tool ownerAllowFrom: ["discord:123456789012345678"], ownerDisplay: "raw", // raw | hash ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}", allowFrom: { "*": ["user1"], discord: ["user:123"], }, useAccessGroups: true, }, } ``` - Dit blok configureert opdrachtoppervlakken. Zie [Slash Commands](/nl/tools/slash-commands) voor de huidige ingebouwde en gebundelde opdrachtcatalogus. - Deze pagina is een **config-key-referentie**, niet de volledige opdrachtcatalogus. Kanaal-/Plugin-eigen opdrachten zoals QQ Bot `/bot-ping` `/bot-help` `/bot-logs`, LINE `/card`, device-pair `/pair`, memory `/dreaming`, phone-control `/phone` en Talk `/voice` worden gedocumenteerd op hun kanaal-/Plugin-pagina’s plus [Slash Commands](/nl/tools/slash-commands). - Tekstopdrachten moeten **zelfstandige** berichten zijn met een voorafgaande `/`. - `native: "auto"` schakelt native opdrachten in voor Discord/Telegram, en laat Slack uitgeschakeld. - `nativeSkills: "auto"` schakelt native Skills-opdrachten in voor Discord/Telegram, en laat Slack uitgeschakeld. - Overschrijven per kanaal: `channels.discord.commands.native` (bool of `"auto"`). Voor Discord slaat `false` native opdrachtregistratie en opschoning tijdens het opstarten over. - Overschrijf native Skills-registratie per kanaal met `channels..commands.nativeSkills`. - `channels.telegram.customCommands` voegt extra Telegram-botmenu-items toe. - `bash: true` schakelt `! ` in voor de host-shell. Vereist `tools.elevated.enabled` en afzender in `tools.elevated.allowFrom.`. - `config: true` schakelt `/config` in (leest/schrijft `openclaw.json`). Voor Gateway `chat.send`-clients vereisen persistente `/config set|unset`-schrijfacties ook `operator.admin`; alleen-lezen `/config show` blijft beschikbaar voor normale operatorclients met schrijfscope. - `mcp: true` schakelt `/mcp` in voor door OpenClaw beheerde MCP-serverconfiguratie onder `mcp.servers`. - `plugins: true` schakelt `/plugins` in voor Plugin-ontdekking, installatie en enable/disable-besturing. - `channels..configWrites` schermt config-mutaties per kanaal af (standaard: true). - Voor kanalen met meerdere accounts schermt `channels..accounts..configWrites` ook schrijfacties af die op dat account zijn gericht (bijvoorbeeld `/allowlist --config --account ` of `/config set channels..accounts....`). - `restart: false` schakelt `/restart` en Gateway-restarttoolacties uit. Standaard: `true`. - `ownerAllowFrom` is de expliciete owner-allowlist voor owner-only opdrachten/tools. Deze staat los van `allowFrom`. - `ownerDisplay: "hash"` hasht owner-id’s in de system prompt. Stel `ownerDisplaySecret` in om hashing te beheren. - `allowFrom` is per provider. Wanneer ingesteld, is dit de **enige** autorisatiebron (kanaal-allowlists/pairing en `useAccessGroups` worden genegeerd). - `useAccessGroups: false` staat opdrachten toe access-group-beleid te omzeilen wanneer `allowFrom` niet is ingesteld. - Overzicht van opdrachtdocumentatie: - ingebouwde en gebundelde catalogus: [Slash Commands](/nl/tools/slash-commands) - kanaalspecifieke opdrachtoppervlakken: [Kanalen](/nl/channels) - QQ Bot-opdrachten: [QQ Bot](/nl/channels/qqbot) - pairing-opdrachten: [Pairing](/nl/channels/pairing) - LINE-kaartopdracht: [LINE](/nl/channels/line) - memory dreaming: [Dreaming](/nl/concepts/dreaming) --- ## Gerelateerd - [Configuratiereferentie](/nl/gateway/configuration-reference) — top-level sleutels - [Configuratie — agents](/nl/gateway/config-agents) - [Kanalenoverzicht](/nl/channels)