聊天渠道
把 OpenClaw 连接到聊天应用,并理解路由、配对、群聊行为、ambient context 和渠道安全。
OpenClaw Gateway 把 Agent 会话连接到你日常使用的聊天界面。文本几乎 everywhere 都支持;媒体、reaction、thread、群聊行为和登录方式则因渠道而异。
支持的界面
常见渠道包括:
- Telegram
- Slack
- Discord
- Signal
- iMessage,通过当前 macOS
imsg路径 - Google Chat
- Microsoft Teams
- Matrix
- Feishu/Lark
- LINE
- Mattermost
- Nextcloud Talk
- Nostr
- QQ Bot
- Twilio SMS
- Synology Chat
- Tlon
- Twitch
- WeChat 外部插件路径
- Yuanbao
- Zalo 与 Zalo Personal
- Gateway WebChat
有些渠道内置,有些是 bundled plugin,有些会按需从 ClawHub 或 npm 安装。
第一个渠道怎么选
| 渠道 | 适合 | 注意 |
|---|---|---|
| Telegram | 最快测试 | bot token 即可 |
| 日常个人助手 | 需要 QR 配对和更多本地状态 | |
| Slack | 团队工作流 | 注意群聊策略和共享 Agent 风险 |
| Discord | 社区或实验室 | server bot、频道、DM、thread |
| iMessage | Apple 生态 | 需要合适的 macOS host 和权限 |
| WebChat | 本地 smoke test | 不需要第三方聊天账号 |
常用命令
openclaw channels status
openclaw channels add
openclaw channels login --channel telegram
openclaw channels logs --channel whatsapp想看可视化状态和 QR/login flow,可以用 Control UI。
配对与允许发送者
公共聊天界面应默认保留 DM pairing。未知发送者不应该直接控制一个有工具权限的 Agent。
openclaw pairing list
openclaw pairing approve <channel> <code>团队渠道优先使用明确的 allowFrom、allowGuilds、allowChannels 或 access groups,不要随便开放通配访问。
路由
路由决定消息交给哪个 Agent 和哪个 session。OpenClaw 可以按 channel、account、sender、room、binding rules、群聊/私聊上下文、多 Agent 配置来路由。
单 Agent 模式通常都进入 main。多 Agent 模式下,bindings 把账号或房间连接到具体 Agent。
群聊行为
群聊应该比 DM 更严格:
- 尽量需要 mention 或 activation
- 大群不要给宽工具权限
- 开启 bot loop protection
- 理解 Slack 多人 DM 也像群聊
- 只有确实需要时才启用 ambient room events
Ambient room events 让支持的房间把未提及的聊天作为安静上下文,而不是每条消息都唤醒 Agent。
Delivery Notes
近期 OpenClaw 改进了 Telegram 和 WhatsApp 的 rich delivery。Telegram 能更稳定地保留列表、表格、blockquote 和有意换行等结构化文本。WhatsApp 在支持的流程里会尊重已配置的 ACP bindings。
不过每个渠道都有边界。长消息可能被切块,媒体能力各不相同,provider-specific formatting 也可能改变最终输出。
排查问题
openclaw status
openclaw channels status --probe
openclaw logs --follow
openclaw doctor如果渠道收到了消息但 Agent 不回复,检查发送者授权、群聊激活规则、渠道账号绑定、模型凭证健康,以及目标 Agent 是否正忙。
Gateway Pattern
渠道是 ingress adapter。Gateway 把不同平台的协议统一成路由、会话、认证和投递事件,让 Agent runtime 不必理解每个平台的原生协议。
继续实践
聊天渠道 的核心概念已经读完
如果你想把理解变成可复用的能力,可以到 AgentWay 继续练习