Configuratie — kanalen

Documentation Index

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

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

​

Kanalen

​

DM- en groepstoegang

​

Kanaalmodeloverschrijvingen

{
  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: standaard zichtbaarheidsmodus voor aanvullende context 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: gedegradeerde/foutstatussen opnemen in Heartbeat-uitvoer.
• channels.defaults.heartbeat.useIndicator: compacte indicatorstijl-Heartbeat-uitvoer 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"],
    },
  },
}

{
  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 root van de Telegram Bot API. 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 fallback-routering 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).
• Topniveau-bindings[]-items 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,
      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 fallback voor het standaardaccount.
• Directe uitgaande oproepen die een expliciet Discord-token opgeven, gebruiken dat token voor de oproep; instellingen voor accountretry/beleid komen nog steeds uit het geselecteerde account in de actieve runtime-snapshot.
• Optionele channels.discord.defaultAccount overschrijft de selectie van het standaardaccount wanneer deze overeenkomt met een geconfigureerde account-id.
• Gebruik user:<id> (DM) of channel:<id> (guildkanaal) voor afleverdoelen; kale numerieke ID’s worden geweigerd.
• Guild-slugs zijn kleine letters waarbij spaties door - zijn vervangen; 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 worden nog steeds 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 voordat wordt verzonden, zodat bekende teamgenoten deterministisch kunnen worden vermeld, zelfs wanneer de tijdelijke directorycache 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.threadBindings beheert Discord-routering gebonden aan threads:
  • enabled: Discord-overschrijving voor sessiefuncties gebonden aan threads (/focus, /unfocus, /agents, /session idle, /session max-age, en gebonden aflevering/routering)
  • idleHours: Discord-overschrijving voor automatisch unfocusen 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 bij ACP-thread-spawn (standaard: true)
  • defaultSpawnContext: native subagentcontext voor thread-gebonden 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 ervoor 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 @discordjs/voice Ready-wachttijd voor /vc join en auto-joinpogingen (standaard 30000).
• channels.discord.voice.reconnectGraceMs beheert hoe lang een verbroken spraaksessie mag doen over het bereiken van reconnect-signalering voordat OpenClaw deze vernietigt (standaard 15000).
• Discord-spraakweergave wordt niet onderbroken door een speaking-start-gebeurtenis van een andere gebruiker. Om feedbacklussen te voorkomen, 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 streammodussleutel. Discord gebruikt standaard streaming.mode: "progress" zodat tool-/werkvoortgang verschijnt in één bewerkt voorbeeldbericht; 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 opgeslagen configuratie te herschrijven.
• channels.discord.autoPresence koppelt runtime-beschikbaarheid aan botaanwezigheid (healthy => online, degraded => idle, exhausted => dnd) en staat optionele overschrijvingen van statustekst toe.
• channels.discord.dangerouslyAllowNameMatching schakelt veranderlijke naam-/tagmatching opnieuw in (compatibiliteitsmodus voor noodgevallen).
• channels.discord.execApprovals: Discord-native aflevering van exec-goedkeuringen en autorisatie van goedkeurders.
  • enabled: true, false of "auto" (standaard). In automatische modus worden exec-goedkeuringen geactiveerd wanneer goedkeurders kunnen worden bepaald 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 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 target "channel" bevat, zijn knoppen alleen bruikbaar door bepaalde 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 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 afleverdoelen.
• channels.googlechat.dangerouslyAllowNameMatching schakelt veranderlijke matching van e-mailprincipals opnieuw in (compatibiliteitsmodus voor noodgevallen).

​

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 mode 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 voor Slack SDK Socket Mode door aan de openbare Bolt receiver-API. Gebruik dit alleen bij onderzoek naar ping-/pong-timeouts of verouderd websocketgedrag.
• botToken, appToken, signingSecret en userToken accepteren plaintext strings of SecretRef-objecten.
• Slack-accountsnapshots tonen bron-/statusvelden per credential, 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 secretwaarde niet kon oplossen.
• configWrites: false blokkeert configuratieschrijfbewerkingen die door Slack zijn gestart.
• Optionele channels.slack.defaultAccount overschrijft de selectie van het standaardaccount wanneer deze overeenkomt met een geconfigureerde account-id.
• channels.slack.streaming.mode is de canonieke Slack-streammodussleutel. channels.slack.streaming.nativeTransport beheert het native streamingtransport van Slack. Legacy streamMode-, booleaanse streaming- en nativeStreaming-waarden blijven runtime-aliassen; voer openclaw doctor --fix uit om opgeslagen configuratie te herschrijven.
• unfurlLinks en unfurlMedia geven Slack’s booleans voor het uitvouwen van links en media in chat.postMessage door voor botantwoorden. Laat ze weg om Slack’s 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 afleverdoelen.

