Gateway
Configuration — channels
Per-channel configuration keys under channels.*: DM and group access, multi-account setups, mention gating, and per-channel keys for Slack, Discord, Telegram, WhatsApp, Matrix, iMessage, and other 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 enabled: false). Telegram ships inside the core openclaw package. Other official channels (iMessage, Discord, Slack, WhatsApp, Matrix, Microsoft Teams, IRC, Google Chat, Signal, Mattermost, and more) install as separate plugins with openclaw plugins install <spec>; see Channels for the full list and install specs.
Other plugin channels
Many plugin channels are configured as channels.<id> and documented in their dedicated channel pages (for example Feishu, Nextcloud Talk, Nostr, QQ Bot, Synology Chat, Twitch, and Zalo).
See the full channel index: Channels.
What each page covers
- Configuration — shared channel policies — DM and group access policies,
channels.modelByChannel,channels.defaults, heartbeat visibility, and the shared multi-account pattern. - Configuration — personal messaging channels —
channels.*keys for WhatsApp, Telegram, Signal, iMessage, and LINE. - Configuration — workplace chat channels —
channels.*keys for Google Chat, Slack, Mattermost, and Microsoft Teams. - Configuration — community chat channels —
channels.*keys for Discord, Matrix, and IRC. - Configuration — group mention gating and history — mention gating, visible reply modes, DM history limits, and self-chat mode.
- Configuration — chat commands — the
commands.*block: command surfaces, bash and config gating, and owner allowlists.
Where each section moved
Every heading this page used to publish keeps its anchor here, so an existing
link such as /gateway/config-channels#imessage still resolves. Each entry
points at the page that now holds the content.
- DM and group access
- Channel model overrides
- Channel defaults and heartbeat
- Multi-account (all channels)
- Multi-account WhatsApp
- Telegram
- Signal
- iMessage
- iMessage SSH wrapper example
- LINE
- Google Chat
- Slack
- Mattermost
- Microsoft Teams
- Discord
- Matrix
- IRC
- Group chat mention gating
- DM history limits
- Self-chat mode
- Commands (chat command handling)
- Command details
Related
- Configuration reference — top-level keys
- Configuration — agents
- Channels overview
