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 situationRecommended
Fastest 5-minute setupTelegram
China-based users, teamsFeishu
Developer community, Discord serverDiscord
Apple devices, personal useBlueBubbles (iMessage proxy)
Overseas business, global customersWhatsApp
Corporate Slack workspaceSlack (stable)
Self-hosted, privacy-firstMatrix or Mattermost

Channel Support Matrix

🌏 China-Friendly

ChannelStatusDMGroupNotes
Feishu✅ StableBest China experience, widely used in enterprises
WeChat Official Account🔄 In Progress-Conversational public account integration
WeCom (Enterprise WeChat)🔄 PlannedEnterprise collaboration
DingTalk🔄 PlannedAlibaba ecosystem

🌍 International

ChannelStatusDMGroupNotes
Telegram✅ StableDeveloper favorite, most feature-complete
Discord✅ StableCommunities and server bots
WhatsApp✅ StableGlobal business communication
Signal✅ StableHigh-privacy use cases
BlueBubbles✅ StableiMessage relay proxy

🏢 Enterprise Collaboration

ChannelStatusDMGroupNotes
Slack✅ StableMost popular enterprise platform
Microsoft Teams✅ StableMicrosoft 365 orgs
Mattermost✅ StableOpen-source self-hosted option
Google Chat✅ StableGoogle Workspace users

🛠️ Technical / Advanced

ChannelStatusDMGroupNotes
Matrix✅ StableFully decentralized, self-hosted
IRC✅ StableClassic developer networks
Nostr🧪 ExperimentalDecentralized 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"