Configuratie — kanalen

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Kanalen

​

DM- en groepstoegang

​

Modeloverschrijvingen per kanaal

{
  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

{
  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.<channel>.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

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

{
  channels: {
    whatsapp: {
      accounts: {
        default: {},
        personal: {},
        biz: {
          // authDir: "~/.openclaw/credentials/whatsapp/biz",
        },
      },
    },
  },
}

​

Telegram

{
  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<TOKEN>; openclaw doctor --fix verwijdert een onbedoeld achtervoegsel /bot<TOKEN>.
• 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.
• Telegram-streamvoorbeelden gebruiken sendMessage + editMessageText (werkt in directe en groepschats).
• Retrybeleid: zie Retrybeleid.

​

Discord

{
  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:<id> (DM) of channel:<id> (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.<id>.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.<accountId>.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.
• 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.

​

Google Chat

{
  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/<spaceId> of users/<userId> voor bezorgdoelen.
• channels.googlechat.dangerouslyAllowNameMatching schakelt veranderlijke matching van e-mailprincipals opnieuw in (break-glass-compatibiliteitsmodus).

​

Slack

{
  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.<accountId> om de top-level standaard voor één account te overschrijven.
• Gebruik user:<id> (DM) of channel:<id> voor bezorgdoelen.

• 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").

​

Mattermost

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

• 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.<channelId>.requireMention: override voor vermeldingspoort per kanaal ("*" voor standaard).
• Optioneel overschrijft channels.mattermost.defaultAccount de standaardaccountselectie wanneer deze overeenkomt met een geconfigureerde account-id.

​

Signal

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

• 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

{
  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:<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.

#!/usr/bin/env bash
exec ssh -T gateway-host imsg "$@"

​

Matrix

{
  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.<id>.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.<id>.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.

​

Microsoft Teams

{
  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.

​

IRC

{
  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.

​

Meerdere accounts (alle kanalen)

{
  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 standaardaccount.
• 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.<channel>.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

​

Vermeldingspoort voor groepschats

• 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).

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

​

DM-geschiedenislimaieten

{
  channels: {
    telegram: {
      dmHistoryLimit: 30,
      dms: {
        "123456789": { historyLimit: 50 },
      },
    },
  },
}

​

Self-chat-modus

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: { mentionPatterns: ["reisponde", "@openclaw"] },
      },
    ],
  },
}

​

Opdrachten (afhandeling van chatopdrachten)

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

​

Gerelateerd

• Configuratiereferentie — top-level sleutels
• Configuratie — agents
• Kanalenoverzicht