Configuration — channels

Per-channel configuration keys under

. Covers DM and group access, multi-account setups, mention gating, and per-channel keys for Slack, Discord, Telegram, WhatsApp, Matrix, iMessage, and the other bundled channel plugins.

For agents, tools, gateway runtime, and other top-level keys, see Configuration reference.

Channels

Each channel starts automatically when its config section exists (unless

).

DM and group access

All channels support DM policies and group policies:

Channel model overrides

Use

to pin specific channel IDs to a model. Values accept or configured model aliases. The channel mapping applies when a session does not already have a model override (for example, set via ).

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

Channel defaults and heartbeat

Use

for shared group-policy and heartbeat behavior across providers:

json5
Copy
{
  channels: {
    defaults: {
      groupPolicy: "allowlist", // open | allowlist | disabled
      contextVisibility: "all", // all | allowlist | allowlist_quote
      heartbeat: {
        showOk: false,
        showAlerts: true,
        useIndicator: true,
      },
    },
  },
}

• text

  Copy

  channels.defaults.groupPolicy
  : fallback group policy when a provider-level
  text

  Copy

  groupPolicy
  is unset.
• text

  Copy

  channels.defaults.contextVisibility
  : default supplemental context visibility mode for all channels. Values:
  text

  Copy

  all
  (default, include all quoted/thread/history context),
  text

  Copy

  allowlist
  (only include context from allowlisted senders),
  text

  Copy

  allowlist_quote
  (same as allowlist but keep explicit quote/reply context). Per-channel override:
  text

  Copy

  channels.<channel>.contextVisibility
  .
• text

  Copy

  channels.defaults.heartbeat.showOk
  : include healthy channel statuses in heartbeat output.
• text

  Copy

  channels.defaults.heartbeat.showAlerts
  : include degraded/error statuses in heartbeat output.
• text

  Copy

  channels.defaults.heartbeat.useIndicator
  : render compact indicator-style heartbeat output.

WhatsApp

WhatsApp runs through the gateway's web channel (Baileys Web). It starts automatically when a linked session exists.

json5
Copy
{
  web: {
    whatsapp: {
      keepAliveIntervalMs: 25000,
      connectTimeoutMs: 60000,
      defaultQueryTimeoutMs: 60000,
    },
  },
  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"],
    },
  },
  web: {
    enabled: true,
    heartbeatSeconds: 60,
    reconnect: {
      initialMs: 2000,
      maxMs: 120000,
      factor: 1.4,
      jitter: 0.2,
      maxAttempts: 0,
    },
  },
}