• Slack native streaming plus de Slack-assistentstijl-threadstatus “is typing…” vereisen een doel voor de antwoordthread. Top-level DM’s blijven standaard buiten threads, zodat ze nog steeds kunnen streamen via Slack-conceptberichten met posten-en-bewerken-voorbeelden 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 vervolgens bij voltooiing. Gebruik een Slack-emoji-shortcode zoals "hourglass_flowing_sand".
• channels.slack.execApprovals: Slack-native aflevering 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 worden omgezet naar het OpenClaw Gateway-eindpunt en bereikbaar zijn vanaf de Mattermost-server.
• Native slash-callbacks worden geverifieerd met de per-opdracht-tokens die Mattermost retourneert tijdens de registratie van slash-opdrachten. Als registratie mislukt of er geen opdrachten worden geactiveerd, wijst OpenClaw callbacks af met Unauthorized: invalid command token.
• Voor private/tailnet/interne callback-hosts kan Mattermost vereisen dat ServiceSettings.AllowedUntrustedInternalConnections de callback-host/het callback-domein bevat. Gebruik host-/domeinwaarden, geen volledige URL’s.
• channels.mattermost.configWrites: configuratieschrijfacties geïnitieerd door Mattermost toestaan of weigeren.
• channels.mattermost.requireMention: @mention vereisen voordat in kanalen wordt geantwoord.
• channels.mattermost.groups.<channelId>.requireMention: override per kanaal voor vermelding-gating ("*" voor standaard).
• Optioneel overschrijft channels.mattermost.defaultAccount 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: zet het opstarten van het kanaal vast op een specifieke Signal-accountidentiteit.
• channels.signal.configWrites: configuratieschrijfacties geïnitieerd door Signal toestaan of weigeren.
• Optioneel overschrijft channels.signal.defaultAccount 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",
      region: "US",
    },
  },
}

• Optioneel overschrijft channels.imessage.defaultAccount de standaardaccountselectie wanneer dit overeenkomt met een geconfigureerde account-id.
• Vereist volledige schijftoegang tot de Messages-database.
• 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 binnenkomende bijlagepaden (standaard: /Users/*/Library/Messages/Attachments).
• SCP gebruikt strikte host-key-controle, dus zorg ervoor dat de sleutel van de relay-host al bestaat in ~/.ssh/known_hosts.
• channels.imessage.configWrites: configuratieschrijfacties geïnitieerd door iMessage toestaan of weigeren.
• Toplevel bindings[]-items 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",
        },
      },
    },
  },
}

• Tokenverificatie gebruikt accessToken; wachtwoordverificatie 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 netwerk-opt-in zijn onafhankelijke instellingen.
• channels.matrix.defaultAccount selecteert het voorkeursaccount in configuraties met meerdere accounts.
• channels.matrix.autoJoin is standaard 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 opgelost uit approvers of commands.ownerAllowFrom.
  • approvers: Matrix-gebruikers-ID’s (bijv. @owner:example.org) die exec-verzoeken 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".
  • 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 op basis van gerouteerde peer, terwijl per-room elke DM-room isoleert.
• Matrix-statusprobes en live directory-lookups gebruiken hetzelfde proxybeleid als runtimeverkeer.
• 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
    },
  },
}

• Belangrijkste kernpaden die hier worden behandeld: channels.msteams, channels.msteams.configWrites.
• Volledige Teams-configuratie (referenties, 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 dit overeenkomt met een geconfigureerde account-id.
• Volledige IRC-kanaalconfiguratie (host/poort/TLS/kanalen/allowlists/vermelding-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 wordt weggelaten (CLI + routering).
• Omgevingstokens 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 via openclaw channels add (of kanaalonboarding) een niet-standaardaccount toevoegt terwijl je nog een kanaalconfiguratie met één toplevel-account gebruikt, promoveert OpenClaw eerst account-scoped toplevel-waarden voor één account naar de kanaalaccountmap, 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 kanaal-only bindings (zonder accountId) blijven overeenkomen met het standaardaccount; account-scoped bindings blijven optioneel.
• openclaw doctor --fix repareert ook gemengde vormen door account-scoped toplevel-waarden voor één account 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

​

Vermelding-gating in groepschats

• Metadatavermeldingen: Native platform-@-vermeldingen. Genegeerd in de zelfchatmodus van WhatsApp.
• 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 een 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"] } }],
  },
}

​

Geschiedenislimieten voor DM’s

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

​

Zelfchatmodus

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