聊天频道

OpenClaw 可以在你已经在使用的任何聊天应用上与你对话。每个渠道都通过 Gateway 连接。 所有渠道都支持文本；媒体和表情回应因渠道而异。

标记为“内置插件”或“核心包含”的条目随核心安装一起提供。标记为“官方插件”的渠道可通过一条命令安装 （openclaw plugins install @openclaw/<id>），或在 openclaw onboard / openclaw channels add 期间按需安装。插件管理会将更改 应用到正在运行的 Gateway；参见应用更改并检查。 “外部插件”渠道在 OpenClaw 仓库之外维护。

我应该先连接哪个渠道？¶

从 Telegram 开始。它只需要一个机器人令牌，无需安装插件，因此是 最快可用的渠道。WhatsApp 需要 QR 配对，并在磁盘上存储更多状态。

openclaw channels add --channel telegram --token <bot-token>

不带任何标志运行 openclaw channels add，即可从列表中选择一个渠道。在默认的热重载下， 正在运行的 Gateway 会应用新的账户配置。检查 openclaw channels status --probe；如果 Gateway 离线，请启动它。 完整指南：Telegram。命令参考： openclaw channels。

支持的渠道¶

• A2A - 通过 A2A 1.0 JSON-RPC 协议将外部代理连接到 OpenClaw（内置插件）。
• Buzz - 将 OpenClaw 代理连接到 Buzz 房间（官方插件）。
• ClickClack - ClickClack 机器人令牌渠道设置和目标语法（官方插件）。
• Discord - Discord 机器人设置、配置键、组件、语音和故障排除（官方插件）。
• Feishu - Feishu 机器人概述、功能和配置（官方插件）。
• Google Chat - Google Chat 应用支持状态、功能和配置（官方插件）。
• iMessage - 通过 imsg（基于 stdio 的 JSON-RPC）提供原生 iMessage 支持，并支持用于回复、轻点回应、特效、投票、附件和群组管理的私有 API 操作。当主机要求满足时，推荐用于新的 OpenClaw iMessage 设置（官方插件）。
• IRC - IRC 插件设置、访问控制和故障排除（官方插件）。
• LINE - LINE Messaging API 插件设置、配置和使用（官方插件）。
• Matrix - Matrix 支持状态、设置和配置示例（官方插件）。
• Mattermost - Mattermost 机器人设置和 OpenClaw 配置（官方插件）。
• Microsoft Teams - Microsoft Teams 机器人支持状态、功能和配置（官方插件）。
• Nextcloud Talk - Nextcloud Talk 支持状态、功能和配置（官方插件）。
• Nostr - 通过 NIP-04 加密消息提供 Nostr DM 渠道（官方插件）。
• QQ bot - QQ 机器人设置、配置和使用（官方插件）。
• Raft - 通过 Raft CLI 唤醒桥接提供 Raft 外部代理支持（官方插件）。
• Reef - Reef 渠道设置：在不同人员的 OpenClaw 代理之间进行受保护的端到端加密消息传递（内置插件）。
• Signal - 通过 signal-cli 提供 Signal 支持（原生守护进程或 bbernhard 容器）、设置路径和号码模型（官方插件）。
• Slack - Slack 设置和运行时行为（Socket Mode、HTTP Request URLs 和 relay mode）（官方插件）。
• SMS - Twilio SMS/MMS 设置、访问控制、webhooks 和投递状态（官方插件）。
• Synology Chat - Synology Chat webhook 设置和 OpenClaw 配置（官方插件）。
• Telegram - Telegram 机器人支持状态、功能和配置（内置插件）。
• Tlon - Tlon/Urbit 支持状态、功能和配置（官方插件）。
• Twitch - Twitch 聊天机器人：安装、凭据、访问控制和令牌刷新（官方插件）。
• WebChat - 通过 Gateway WebSocket 使用原生和 Control UI WebChat（核心包含）。
• WeChat - 通过外部 openclaw-weixin 插件设置 WeChat 渠道（外部插件）。
• WeCom - 安装外部 WeCom 插件并查找其版本化设置文档（外部插件）。
• WhatsApp - WhatsApp 渠道支持、访问控制、投递行为和运维（官方插件）。
• Yuanbao - Yuanbao 机器人概述、功能和配置（外部插件）。
• Zalo - Zalo 机器人支持状态、功能和配置（官方插件）。
• Zalo ClawBot - 通过外部 openclaw-zaloclawbot 插件设置 Zalo ClawBot 渠道（外部插件）。
• Zalo personal - 通过原生 zca-js（QR 登录）提供 Zalo 个人账户支持、功能和配置（官方插件）。

