4 / 98 min read

Part 4 : 接入消息渠道

对大多数人来说,OpenClaw 最有感知的瞬间,不是装好那一刻,而是你第一次在聊天软件里给它发消息,它真的回你了。

01 渠道接入总览

OpenClaw 统一管理 20+ 消息平台。无论你接 Telegram、飞书还是钉钉,底层思路基本都一样:

创建凭证 -> 写入配置 -> 启动 Gateway -> 完成配对

常见平台与难度

平台类型难度典型耗时
Telegram内置很低5 分钟
QQ插件 / 官方能力很低5 分钟
Discord内置15 到 20 分钟
飞书内置 / 插件低到中15 到 20 分钟
WhatsApp内置10 到 15 分钟
Slack内置25 到 40 分钟
钉钉社区插件20 到 30 分钟
企业微信社区插件20 到 30 分钟
Signal内置20 到 30 分钟
iMessage扩展中偏难30 到 45 分钟

新手推荐顺序

如果你只想先成功一次,推荐顺序可以这样排:

  1. Telegram:最容易验证全链路。
  2. QQ:国内用户非常顺手。
  3. Discord / 飞书:适合团队和社区。
  4. 钉钉 / 企微 / WhatsApp:再根据业务场景往下接。

02 国际平台接入

Telegram:最适合新手

Telegram 是 OpenClaw 最典型的入门渠道,因为它支持 long-polling,不需要公网 IP,也不需要反向代理。

基本步骤:

  1. 在 Telegram 找到 @BotFather
  2. 发送 /newbot
  3. 创建 Bot 并拿到 Token
  4. 写入配置并重启 Gateway
  5. 给 Bot 发消息,完成 DM 配对

示例配置:

channels:
  telegram:
    enabled: true
    botToken: "YOUR_BOT_TOKEN"
    dmPolicy: pairing

Discord:适合团队与社区

Discord 的配置步骤比 Telegram 多一些,但文档比较完整。

你需要完成:

  1. 创建 Application
  2. 创建 Bot
  3. 打开 Message Content IntentServer Members Intent
  4. 用 OAuth2 邀请 Bot 进服务器
  5. 获取 Server ID、User ID
  6. 配置后私聊完成配对

WhatsApp:受欢迎,但要注意会话稳定性

WhatsApp 使用 Baileys 扫码接入,不依赖官方 Business API。

典型流程:

  1. 运行 openclaw onboard
  2. 选择 WhatsApp
  3. 终端出现二维码
  4. 手机扫码绑定

实践建议:

  • 最好用独立号码,不要上主号
  • Session 凭证要当密码看待
  • 过期后通常需要重新扫码
  • 这个场景下优先用 Node,别优先上 Bun

Slack:企业场景常见

Slack 默认使用 Socket Mode,因此不一定需要公网回调地址。

你要准备的主要是:

  • xapp- 开头的 App-Level Token
  • xoxb- 开头的 Bot Token
  • 一组足够的 Bot Scopes

还有一点很重要:由于 OpenClaw 能执行真实命令,Slack 这种多人环境里更建议放在专门的 VM 或服务器上,而不是直接跑在你自己的主力工作机里。

Signal 与 iMessage

Signal 依赖 signal-cli;iMessage 则通过 BlueBubbles 桥接。

iMessage 的关键点有两个:

  • 需要一台常开的 Mac
  • Webhook 必须配置密码认证

BlueBubbles 典型配置如下:

extensions:
  bluebubbles:
    enabled: true
    serverUrl: "http://localhost:1234"
    password: "YOUR_PASSWORD"

03 国内平台接入

QQ:国内最轻松的入口之一

QQ Bot 的优势是快,扫码后很容易完成绑定,而且对图片、语音、文件等消息类型的支持也比较友好。

典型步骤:

  1. 注册 QQ Bot 开发者
  2. 创建 Bot
  3. 获取 App ID 与 Token
  4. 写入 OpenClaw 配置
  5. 开始私聊或群聊接入

飞书:企业场景很自然

飞书从 OpenClaw 2026.2 起就有原生内置支持,适合做:

  • 内部通知
  • 团队助手
  • 文档 / 文件 / 群聊协作

最常见的方式是:

  1. 在开放平台创建企业自建应用
  2. 获取 App IDApp Secret
  3. 运行 openclaw onboard
  4. 选择 Feishu 并填写配置

钉钉与企业微信

这两个平台目前更依赖社区插件,但成熟度已经不低。

钉钉

更推荐的是 Stream 模式,因为它走 WebSocket 长连接,不需要公网回调地址。

常见插件有:

  • @soimy/dingtalk
  • dingtalk-openclaw-connector

企业微信

企业微信常见有两种模式:

  • Agent 模式
  • Bot 模式

已经被多家国内云平台验证可用,比较适合企业内部自动化。

个人微信:需求最大,但风险也最高

这一块的结论很直接:没有官方 Bot API,所有方案都存在维护成本和封号风险。

常见路线有三种:

  1. 企业微信中转
  2. iPad 协议 + 中转网关
  3. 微信小程序

建议原则:

  • 别用主号
  • 别把它当完全稳定的官方能力
  • 要接受协议变化导致失效的风险

openclaw-china:国内多平台整合方案

如果你一次要接多个国内平台,统一插件包会更省事。

git clone https://github.com/BytePioneer-AI/openclaw-china.git
cd openclaw-china
pnpm install
pnpm build
openclaw china setup

它覆盖的重点平台包括:

  • 飞书
  • 钉钉
  • QQ
  • 企业微信
  • 微信

04 远程访问与多设备使用

OpenClaw 默认只监听本地 ws://127.0.0.1:18789。如果你想让手机、平板或外部服务访问它,需要额外做远程访问配置。

Tailscale Serve / Funnel

这是很常见也很稳妥的方案。

tailscale serve --bg https+insecure://127.0.0.1:18789
tailscale funnel --bg https+insecure://127.0.0.1:18789

区别是:

模式访问范围适用场景
ServeTailscale 网络内设备自己手机访问家里的 OpenClaw
Funnel公网可访问需要 Webhook 回调

SSH 端口转发

如果 OpenClaw 在远程服务器上,你也可以临时用 SSH 隧道:

ssh -L 18789:127.0.0.1:18789 user@your-server
ssh -fNL 18789:127.0.0.1:18789 user@your-server

Dashboard 与客户端

Gateway 启动后可以通过 Web UI 观察:

  • 会话状态
  • 模型配置
  • 渠道连通情况
  • Token 用量
openclaw gateway --port 18789 --verbose

项目也有 macOS 菜单栏客户端,并且 iOS / Android 客户端也在开发中。

这一章的建议

如果你是第一次接入渠道,最稳的路线通常是:

Telegram 或 QQ -> 完成私聊配对 -> 再去接飞书 / 钉钉 / 企微 -> 最后处理远程访问

顺序对了,排障会轻松很多。