渠道接入

OpenClaw 支持 22+ 聊天平台同时接入同一个 Gateway。每个渠道可以独立配置访问策略、群聊行为和模型选择。

支持的渠道

渠道	协议	接入难度
Telegram	grammY Bot	最简单（一个 Token）
WhatsApp	Baileys（QR 扫码）	简单
Discord	Bot API + Gateway	中等
Slack	Bolt SDK	中等
Signal	signal-cli	中等
飞书 / Lark	Plugin	中等
iMessage	BlueBubbles	需 macOS
Google Chat	API	中等
MS Teams	Bot Framework	较复杂
其他	IRC、LINE、Matrix、Nostr、Twitch、Mattermost、Zalo 等

部分渠道（飞书、Mattermost、Matrix 等）通过插件加载，需先安装对应 plugin。

登录渠道

# 交互式登录（列出所有渠道）
openclaw channels login

# 直接指定渠道
openclaw channels login telegram
openclaw channels login whatsapp
openclaw channels login discord

# 查看渠道连接状态
openclaw channels status --probe

私聊策略（DM Policy）

每个渠道需要设置 dmPolicy，控制谁可以跟 Bot 私聊：

策略	行为
pairing	默认。新用户需输入配对码（推荐）
allowlist	只允许 allowFrom 列表中的用户
open	允许所有人（需 allowFrom: ["*"]）
disabled	禁止所有私聊

{
  channels: {
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+8613800000000", "+8613900000000"]
    },
    telegram: {
      dmPolicy: "pairing"
    }
  }
}

群聊配置

群聊默认需要 @mention 才触发回复。可通过 groupPolicy 控制：

allowlist（默认）：只在白名单群组中响应
open：所有群组都响应
disabled：不回复任何群消息

Telegram/Discord 支持按群/频道/话题粒度覆盖 systemPrompt、skills、requireMention 等。

按渠道指定模型

{
  channels: {
    modelByChannel: {
      "telegram:group:123456": "openai/gpt-4o",
      "discord:guild:789012": "anthropic/claude-opus-4"
    }
  }
}

媒体支持

WhatsApp：图片、音频、视频、文档，可配置 mediaMaxMb
Telegram：完整媒体支持，含贴纸和语音
Discord：图片、文件附件
部分渠道支持 Reaction 表情回应

渠道详细指南

点击查看每个渠道的完整接入教程：

Bot API、长轮询/Webhook、群组管理

Baileys QR 登录、多账户、媒体支持

Discord

Bot 创建、意图配置、服务器频道权限

飞书 / Lark

应用创建、WebSocket 长连接、流式输出

注意事项

生产环境务必设置 dmPolicy 为 pairing 或 allowlist
多渠道可同时运行，互不干扰
渠道 Token 使用 SecretRef 或环境变量管理，不要硬编码
WhatsApp 多账号可通过 accounts 配置

← Gateway 网关下一步：Agent 与会话 →