Configuratie — kanalen

​

Kanalen

​

DM- en groepstoegang

​

Kanaalmodel-overschrijvingen

{
  channels: {
    modelByChannel: {
      discord: {
        "123456789012345678": "anthropic/claude-opus-4-6",
      },
      slack: {
        C1234567890: "openai/gpt-5.5",
        "user:U12345": "openai/gpt-5.4-mini",
      },
      telegram: {
        "-1001234567890": "openai/gpt-5.4-mini",
        "-1001234567890:topic:99": "anthropic/claude-sonnet-4-6",
        "123456789": "openai/gpt-4.1",
      },
    },
  },
}

​

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 op van afzenders op de allowlist), allowlist_quote (hetzelfde als allowlist, maar behoud expliciete citaat-/antwoordcontext). Overschrijving per kanaal: channels.<channel>.contextVisibility.
• channels.defaults.heartbeat.showOk: gezonde kanaalstatussen opnemen in Heartbeat-uitvoer.
• channels.defaults.heartbeat.showAlerts: verslechterde/foutstatussen opnemen in Heartbeat-uitvoer.
• channels.defaults.heartbeat.useIndicator: compacte Heartbeat-uitvoer in indicatorstijl renderen.

​

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

• Items in bindings[] op topniveau met type: "acp" configureren persistente ACP-bindingen voor WhatsApp-DM’s en groepen. Gebruik een rechtstreeks E.164-nummer of WhatsApp-groep-JID in match.peer.id. Veldsemantiek wordt gedeeld in ACP-agents.

{
  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: partial)
      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 normaal 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 per ongeluk toegevoegde afsluitende /bot<TOKEN>-suffix.
