本页内容
本页内容
概览
聊天频道
OpenClaw 可以在你已经在使用的任何聊天应用上与你交流。每个频道都通过 Gateway 连接。 所有平台都支持文本;媒体和表情反应因频道而异。
标记为“捆绑插件”或“包含在核心中”的条目随核心安装一起提供。标记为“官方插件”的频道可通过一个命令 (openclaw plugins install @openclaw/<id>) 安装或在 openclaw onboard / openclaw channels add 期间按需安装。插件管理将更改应用于正在运行的网关;请参阅 应用更改并检查 。 “外部插件”通道在 OpenClaw 存储库外部维护。
我应该先连接哪个通道?
从 Telegram 开始。它需要机器人令牌并且无需安装插件,因此它是最快的工作渠道。 WhatsApp 需要 QR 配对并在磁盘上存储更多状态。
运行不带标志的 openclaw channels add 来从列表中选择一个通道。使用默认的 hot reload,正在运行的网关将应用新的帐户配置。检查openclaw channels status --probe;如果网关离线,则启动网关。完整演练: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 提供原生 iMessage 支持(通过标准输入输出进行 JSON-RPC),并支持用于回复、Tapback、效果、投票、附件和群组管理的私有 API 操作。当主机要求满足条件时,推荐用于新的 OpenClaw iMessage 设置(官方插件)。
- IRC - IRC 插件设置、访问控制和故障排除(官方插件)。
- LINE - LINE Messaging API 插件设置、配置和使用(官方插件)。
- Matrix - Matrix 支持状态、设置和配置示例(官方插件)。
- Mattermost - Mattermost 机器人设置和 OpenClaw 配置(官方插件)。
- Microsoft Teams - Microsoft Teams 机器人支持状态、功能和配置(官方插件)。
- Nextcloud Talk - Nextcloud Talk 支持状态、功能和配置(官方插件)。
- Nostr - Nostr DM 通道通过 NIP-04 加密消息(官方插件)。
- QQ 机器人 - QQ 机器人设置、配置和使用(官方插件)。
- Raft - Raft 通过 Raft CLI 唤醒桥(官方插件)支持外部代理。
- Reef - Reef 渠道设置:不同用户的 OpenClaw 代理之间受保护的端到端加密消息传递(内置插件)。
- Signal - 通过 signal-cli 支持 Signal(原生守护进程或 bbernhard 容器),包括设置路径和号码模型(官方插件)。
- Slack - Slack 设置和运行时行为(套接字模式、HTTP 请求 URL 和中继模式)(官方插件)。
- SMS - Twilio SMS/MMS 设置、访问控制、Webhook 和投递状态(官方插件)。
- Synology Chat - Synology Chat Webhook 设置和 OpenClaw 配置(官方插件)。
- Telegram - Telegram 机器人支持状态、功能和配置(内置插件)。
- Tlon - Tlon/Urbit 支持状态、功能和配置(官方插件)。
- Twitch - Twitch 聊天机器人:安装、凭据、访问控制和令牌刷新(官方插件)。
- WebChat - 通过网关 WebSocket(包含在核心中)本机和 Control UI WebChat 使用。
- WeChat - WeChat 通过外部 openclaw-weixin 插件(外部插件)设置频道。
- WeCom - 安装外部 WeCom 插件并找到其版本设置文档(外部插件)。
- WhatsApp - WhatsApp 渠道支持、访问控制、投递行为和运维(官方插件)。
- X / Twitter - X / Twitter 提及、列入白名单的公共回复、线程上下文和事件模式(捆绑插件)。
- 元宝 - 元宝机器人概览、功能和配置(外部插件)。
- Zalo - Zalo 机器人支持状态、功能和配置(官方插件)。
- Zalo ClawBot - 通过外部 openclaw-zaloclawbot 插件设置 Zalo ClawBot 渠道(外部插件)。
- Zalo individual - 通过本机 zca-js (QR 登录)、功能和配置(官方插件)支持 Zalo 个人帐户。
相关通信插件
- Voice Call - 通过 Plivo、Telnyx 或 Twilio(官方插件)进行电话。
集团加盟介绍
当机器人加入允许的组时,Discord、LINE、Matrix、Slack 和 Telegram 会发布一个特定于房间的介绍,而不是静默加入。简介中介绍了这个房间的用途,并根据该平台实际可以展示的内容,列出了机器人可以在那里承担的一些具体工作。
Disabling. 简介默认处于打开状态。使用 channels.<channel>.joinIntro: false 将每个通道关闭,或使用 channels.<channel>.accounts.<accountId>.joinIntro 覆盖单个帐户。解析顺序是账户值,然后是通道值,然后是默认的true。没有每个房间的开关,因为只有在机器人加入房间后才可以配置房间。仅 Discord、LINE、Matrix、Slack 和 Telegram 接受此选项;其他频道会拒绝它,而不是接受他们从未阅读过的设置。
它读取的内容。 Core 请求最多 100 条最近消息以及房间元数据,然后将整个快照截断为 12,000 个字符,首先删除最旧的消息。每个平台可以提供的内容有所不同:
| 渠道 | 房间元数据 | 之前的消息 |
|---|---|---|
| Discord | 频道名称、主题 | 最多 100 个,仅限 Read Message History |
| LINE | 团体名称;多人房间没有 | 无 - Messaging API 没有历史记录阅读器 |
| Matrix | 房间名称、主题 | 多达 100 条可读的房间消息 |
| Slack | 频道名称、目的、主题 | 通过对话历史记录最多 100 个 |
| Telegram | 群组标题、描述、固定消息 | 无 - 机器人 API 无法读取预加入历史记录 |
当历史记录不可用或不可读时,介绍仍然仅从房间元数据发布,并说明它可以看到的内容,而不是发明活动。
发布的地方。 LINE、Matrix、Slack和Telegram在加入的房间中介绍。 Discord 加入服务器而不是通道,因此当它既可以在系统通道上查看又可以发送时,它使用系统通道,否则使用第一个符合条件的文本通道;如果没有频道符合条件,则会记录跳过而不是发布。
多久一次。 每个房间一次。每个频道、帐户和房间都会记录一个具有 90 天生命周期的持久声明,因此重新连接和网关重新启动不会重复介绍。 Discord 另外会忽略超过五分钟的服务器可用事件,因此重新启动绝不会大量引入机器人已经所属的服务器。 Matrix 忽略启动房间快照和使机器人保持连接状态的成员资格更新,例如显示名称更改。未接受的 Matrix 邀请不会触发介绍。索赔过期后重新邀请会再次引入。
Safety. 房间标题、主题、固定文本和消息历史记录都是第三方内容,因此它们被包装为不受信任的外部内容,并且介绍轮运行时根本没有可用的工具。嵌入房间的指令无法到达工具。回合时间限制为 60 秒,绝不会在直接消息中运行,也绝不会绕过频道访问策略 - 不允许机器人进入的房间不会得到任何介绍。提及要求不适用,因为加入事件不包含提及机器人的消息。
交付说明
- 如果可能,包含 Markdown 图像语法的 Telegram 回复(例如
)将转换为最终出站路径上的媒体回复。 - Slack 多人私信会按群聊路由,因此群组策略、提及行为和群组会话规则都适用于 MPIM 对话。
- WhatsApp 的设置采用按需安装:引导流程可以在插件包尚未安装时显示,而 Gateway 只有在频道实际处于活动状态时才会加载外部 ClawHub/npm 插件。
- 接受由机器人编写的入站消息的频道可以使用共享的 机器人循环保护,以防止机器人配对彼此无休止地回复。
- 支持常驻房间的频道可以使用 环境房间事件, 这样未被提及的房间聊天就会成为安静的上下文,除非代理使用
message工具发送。
说明
- 各个渠道可以同时运行;配置多个后,OpenClaw 会按聊天自动路由。
- 群组行为因渠道而异;参见 群组。
- 为了安全起见,DM 配对和允许列表会强制执行;参见 安全。
- 故障排除:渠道故障排除。
- 模型提供者单独记录;参见 模型 Providers。