Channels Overview

OpenClaw 可以连接到你已经使用的任何聊天应用。每个 Channel 通过 Gateway 连接。

支持的 Channel

Channel	状态	安装方式
Discord	生产就绪	内置
Feishu/Lark	生产就绪	内置插件
Google Chat	生产就绪	可下载插件
iMessage	生产就绪	内置（需 macOS）
IRC	支持	内置
LINE	支持	可下载插件
Matrix	支持	可下载插件
Mattermost	支持	可下载插件
Microsoft Teams	支持	内置插件
Nextcloud Talk	支持	内置插件
Nostr	支持	内置插件
QQ Bot	支持	内置插件
Signal	支持	需 signal-cli
Slack	生产就绪	内置
Synology Chat	支持	内置插件
Telegram	生产就绪	内置
Tlon (Urbit)	支持	内置插件
Twitch	支持	内置插件
Voice Call	支持	独立插件
WebChat	内置	内置
WeChat	支持	外部插件
WhatsApp	生产就绪	按需安装插件
Yuanbao	支持	外部插件
Zalo	支持	内置插件
Zalo Personal	支持	内置插件

最快设置：Telegram（只需 bot token）。WhatsApp 需要 QR 配对。

路由规则

OpenClaw 将回复路由回消息来源的 Channel，路由是确定性的。

Session Key 形状：

DM（默认）：agent:<agentId>:main
群组：agent:<agentId>:<channel>:group:<id>
频道/房间：agent:<agentId>:<channel>:channel:<id>
Slack/Discord 线程：追加 :thread:<threadId>
Telegram 话题：嵌入 :topic:<topicId>

配对（DM 访问控制）

配对是 OpenClaw 的显式访问审批步骤：

DM 配对：控制谁可以与 bot 对话
节点配对：控制哪些设备可以加入 Gateway 网络

配对码：8 字符大写，1 小时过期，每 Channel 最多 3 个待处理请求。

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

DM 策略：

pairing（默认）：未知发送者收到配对码，消息不处理直到审批
open：公开（需要 allowFrom: ["*"]）
allowlist：仅白名单发送者

群组行为

默认行为：

群组受限（groupPolicy: "allowlist"）
回复需要 @提及（requireMention: true）
群组/频道中的最终回复默认私有（需用 message 工具发送可见回复）

groupPolicy? disabled → 丢弃
groupPolicy? allowlist → 群组允许? no → 丢弃
requireMention? yes → 被提及? no → 仅存储上下文
otherwise → 回复

可见回复配置：

{
  messages: {
    groupChat: {
      visibleReplies: "message_tool",  // 或 "automatic"
    },
  },
}

访问组（Access Groups）

跨多个 Channel 复用相同的发送者白名单：

{
  accessGroups: {
    operators: {
      type: "message.senders",
      members: {
        "*": ["global-owner-id"],
        discord: ["discord:123456789012345678"],
        telegram: ["987654321"],
        whatsapp: ["+15551234567"],
      },
    },
  },
}

在 Channel 白名单中引用：accessGroup:operators

广播组

向多个 Channel 同时发送消息的机制。

Wiki AI

目录