• Optioneel 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 fallbackrouting te vermijden; openclaw doctor waarschuwt wanneer dit ontbreekt of ongeldig is.
• configWrites: false blokkeert door Telegram geïnitieerde configuratieschrijfacties (supergroep-ID-migraties, /config set|unset).
• Items in bindings[] op topniveau met type: "acp" configureren persistente ACP-bindingen voor forumonderwerpen (gebruik canonieke chatId:topic:topicId in match.peer.id). Veldsemantiek wordt gedeeld in ACP-agents.
• 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,
      suppressEmbeds: true,
      chunkMode: "length", // length | newline
      streaming: {
        mode: "progress", // off | partial | block | progress (Discord default: progress)
        progress: {
          label: "auto",
          maxLines: 8,
          maxLineChars: 120,
          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 fallback voor het standaardaccount.
• Rechtstreekse uitgaande aanroepen die een expliciete Discord-token opgeven, gebruiken die token voor de aanroep; retry-/beleidsinstellingen voor accounts 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 waarbij spaties zijn vervangen door -; kanaalsleutels gebruiken de geslugde naam (geen #). Geef de voorkeur aan guild-ID’s.
• Berichten die door bots zijn geschreven, worden standaard genegeerd. allowBots: true schakelt ze in; gebruik allowBots: "mentions" om alleen botberichten te accepteren die de bot vermelden (eigen berichten blijven gefilterd).
• Kanalen die inkomende berichten van bots ondersteunen, kunnen gedeelde bot-lusbescherming gebruiken. Stel channels.defaults.botLoopProtection in voor basisbudgetten per paar, en overschrijf daarna alleen het kanaal of account wanneer één oppervlak andere limieten nodig heeft.
• 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 wijst stabiele uitgaande @handle-tekst toe aan Discord-gebruikers-ID’s vóór verzending, zodat bekende teamgenoten deterministisch kunnen worden vermeld, zelfs wanneer de tijdelijke directory-cache leeg is. Overschrijvingen per account staan onder channels.discord.accounts.<accountId>.mentionAliases.
• maxLinesPerMessage (standaard 17) splitst hoge berichten, zelfs wanneer ze minder dan 2000 tekens bevatten.
• channels.discord.suppressEmbeds is standaard true, zodat uitgaande URL’s niet uitklappen tot Discord-linkvoorbeelden tenzij dit is uitgeschakeld. Expliciete embeds-payloads worden nog steeds normaal verzonden; toolaanroepen per bericht kunnen dit overschrijven met suppressEmbeds.
• 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 subagent-context voor threadgebonden spawns (standaard "fork")
• Top-level bindings[]-vermeldingen met type: "acp" configureren persistente 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.agentComponents.ttlMs bepaalt hoelang verzonden Discord-componentcallbacks geregistreerd blijven. De standaardwaarde is 1800000 (30 minuten), het maximum is 86400000 (24 uur), en overschrijvingen per account staan onder channels.discord.accounts.<accountId>.agentComponents.ttlMs. Langere waarden houden oude knoppen/selecties/formulieren langer bruikbaar, dus geef de voorkeur aan de kortste TTL die bij de workflow past.
• channels.discord.voice schakelt gesprekken in Discord-spraakkanalen en optionele auto-join + LLM + TTS-overschrijvingen in. Tekst-only Discord-configuraties laten spraak standaard uit; stel channels.discord.voice.enabled=true in om hiervoor te kiezen.
• 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 Ready-wachttijd van @discordjs/voice voor /vc join en auto-joinpogingen (standaard 30000).
• channels.discord.voice.reconnectGraceMs bepaalt hoelang een losgekoppelde spraaksessie mag nemen om reconnect-signalering te starten voordat OpenClaw deze vernietigt (standaard 15000).
• Discord-spraakweergave wordt niet onderbroken door een speaking-start-event van een andere gebruiker. Om feedbacklussen te vermijden, negeert OpenClaw nieuwe spraakopname terwijl TTS afspeelt.
• 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 tool-/werkvoortgang in één bewerkt voorbeeldbericht verschijnt; stel streaming.mode: "off" in om dit uit te schakelen. Legacy streamMode- en booleaanse streaming-waarden blijven runtime-aliassen; voer openclaw doctor --fix uit om persistente configuratie te herschrijven.
• channels.discord.autoPresence wijst runtime-beschikbaarheid toe aan bot-aanwezigheid (healthy => online, degraded => idle, exhausted => dnd) en staat optionele overschrijvingen voor statustekst toe.
• channels.discord.dangerouslyAllowNameMatching schakelt wijzigbare naam-/tagmatching opnieuw in (noodcompatibiliteitsmodus).
• channels.discord.execApprovals: Discord-native bezorging van exec-goedkeuringen en autorisatie van goedkeurders.
  • enabled: true, false of "auto" (standaard). In automatische modus worden exec-goedkeuringen geactiveerd wanneer goedkeurders kunnen worden opgelost uit approvers of commands.ownerAllowFrom.
  • approvers: Discord-gebruikers-ID’s die exec-aanvragen mogen goedkeuren. Valt terug op commands.ownerAllowFrom wanneer weggelaten.
  • agentFilter: optionele allowlist met agent-ID’s. Laat weg om goedkeuringen voor alle agents door te sturen.
  • sessionFilter: optionele sessiesleutelpatronen (substring of regex).
  • target: waar goedkeuringsprompts naartoe worden verzonden. "dm" (standaard) verzendt naar DM’s van goedkeurders, "channel" verzendt naar het oorspronkelijke kanaal, "both" verzendt naar beide. Wanneer target "channel" bevat, zijn knoppen alleen bruikbaar door opgeloste goedkeurders.
  • cleanupAfterResolve: wanneer true, worden goedkeurings-DM’s verwijderd 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 op bestanden gebaseerd (serviceAccountFile).
• Serviceaccount SecretRef wordt ook ondersteund (serviceAccountRef).
• Env-fallbacks: GOOGLE_CHAT_SERVICE_ACCOUNT of GOOGLE_CHAT_SERVICE_ACCOUNT_FILE.
• Gebruik spaces/<spaceId> of users/<userId> voor bezorgdoelen.
• channels.googlechat.dangerouslyAllowNameMatching schakelt wijzigbare e-mail-principalmatching opnieuw in (noodcompatibiliteitsmodus).

​

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

• Socket-modus vereist zowel botToken als appToken (SLACK_BOT_TOKEN + SLACK_APP_TOKEN voor env-fallback van het standaardaccount).
• HTTP-modus vereist botToken plus signingSecret (op rootniveau of per account).
• socketMode geeft transportafstemming van de Slack SDK Socket Mode door aan de openbare Bolt receiver-API. Gebruik dit alleen bij onderzoek naar ping/pong-time-outs of verouderd websocketgedrag. clientPingTimeout is standaard 15000; serverPingTimeout en pingPongLoggingEnabled worden alleen doorgegeven wanneer ze zijn geconfigureerd.
• botToken, appToken, signingSecret en userToken accepteren plattetekst- strings of SecretRef-objecten.
• Slack-accountsnapshots tonen bron-/statusvelden per referentie, zoals botTokenSource, botTokenStatus, appTokenStatus en, in HTTP-modus, signingSecretStatus. configured_unavailable betekent dat het account is geconfigureerd via SecretRef, maar dat het huidige opdracht-/runtimepad de geheime waarde niet kon oplossen.
• configWrites: false blokkeert door Slack geïnitieerde configuratieschrijfacties.
• Optioneel channels.slack.defaultAccount overschrijft de standaardaccountselectie wanneer dit overeenkomt met een geconfigureerde account-id.
• channels.slack.streaming.mode is de canonieke Slack-streammodussleutel. channels.slack.streaming.nativeTransport beheert Slacks native streamingtransport. Legacywaarden streamMode, booleaanse streaming en nativeStreaming blijven runtime-aliassen; voer openclaw doctor --fix uit om opgeslagen configuratie te herschrijven.
• unfurlLinks en unfurlMedia geven Slacks chat.postMessage-booleans voor link- en media-unfurling door voor botantwoorden. unfurlLinks is standaard false, zodat uitgaande botlinks niet inline uitklappen tenzij dit is ingeschakeld; unfurlMedia wordt weggelaten tenzij geconfigureerd. Stel een van beide waarden in op channels.slack.accounts.<accountId> om de waarde op topniveau voor één account te overschrijven.
• Gebruik user:<id> (DM) of channel:<id> voor afleverdoelen.

• Slack native streaming plus de Slack-assistentstijl-threadstatus “is typing…” vereisen een antwoordthreaddoel. DM’s op topniveau blijven standaard buiten threads, zodat ze nog steeds kunnen streamen via Slacks conceptbericht-en-bewerkvoorbeelden in plaats van de threadstijl 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 levering van goedkeuringsclients en autorisatie van exec-goedkeurders. Hetzelfde schema als Discord: enabled (true/false/"auto"), approvers (Slack-gebruikers-ID’s), agentFilter, sessionFilter en target ("dm", "channel" of "both"). Plugin-goedkeuringen kunnen dit native-clientpad gebruiken voor verzoeken die uit Slack afkomstig zijn wanneer Slack Plugin-goedkeurders worden opgelost; Slack-native Plugin-goedkeuringslevering kan ook worden ingeschakeld via approvals.plugin voor sessies die uit Slack afkomstig zijn of Slack-doelen. Plugin-goedkeuringen gebruiken Slack Plugin-goedkeurders uit allowFrom en standaardroutering, niet exec-goedkeurders.

​

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 geauthenticeerd met de tokens per opdracht die door Mattermost worden geretourneerd tijdens slash-opdrachtregistratie. Als registratie mislukt of er geen opdrachten zijn geactiveerd, weigert OpenClaw callbacks met Unauthorized: invalid command token.
• Voor privé-/tailnet-/interne callbackhosts kan Mattermost vereisen dat ServiceSettings.AllowedUntrustedInternalConnections de callbackhost/het callbackdomein bevat. Gebruik host-/domeinwaarden, geen volledige URL’s.
• channels.mattermost.configWrites: door Mattermost geïnitieerde configuratieschrijfacties toestaan of weigeren.
• channels.mattermost.requireMention: @mention vereisen voordat in kanalen wordt gereageerd.
• channels.mattermost.groups.<channelId>.requireMention: overschrijving per kanaal voor vermeldingscontrole ("*" voor standaard).
• Optioneel channels.mattermost.defaultAccount overschrijft de standaardaccountselectie wanneer dit 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: kanaalstart vastzetten op een specifieke Signal-accountidentiteit.
• channels.signal.configWrites: door Signal geïnitieerde configuratieschrijfacties toestaan of weigeren.
• Optioneel channels.signal.defaultAccount overschrijft de standaardaccountselectie wanneer dit 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",
      sendTransport: "auto",
      region: "US",
      actions: {
        reactions: true,
        edit: true,
        unsend: true,
        reply: true,
        sendWithEffect: true,
        sendAttachment: true,
      },
    },
  },
}

