OpenClaw 消息通道

OpenClaw 的核心交互方式,是把智能体接入你已经在用的聊天软件——用 WhatsApp / Telegram 指挥它,就像和一位助理聊天。


通道适配器(Channel Adapters)

网关的第一个子系统就是通道适配器:它把各平台五花八门的消息归一化成统一格式,交给会话管理与 Agent 主循环处理,再把回复发回对应平台。

[WhatsApp] ──┐
[Telegram] ──┼─→ 通道适配器(归一化)→ 会话管理 → Agent 主循环 → 回复 → 各平台
[Slack]    ──┘

不同平台由对应的库驱动,例如 WhatsApp 用 Baileys、Telegram 用 grammY


支持的平台

平台说明
WhatsApp通过 Baileys 接入
Telegram通过 grammY 接入,最常用
Slack团队协作
Discord社区 / 频道
iMessagemacOS 生态
Signal隐私通讯
Mattermost经扩展包接入

具体平台与接入方式以官方当前版本为准。


配置通道

通道接入在 openclaw onboard 引导流程中即可配置,也可在 Dashboard 中管理。每个平台需要对应的凭据(如 Telegram 通过 @BotFather 创建 Bot 拿 Token,WhatsApp 通过扫码登录等)。

凭据建议放入环境变量或独立配置,不要写进会被分享的文件:

TELEGRAM_BOT_TOKEN=123456:ABC-...
SLACK_BOT_TOKEN=xoxb-...

配置完成后,向你的 Bot 发消息即可开始对话。


会话与身份解析

会话管理(Session Manager)负责解析"是谁在和你说话、属于哪个会话":

  • 每个智能体 / 工作区 / 发送者拥有隔离的会话
  • 群聊拥有自己独立的会话
  • 私信(DM)则汇聚到主会话

这套机制让"同一个 OpenClaw 服务不同的人/群"时不会串味,详见 多智能体


访问控制:别让陌生人指挥你的智能体

把能执行 Shell、浏览器、邮件的智能体接到聊天平台,访问控制是底线

  • 限定允许交互的用户/群白名单
  • 高风险动作走工具策略审批闸门
  • 不要把控制平面端口 :18789 暴露到公网
默认拒绝 → 仅放行可信用户 → 高风险操作再加审批

OpenClaw 曾出现跨站 WebSocket 劫持高危漏洞(已在 2026.1.29 修复),保持更新并收紧网络暴露面,详见 安全章节


媒体与富交互

OpenClaw 支持收发图片、音频、文档,因此你可以:

  • 发一张截图让它分析
  • 发语音转写并执行指令
  • 让它把生成的报告/图表作为文件回传

实践建议

  • 个人使用首选 Telegram:接入最简单、推送体验好
  • 团队场景用 Slack / Discord,配合白名单限定成员
  • 启用审批闸门,避免智能体在聊天里被诱导执行危险操作
  • 网关进程用守护进程/容器常驻,保证 24×7 可用

下一步