相关通信插件¶

• Voice Call - 通过 Plivo、Telnyx 或 Twilio 提供电话服务（官方插件）。

加入群组时的介绍¶

当机器人加入允许的群组时，Discord、LINE、Matrix、Slack 和 Telegram 会发布一条特定于房间的介绍，而不是静默加入。介绍会说明该房间似乎用于什么，并列出机器人可以在那里承担的一些具体任务，依据是该平台实际能够显示给它的信息。

禁用。 介绍默认开启。使用 channels.<channel>.joinIntro: false 按渠道关闭，或使用 channels.<channel>.accounts.<accountId>.joinIntro 覆盖单个账户。解析顺序是账户值，然后是渠道值，然后是默认值 true。没有按房间开关，因为只有在机器人已经加入房间后，房间才可供配置。只有 Discord、LINE、Matrix、Slack 和 Telegram 接受此选项；其他渠道会拒绝它，而不是接受一个它们从不读取的设置。

它读取的内容。 核心请求最多 100 条最近消息以及房间元数据，然后将整个快照截断为 12,000 个字符，并优先丢弃最旧的消息。各平台可提供的内容有所不同：

当历史记录不可用或不可读取时，介绍仍会仅根据房间元数据发布，并说明它能看到的内容，而不是编造活动。

它发布的位置。 LINE、Matrix、Slack 和 Telegram 会在加入的房间中发布介绍。Discord 加入的是服务器而不是频道，因此当它可以在系统频道中查看和发送时，会使用系统频道；否则使用第一个符合条件的文本频道；如果没有符合条件的频道，它会记录一次跳过，而不是发布。

频率。 每个房间一次。会为每个频道、账户和房间记录一个持久声明，有效期为 90 天，因此重连和网关重启不会重复发布介绍。Discord 还会忽略超过五分钟的服务器可用事件，因此重启绝不会向机器人已经所属的服务器批量发布介绍。Matrix 会忽略启动时的房间快照以及使机器人保持加入状态的成员更新，例如显示名称更改。未接受的 Matrix 邀请不会触发介绍。声明过期后重新邀请会再次发布介绍。

安全性。 房间标题、主题、置顶文本和消息历史属于第三方内容，因此它们会被包装为不受信任的外部内容，并且介绍回合运行时完全没有任何可用工具。嵌入在房间中的指令无法触达任何工具。该回合限制在 60 秒内，绝不会在私信中运行，也绝不会绕过频道访问策略 - 机器人不被允许操作的房间不会获得介绍。提及要求不适用，因为加入事件不包含可提及机器人的消息。

投递说明¶

• 包含 Markdown 图片语法（例如 ![alt](url)）的 Telegram 回复，在可能的情况下会在最终出站路径上转换为媒体回复。
• Slack 多人私信会按群聊路由，因此群策略、提及行为和群会话规则适用于 MPIM 会话。
• WhatsApp 设置为按需安装：入门流程可以在插件包安装之前显示设置流程，并且 Gateway 仅在该频道实际激活时加载外部 ClawHub/npm 插件。
• 接受机器人发送的入站消息的频道可以使用共享的 机器人循环保护，以防止机器人对无限期地互相回复。
• 受支持的常驻房间可以使用 环境房间事件，使未被提及的房间聊天成为静默上下文，除非代理使用 message 工具发送。

说明¶

• 频道可以同时运行；配置多个后，OpenClaw 会按聊天路由。
• 群组行为因频道而异；请参阅 群组。
• 出于安全考虑，会强制实施私信配对和允许列表；请参阅 安全。
• 故障排查：频道故障排查。
• 模型提供商单独记录；请参阅 模型提供商。