• Optioneel channels.imessage.defaultAccount overschrijft de standaardaccountselectie wanneer dit 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 verwijzen; 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 host-keycontrole, zorg er dus voor dat de relay-hostsleutel al bestaat in ~/.ssh/known_hosts.
• channels.imessage.configWrites: door iMessage geïnitieerde configuratieschrijfacties toestaan of weigeren.
• channels.imessage.sendTransport: voorkeurs-imsg RPC-verzendtransport voor normale uitgaande antwoorden. auto (standaard) gebruikt de IMCore-bridge voor bestaande chats wanneer die draait, en valt daarna terug op AppleScript; bridge vereist private-API-levering; applescript forceert het openbare Messages-automatiseringspad.
• channels.imessage.actions.*: private API-acties inschakelen die ook worden begrensd door imsg status / openclaw channels status --probe.
• channels.imessage.includeAttachments staat standaard uit; stel dit in op true voordat u inkomende media in agentbeurten verwacht.
• Inkomend herstel na een bridge-/Gateway-herstart is automatisch (GUID-deduplicatie plus een leeftijdsgrens voor verouderde backlog). Bestaande channels.imessage.catchup.enabled: true-configuraties worden nog steeds gerespecteerd als verouderd compatibiliteitsprofiel.
• channels.imessage.groups: groepsregister en instellingen per groep. Met groupPolicy: "allowlist" configureert u expliciete chat_id-sleutels of een "*"-wildcardvermelding zodat groepsberichten de registerpoort kunnen passeren.
• Topniveau-bindings[]-vermeldingen met type: "acp" kunnen iMessage-gesprekken koppelen aan persistente ACP-sessies. Gebruik een genormaliseerde handle of expliciet chatdoel (chat_id:*, chat_guid:*, chat_identifier:*) in match.peer.id. Gedeelde veldsemantiek: ACP Agents.

