Gateway

聊天渠道

10分钟

把 OpenClaw 连接到聊天应用,并理解路由、配对、群聊行为、ambient context 和渠道安全。

OpenClaw Gateway 把 Agent 会话连接到你日常使用的聊天界面。文本几乎 everywhere 都支持;媒体、reaction、thread、群聊行为和登录方式则因渠道而异。

支持的界面

常见渠道包括:

  • Telegram
  • WhatsApp
  • 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 即可
WhatsApp日常个人助手需要 QR 配对和更多本地状态
Slack团队工作流注意群聊策略和共享 Agent 风险
Discord社区或实验室server bot、频道、DM、thread
iMessageApple 生态需要合适的 macOS host 和权限
WebChat本地 smoke test不需要第三方聊天账号

常用命令

bash
openclaw channels status
openclaw channels add
openclaw channels login --channel telegram
openclaw channels logs --channel whatsapp

想看可视化状态和 QR/login flow,可以用 Control UI。

配对与允许发送者

公共聊天界面应默认保留 DM pairing。未知发送者不应该直接控制一个有工具权限的 Agent。

bash
openclaw pairing list
openclaw pairing approve <channel> <code>

团队渠道优先使用明确的 allowFromallowGuildsallowChannels 或 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 也可能改变最终输出。

排查问题

bash
openclaw status
openclaw channels status --probe
openclaw logs --follow
openclaw doctor

如果渠道收到了消息但 Agent 不回复,检查发送者授权、群聊激活规则、渠道账号绑定、模型凭证健康,以及目标 Agent 是否正忙。

Gateway Pattern

渠道是 ingress adapter。Gateway 把不同平台的协议统一成路由、会话、认证和投递事件,让 Agent runtime 不必理解每个平台的原生协议。

继续实践

聊天渠道 的核心概念已经读完

如果你想把理解变成可复用的能力,可以到 AgentWay 继续练习