Overview
Connect OpenClaw to multiple chat platforms and interact with your AI agent from anywhere — all managed through a single Gateway.
How to Choose a Channel
| Your situation | Recommended |
|---|---|
| Fastest 5-minute setup | Telegram |
| China-based users, teams | Feishu |
| Developer community, Discord server | Discord |
| Apple devices, personal use | BlueBubbles (iMessage proxy) |
| Overseas business, global customers | |
| Corporate Slack workspace | Slack (stable) |
| Self-hosted, privacy-first | Matrix or Mattermost |
Channel Support Matrix
🌏 China-Friendly
| Channel | Status | DM | Group | Notes |
|---|---|---|---|---|
| Feishu | ✅ Stable | ✅ | ✅ | Best China experience, widely used in enterprises |
| WeChat Official Account | 🔄 In Progress | ✅ | - | Conversational public account integration |
| WeCom (Enterprise WeChat) | 🔄 Planned | ✅ | ✅ | Enterprise collaboration |
| DingTalk | 🔄 Planned | ✅ | ✅ | Alibaba ecosystem |
🌍 International
| Channel | Status | DM | Group | Notes |
|---|---|---|---|---|
| Telegram | ✅ Stable | ✅ | ✅ | Developer favorite, most feature-complete |
| Discord | ✅ Stable | ✅ | ✅ | Communities and server bots |
| ✅ Stable | ✅ | ✅ | Global business communication | |
| Signal | ✅ Stable | ✅ | ✅ | High-privacy use cases |
| BlueBubbles | ✅ Stable | ✅ | ✅ | iMessage relay proxy |
🏢 Enterprise Collaboration
| Channel | Status | DM | Group | Notes |
|---|---|---|---|---|
| Slack | ✅ Stable | ✅ | ✅ | Most popular enterprise platform |
| Microsoft Teams | ✅ Stable | ✅ | ✅ | Microsoft 365 orgs |
| Mattermost | ✅ Stable | ✅ | ✅ | Open-source self-hosted option |
| Google Chat | ✅ Stable | ✅ | ✅ | Google Workspace users |
🛠️ Technical / Advanced
| Channel | Status | DM | Group | Notes |
|---|---|---|---|---|
| Matrix | ✅ Stable | ✅ | ✅ | Fully decentralized, self-hosted |
| IRC | ✅ Stable | ✅ | ✅ | Classic developer networks |
| Nostr | 🧪 Experimental | ✅ | ✅ | Decentralized protocol |
| Twitch | 🧪 Experimental | - | ✅ | Livestream chat bot |
Multi-Channel Config Example
{
channels: {
telegram: { enabled: true, botToken: "xxx" },
discord: { enabled: true, token: "xxx" },
whatsapp: { dmPolicy: "pairing", allowFrom: ["+1xxxxxxxxxx"] },
},
}
Pairing Mechanism
OpenClaw uses dmPolicy: "pairing" to control who can message your bot:
# View pending pairing requests
openclaw pairing list telegram
# Approve a pairing
openclaw pairing approve telegram <code>
Only paired users can interact with the bot, preventing unauthorized access.
Group Chat Behavior
In group chats, the bot only replies when mentioned by default. Control this with requireMention:
{
channels: {
telegram: {
groups: {
"*": { requireMention: true },
},
},
},
}
Troubleshooting
Check the Gateway logs when a channel isn't connecting:
openclaw logs --follow
Common issues:
- No DM replies: Check bot token and gateway status
- No group replies: Bot needs to be @mentioned, or disable privacy mode
- Network issues: Configure a proxy:
proxy: "socks5://127.0.0.1:7890"