#!/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 configuraties met meerdere accounts.
• channels.matrix.autoJoin staat standaard op off, dus uitgenodigde rooms 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 automatische modus worden exec-goedkeuringen geactiveerd wanneer goedkeurders kunnen worden afgeleid uit approvers of commands.ownerAllowFrom.
  • approvers: Matrix-gebruikers-ID’s (bijv. @owner:example.org) die exec-aanvragen mogen goedkeuren.
  • agentFilter: optionele allowlist met agent-ID’s. Laat weg om goedkeuringen voor alle agents door te sturen.
  • sessionFilter: optionele sessiesleutelpatronen (substring of regex).
  • target: waar goedkeuringsprompts naartoe worden gestuurd. "dm" (standaard), "channel" (oorspronkelijke room) of "both".
  • Overschrijvingen 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-room isoleert.
• Matrix-statusprobes en live directory-lookups gebruiken hetzelfde proxybeleid als runtimeverkeer.
• De volledige Matrix-configuratie, targetingregels en installatievoorbeelden zijn gedocumenteerd in Matrix.

​

Microsoft Teams

{
  channels: {
    msteams: {
      enabled: true,
      configWrites: true,
      // appId, appPassword, tenantId, webhook, team/channel policies:
      // see /channels/msteams
    },
  },
}

• Kernsleutelpaden die hier worden behandeld: channels.msteams, channels.msteams.configWrites.
• De volledige Teams-configuratie (referenties, webhook, DM-/groepsbeleid, overschrijvingen 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",
      },
    },
  },
}

• Kernsleutelpaden die hier worden behandeld: channels.irc, channels.irc.dmPolicy, channels.irc.configWrites, channels.irc.nickserv.*.
• Optionele channels.irc.defaultAccount overschrijft de standaard accountselectie wanneer deze overeenkomt met een geconfigureerde account-ID.
• De volledige IRC-kanaalconfiguratie (host/poort/TLS/kanalen/allowlists/mention-gating) 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).
• Omgevingstokens gelden alleen voor 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 enkelaccount-configuratie op kanaaltopniveau gebruikt, promoveert OpenClaw eerst accountspecifieke enkelaccountwaarden op topniveau 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 kanaalgebonden bindings (zonder accountId) blijven overeenkomen met het standaardaccount; accountspecifieke bindings blijven optioneel.
• openclaw doctor --fix repareert ook gemengde vormen door accountspecifieke enkelaccountwaarden op topniveau 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

​

Mention-gating voor groepschats

• Metadata-mentions: Native platform-@mentions. Genegeerd in WhatsApp self-chatmodus.
• Tekstpatronen: Veilige regex-patronen in agents.list[].groupChat.mentionPatterns. Ongeldige patronen en onveilige geneste herhaling worden genegeerd.
• Mention-gating wordt alleen afgedwongen wanneer detectie mogelijk is (native mentions of ten minste één patroon).

{
  messages: {
    visibleReplies: "automatic", // force old automatic final replies for direct/source chats
    groupChat: {
      historyLimit: 50,
      unmentionedInbound: "room_event", // always-on unmentioned room chatter becomes quiet context
      visibleReplies: "message_tool", // opt-in; require message(action=send) for visible room replies
    },
  },
  agents: {
    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],
  },
}

​

DM-geschiedenislimieten

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

​

Self-chatmodus

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

​

Commando’s (afhandeling van chatcommando’s)

{
  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 — sleutels op topniveau
• Configuratie — agents
• Kanaaloverzicht