Skip to content

渠道总览

OpenClaw 可以接入你日常使用的各种聊天 App。每个渠道都通过 Gateway 连接。 所有渠道均支持文本消息;媒体和表情回应的支持情况因渠道而异。

支持的渠道

渠道状态安装方式
WhatsApp✅ 生产就绪内置
Telegram✅ 生产就绪内置
Discord✅ 生产就绪内置
Slack✅ 生产就绪内置
飞书 / Lark✅ 生产就绪插件
Signal✅ 生产就绪内置
iMessage(via BlueBubbles)✅ 生产就绪插件
其他渠道各异插件

各渠道特点速览

快速接入首选:Telegram

Telegram 是最简单的接入方式:只需一个 Bot Token,不需要 QR 扫码。 适合第一次尝试 OpenClaw 的用户。

最广泛的用户基础:WhatsApp

WhatsApp 需要扫 QR 码配对,在磁盘上存储会话状态。 OpenClaw 推荐为 Bot 使用单独的手机号,避免与个人账号混用。

开发者友好:Discord

Discord 通过官方 Bot API 连接,支持服务器频道和私信。 适合技术用户和开发团队。

企业场景:Slack

Slack 通过 Socket Mode(默认)或 HTTP Events API 接入。 适合企业工作区。

中国企业用户:飞书

飞书(Lark) 通过 WebSocket 长连接接收消息,无需公开 Webhook URL。 需要单独安装插件:openclaw plugins install @openclaw/feishu

通用访问控制

所有渠道共用相同的私信访问策略(dmPolicy):

策略值行为
"pairing"(默认)未知发送者收到配对码,需审批
"allowlist"只允许 allowFrom 中的用户
"open"允许所有人(需设 allowFrom: ["*"]
"disabled"忽略所有私信

多渠道同时运行

多个渠道可以同时运行,OpenClaw 根据来源路由消息:

json5
{
  channels: {
    whatsapp: { allowFrom: ["+15555550123"] },
    telegram: {
      enabled: true,
      botToken: "YOUR_TOKEN",
      allowFrom: ["123456789"],
    },
    discord: {
      enabled: true,
      token: "YOUR_TOKEN",
      dm: { allowFrom: ["123456789012345678"] },
    },
  },
}

群组行为

群聊行为因渠道而异。默认情况下,群组消息需要 @mention Bot 才会响应。

配置全局群组 mention 要求:

json5
{
  channels: {
    telegram: {
      groups: { "*": { requireMention: true } },
    },
  },
}

详情参见各渠道文档。