Skip to content

08. OpenClaw 聊天渠道通用说明

适用对象:想给 OpenClaw 接入聊天渠道的用户(无需任何编程基础) | 文档版本:V2.0 更新日期:2026 年 3 月 11 日 | 文档定位:从零开始的聊天渠道接入指南,重点覆盖飞书、Discord、Telegram 三大推荐渠道的保姆级教程,同时涵盖其他常见渠道的配置概要与通用排障

如果你是新手,直接看下面的「飞书」教程(三),这是最简单的上手方式。


一、什么是聊天渠道

聊天渠道让你在日常 IM 里与 OpenClaw 对话。消息经渠道往返,OpenClaw 调用模型生成回复。


二、怎么选渠道

选渠道的核心原则:选你每天都在用的平台;如果是本地部署(没有公网 IP),优先选支持长连接/轮询的渠道(飞书、Telegram、Discord)。

按用户类型的推荐顺序

推荐顺序渠道个人用户(大陆)海外用户企业用户
1飞书不需公网回调、不需审核、中文体验好国内企业首选,权限管理完善
2Discord创建 Bot 简单(需科学上网)社区用户多、功能丰富
3Telegram创建 Bot 极简、不需审核(需科学上网)全球用户量大、创建 Bot 最简单
4Slack职场用户首选,配置稍复杂海外企业首选
5企业微信已在用企微则值得接入,配置门槛较高

三、飞书接入保姆级教程(约 15 分钟)

3.1 为什么推荐飞书

  • 不需要公网 IP:飞书支持"长连接"模式,你的电脑主动连飞书,本地部署也能用。
  • 不需要审核:创建企业自建应用后,在自己的企业内部直接可用。
  • 注册免费:个人也可以免费注册飞书,不需要企业资质。

3.2 你需要准备什么

  1. 一个飞书账号

    • 如果没有,去 飞书官网 注册一个。用手机号就能注册,全程免费。
    • 注册后你会自动拥有一个"个人企业",这就够用了。
  2. 一台正在运行 OpenClaw 的电脑

    • OpenClaw 已经安装好并且能正常启动。
    • 如果还没装,请先参阅本系列的安装文档(02 或 03 号文档)。

3.3 在飞书开放平台创建应用

第一步:打开飞书开放平台

在浏览器地址栏里输入以下网址并回车:

https://open.feishu.cn/app

如果弹出登录页面,用你的飞书账号登录。

第二步:点击"创建企业自建应用"

在页面上方或中央区域,点击 "创建企业自建应用" 按钮。不要选"创建商店应用"等其他选项。

第三步:填写应用信息

字段填什么举例
应用名称随便起个名字,这个名字就是你以后在飞书里看到的机器人名字我的AI助手
应用描述简单写一句用途即可接入OpenClaw的AI聊天机器人

应用图标可以不传,系统会给一个默认图标。填好后点击 "确认创建"

第四步:进入应用,添加"机器人"能力

创建成功后,页面会自动跳转到应用管理页面。

  1. 看左侧菜单栏,找到 "添加应用能力""应用能力"
  2. 在能力列表中找到 "机器人",点击 "添加""开通"

添加成功后,左侧菜单栏会多出一个"机器人"选项。

第五步:记录 App ID 和 App Secret

  1. 在左侧菜单栏点击 "凭证与基础信息"
  2. 分别复制 App IDcli_ 开头)和 App Secret,保存到记事本里。

安全提示:App Secret 相当于密码,不要分享给不相关的人。

第六步:配置事件订阅

  1. 在左侧菜单栏找到 "事件订阅",点击进入。
  2. 点击 "添加事件",搜索并添加:
im.message.receive_v1

第七步:选择长连接方式接收事件

  1. 在"事件订阅"页面,找到 "接收方式" 设置区域。
  2. 选择 "使用长连接接收事件"(WebSocket 方式)。

选长连接模式不需要公网 IP,本地部署也能用。

第八步:配置权限

  1. 在左侧菜单栏找到 "权限管理",点击进入。
  2. 搜索并开通以下权限:
权限名称作用
im:message允许获取消息内容
im:message:send_as_bot允许以机器人身份发送消息
im:chat:readonly允许获取群组信息(群聊场景需要)

第九步:发布应用

  1. 在左侧菜单栏找到 "版本管理与发布",点击 "创建版本"
  2. 版本号填 1.0.0,更新说明随便写(如"首次发布"),点击 "保存""申请发布"
  3. 个人用户自己就是管理员,直接点击"审批通过"即可。

发布成功后,你在飞书的搜索框里就能搜到这个机器人了。

3.4 在 OpenClaw 中配置飞书

在终端中执行:

bash
openclaw channels add

选择 Feishu(飞书),按提示填写:

系统提示你要填什么值从哪来
App ID你的 App ID第五步复制的 cli_ 开头的那串
App Secret你的 App Secret第五步复制的那串长字符
连接方式(Connection Mode)输入 websocket就填这个单词

看到以下输出说明连接成功:

[INFO] Feishu channel connected successfully.
[INFO] Waiting for messages...

如果报错了,检查 App ID 和 App Secret 有没有复制错,以及第七步是否选的长连接模式。

3.5 配对(Pairing)

"配对"是让 OpenClaw 确认你的飞书身份的过程。配对只需做一次,之后就能直接聊天。

具体操作步骤

第一步:在飞书里给机器人发一条消息

在飞书搜索你之前给应用取的名字,进入对话窗口,发送一条消息(如"你好")。此时机器人不会回复(因为还没配对),这是正常的。

在运行 OpenClaw 的终端窗口里,你会看到配对码:

[INFO] New pairing request from Feishu user. Pairing code: ABCD1234

第二步:查看待配对列表

如果没看到配对码,打开另一个终端窗口执行:

bash
openclaw pairing list feishu

第三步:批准配对

bash
openclaw pairing approve feishu ABCD1234

ABCD1234 替换成你实际看到的配对码。

3.6 验证成功

配对完成后,在飞书里再给机器人发一句话。如果机器人回复了,飞书渠道接入成功。

在对话框里发一句「你好」,如果收到回复,说明渠道配置成功了。

3.7 飞书渠道常见问题

Q1:我在飞书里发了消息,但机器人完全没有回应,终端里也没有任何新的提示。

按以下顺序排查:

  1. 确认 OpenClaw 还在运行。 看终端窗口是否已关闭或显示报错后停止。
  2. 确认应用已发布且事件订阅正确。 在飞书开放平台检查应用状态为"已发布",且事件订阅中有 im.message.receive_v1、接收方式为"长连接"。
  3. 重启 OpenClaw。Ctrl+C 停止后重新启动。

Q2:配对码在哪里看?我在终端里刷了很多信息,找不到了。

两种方法:

  • 方法一:另外打开一个终端窗口,执行 openclaw pairing list feishu,会列出所有等待配对的请求。
  • 方法二:在飞书里重新给机器人发一条消息,会生成一个新的配对码,同时终端里也会打印出来。

Q3:我想重新配对(比如换了电脑、重装了 OpenClaw),怎么操作?

重新配对的步骤和第一次完全一样:

  1. 在飞书里给机器人发一条消息。
  2. openclaw pairing list feishu 查看配对码。
  3. openclaw pairing approve feishu <配对码> 批准配对。

不需要去飞书开放平台做任何改动。


四、Discord 接入保姆级教程(约 10 分钟)

4.1 你需要准备什么

  1. 一个 Discord 账号

    • 如果没有,去 Discord 官网 注册一个,完全免费。
    • 你还需要有一个自己的 Discord 服务器(Server)。点击左侧栏的 "+" 号即可免费创建。
  2. 一台正在运行 OpenClaw 的电脑

  3. 能访问 Discord 的网络环境

    • 中国大陆用户需要科学上网。

4.2 在 Discord 开发者平台创建 Bot

第一步:打开 Discord 开发者平台

访问 https://discord.com/developers/applications,用你的 Discord 账号登录。

第二步:创建 Application

点击 "New Application",输入应用名称(即你的机器人名字),勾选同意条款,点击 "Create"

第三步:获取 Bot Token

在左侧菜单点击 "Bot"。点击 "Reset Token"(或 "Copy")获取 Token。Token 只会显示一次,立刻复制并保存到安全的地方。

Token 相当于 Bot 的密码,不要分享给任何人。丢失后只能 Reset Token 重新生成。

第四步:开启 Intents 并配置权限

  1. 在 Bot 页面下方 "Privileged Gateway Intents" 区域,打开 MESSAGE CONTENT INTENT(必须,否则收不到消息内容),建议同时打开 SERVER MEMBERS INTENT,点击 "Save Changes"
  2. 左侧菜单点击 "OAuth2""URL Generator",SCOPES 勾选 bot,BOT PERMISSIONS 勾选 Send MessagesRead Message HistoryView Channels
  3. 复制底部生成的链接,在浏览器中打开,选择你的服务器并授权。

4.3 在 OpenClaw 中配置

bash
openclaw channels add

选择 Discord,填入 Bot Token。看到以下输出说明连接成功:

[INFO] Discord channel connected successfully.
[INFO] Bot is online. Waiting for messages...

也可以直接编辑配置:

bash
openclaw config set 'channels.discord' --json '{
  "enabled": true,
  "token": "你的Bot Token粘贴在这里"
}'
openclaw gateway restart

4.4 配对

第一步:在 Discord 里给 Bot 发一条私信(右键点击 Bot → "Message"),或在频道里 @你的Bot名字 hello

第二步:查看配对码:

bash
openclaw pairing list discord

第三步:批准配对:

bash
openclaw pairing approve discord <配对>

4.5 验证

配对成功后,在 Discord 里给 Bot 发一条消息。如果 Bot 回复了你,说明 Discord 渠道接入成功了。

在对话框里发一句「你好」,如果收到回复,说明渠道配置成功了。

4.6 常见问题

Q1:Bot 在 Discord 里一直显示离线(灰色圆点)。

  • 确认 OpenClaw 正在运行且终端里没有报错。
  • 确认 Bot Token 填写正确——最常见的错误是复制时多了一个空格或少了一个字符。重新复制粘贴试试。
  • 确认你的电脑能正常访问 Discord(中国大陆用户检查科学上网是否正常)。试着在浏览器里打开 https://discord.com,如果打不开,说明网络有问题。
  • 确认你没有在其他地方(比如另一台电脑)也用同一个 Token 运行了另一个程序。一个 Token 同一时间只能被一个程序使用。

Q2:Bot 显示在线了,但发消息没有任何回复。

  • 最常见原因:忘记开启 MESSAGE CONTENT INTENT。回到 Discord 开发者平台 → Bot 页面 → 往下滚 → 把 "MESSAGE CONTENT INTENT" 开关打开 → 保存 → 重启 OpenClaw。
  • 确认你已经完成了配对(第 4.4 节)。没配对的话,OpenClaw 收到消息也不会回复。
  • 如果你是在服务器频道里(不是私信),确认你 @了 Bot。大部分配置下,Bot 只会回复被 @ 的消息。

五、Telegram 接入保姆级教程(约 5 分钟)

5.1 你需要准备什么

  1. 一个 Telegram 账号 — 去 Telegram 官网 下载客户端,用手机号注册即可。
  2. 一台正在运行 OpenClaw 的电脑
  3. 能访问 Telegram 的网络环境(中国大陆用户需要科学上网)

5.2 通过 @BotFather 创建 Bot

在 Telegram 搜索 @BotFather(认准蓝色认证勾),进入对话:

  1. 发送 /newbot
  2. BotFather 让你输入显示名称(中英文均可,如 我的AI助手
  3. BotFather 让你输入用户名(必须英文、以 bot 结尾,如 my_openclaw_ai_bot
  4. 创建成功后 BotFather 会返回 Token,立刻复制并保存。如不慎泄露,可发送 /revoke 重置。

5.3 在 OpenClaw 中配置

bash
openclaw channels add

选择 Telegram,填入从 BotFather 获取的 Token。看到以下输出说明连接成功:

[INFO] Telegram channel connected successfully.
[INFO] Waiting for messages...

Telegram Bot 默认使用 Polling 模式,不需要公网 IP。

接下来完成配对:

  1. 在 Telegram 中搜索你的 Bot 用户名,点击 "Start"(或发送 /start)。
  2. 发一条消息,比如"你好"。
  3. 查看配对码:openclaw pairing list telegram
  4. 批准配对:openclaw pairing approve telegram <配对码>

5.4 验证

配对完成后,在 Telegram 里给 Bot 发一条消息。收到 AI 回复即表示接入成功。

在对话框里发一句「你好」,如果收到回复,说明渠道配置成功了。

5.5 常见问题

Q1:给 Bot 发消息后,OpenClaw 终端里没有任何反应。

  • 确认 Token 填写正确。 尝试删除渠道后重新添加,仔细粘贴 Token。
  • 确认网络通畅。 如果你在用代理/VPN,确认终端环境也走了代理(设置 http_proxyhttps_proxy 环境变量)。
  • 确认没有其他程序也在用这个 Token。 一个 Bot Token 同一时间只能被一个程序使用。

六、其他渠道概要

以下渠道同样受 OpenClaw 支持,但配置复杂度或使用门槛各有不同。

6.1 Slack

适合海外企业团队使用的职场沟通工具,配置步骤比 Telegram/Discord 多一些。

配置命令

bash
openclaw channels add
# 在菜单中选择 Slack,按提示填写 Bot Token 和 App-Level Token

或者直接编辑配置:

bash
openclaw config set 'channels.slack' --json '{
  "enabled": true,
  "mode": "socket",
  "appToken": "xapp-你的AppLevelToken",
  "botToken": "xoxb-你的BotToken"
}'
openclaw gateway restart

注意事项

  • 需要在 Slack API 平台 创建 App。
  • 强烈建议使用 Socket Mode(类似飞书的长连接模式),不需要公网回调地址。
  • 使用 Socket Mode 需要在 App 设置的 "Basic Information" → "App-Level Tokens" 中生成一个 Token,权限选 connections:write
  • 需要开通的 Bot Token Scopes:chat:writeim:historyim:readapp_mentions:read

6.2 WhatsApp

全球用户量最大的即时通讯工具,但接入需要通过 Meta 的商业平台,流程较长。

配置命令

bash
openclaw channels add
# 选择 WhatsApp,按提示填写 Phone Number ID、Business Account ID 和 Access Token

注意事项

  • 需要在 Meta for Developers 创建应用并配置 WhatsApp Business API。
  • 需要 公网可访问的 Webhook 回调地址,建议云端部署。
  • 需要一个经过验证的 Facebook Business 账号。
  • 整体配置比飞书和 Telegram 复杂很多,建议有一定经验后再尝试。

6.3 企业微信

适合已经在使用企业微信的国内企业,但配置门槛是所有主流渠道中最高的之一。

配置命令

bash
openclaw config set 'channels.wechat-work' --json '{
  "enabled": true,
  "corpId": "你的CorpId",
  "agentId": "你的AgentId",
  "secret": "你的Secret",
  "token": "你的Token",
  "encodingAESKey": "你的EncodingAESKey"
}'
openclaw gateway restart

难点和门槛

门槛具体说明
企业认证需要有一个经过认证的企业微信组织。
公网回调需要公网可访问的回调地址。本地部署需用 frp、ngrok 等内网穿透工具。
可信域名需要配置可信域名并放置验证文件。
IP 白名单API 调用需要把服务器 IP 加入白名单。
凭证多需要填写 5 个凭证(CorpId、AgentId、Secret、Token、EncodingAESKey)。

6.4 QQ 机器人

面向 QQ 用户的机器人接入,但目前官方 API 限制较多,个人用户体验不太友好。

配置命令

bash
openclaw channels add
# 选择 QQ,按提示填写 App ID 和 Token

难点和门槛

门槛具体说明
官方 API 限制目前主要支持频道(Guild)场景,不支持普通 QQ 群和好友私聊。
开发者认证需要在 QQ 开放平台 注册并认证。
审核创建的机器人需要提交审核,审核时间不确定。
沙箱限制审核通过前只能在沙箱频道中测试。

6.5 钉钉

适合使用钉钉办公的企业用户,配置体验介于飞书和企业微信之间。

配置命令

bash
openclaw channels add
# 选择 DingTalk,按提示填写 App Key 和 App Secret

注意事项

  • 需要在 钉钉开放平台 创建企业内部应用。
  • 推荐使用 Stream 模式(类似飞书长连接),不需要公网地址。
  • 需要给应用添加"机器人"能力,并配置消息接收权限。

6.6 Signal

注重隐私和安全的即时通讯工具,适合对数据安全有极高要求的用户,但配置最复杂。

配置命令

bash
openclaw channels add
# 选择 Signal,按提示填写 Signal 号码和 API 地址

注意事项

  • Signal 没有官方 Bot API,需要借助 signal-clisignald 等第三方桥接工具。
  • 需要一个独立的手机号注册 Signal 账号作为 Bot 号码。
  • 需要先部署 signal-cli REST API 服务。
  • 适合有一定技术基础、非常在意通信隐私的用户。

6.7 iMessage / BlueBubbles

让你在 iMessage 里跟 AI 聊天。仅限 macOS 用户,需要额外安装 BlueBubbles Server。

配置命令

bash
openclaw channels add
# 选择 BlueBubbles,按提示填写 BlueBubbles 服务器地址和密码

注意事项

  • 必须有一台始终开机运行的 Mac 电脑。
  • 需要先在 Mac 上安装 BlueBubbles Server,它把 iMessage 的消息通过 API 暴露出来。
  • 优点:对方完全不需要做任何配置,体验非常自然。
  • 缺点:需要 Mac + BlueBubbles + OpenClaw 三者配合,且 Mac 不能关机或休眠。

七、按部署方式怎么选

7.1 本地部署(你自己的电脑,没有公网 IP)

优先级渠道连接方式说明
1飞书WebSocket 长连接最推荐。完全不需要公网 IP。
2TelegramPolling 轮询不需要公网 IP。
3DiscordWebSocket 长连接不需要公网 IP。
4Slack(Socket Mode)WebSocket 长连接选 Socket Mode 就不需要公网 IP。
5钉钉(Stream 模式)长连接选 Stream 模式就不需要公网 IP。
6iMessage / BlueBubbles本地 APIMac 上本地通信,不需要公网 IP。
不推荐企业微信HTTP 回调需要公网回调地址,本地部署需内网穿透。
不推荐WhatsAppHTTP 回调同上。
不推荐QQ 机器人HTTP 回调同上,且还有审核和白名单限制。

7.2 云端部署(有公网 IP 的服务器)

优先级渠道建议的连接方式说明
全部可用所有渠道不限有公网 IP 就没有限制。
特别推荐Telegram(Webhook)HTTP 回调比 Polling 模式响应更快、资源消耗更低。
特别推荐Slack(Event API)HTTP 回调比 Socket Mode 更稳定。
特别推荐企业微信HTTP 回调云端部署完美解决了企微最大的配置痛点。
特别推荐WhatsAppHTTP 回调云端部署是 WhatsApp 接入的前提条件。

八、聊天渠道通用排障

大部分问题都是配置信息填错导致的,按下面的清单逐项检查通常就能解决。

无论你用的是哪个渠道,遇到问题时都可以先对照下面的列表来排查。

Q1:消息发了没有回复

这是最常见的问题。按以下顺序逐一排查:

  1. OpenClaw 是否在运行? 检查你的终端窗口。如果终端已经关闭了、或者显示了报错信息后停止了,说明 OpenClaw 没在运行。重新启动它。
  2. 渠道是否连接成功? 看终端输出中是否有类似 connected successfullyWaiting for messages 的提示。如果没有,说明渠道本身就没连上,检查凭证是否正确。
  3. 是否完成了配对? 如果没配对,OpenClaw 收到消息也不会回复。执行 openclaw pairing list <渠道名> 检查是否有待批准的配对请求。
  4. AI 模型是否正常? 在 OpenClaw 的浏览器界面(Web UI)里发同样的消息试试。如果浏览器里也不回复,说明是 AI 模型配置的问题(比如 API Key 过期、模型地址填错),不是渠道的问题。请查阅模型配置文档(06 号文档)。
  5. 网络是否通畅? 特别是使用海外服务(Discord、Telegram)的用户,确认代理/VPN 正常工作,且终端环境也走了代理。

Q2:配对失败

症状:执行 openclaw pairing approve 后系统提示失败或无反应。

排查清单:

  • 配对码是否输错了? 注意区分大小写、不要多打空格。建议直接从 openclaw pairing list 的输出中复制。
  • 配对码是否过期了? 配对码通常有几分钟的有效期。如果过期了,在聊天软件里重新给 Bot 发一条消息,会生成新的配对码。
  • 渠道名是否拼对了? 比如飞书是 feishu、Telegram 是 telegram、Discord 是 discord(注意全小写)。
  • OpenClaw 版本是否太旧? 尝试更新到最新版。

Q3:提示 "unauthorized" 或 "401"

含义:你提供的凭证(Token、App ID、App Secret 等)不正确或已经过期失效。

解决方法:

  1. 回到对应平台的开发者后台,确认你的凭证没有被重置或过期。
  2. 重新复制凭证。常见的坑:复制时多了一个空格、少了一个字符、或者复制了旧的 Token。
  3. 删除旧渠道并重新添加:
bash
openclaw channels remove <渠道>
openclaw channels add
# 重新选择渠道并填写正确的凭证

Q4:渠道连接断开

检查终端是否有 connection lost 等错误日志。常见原因:网络波动(等一两分钟看是否自动重连)、电脑休眠、Token 被重置。兜底方案:重启 OpenClaw。

Q5:回复速度很慢

先在浏览器 Web UI 里发同样的问题。如果也慢,是模型本身的问题(换更快的模型或检查 API 网络);如果浏览器里快但渠道里慢,检查代理/VPN 速度。

Q6:能收到消息但不能发出回复

排查权限:飞书检查 im:message:send_as_bot、Discord 检查 Send Messages、Slack 检查 chat:write。也可能是 Bot 在群组中被禁言。

Q7:多渠道同时用会冲突吗?

不会。各渠道独立运行、独立配对、独立对话记录,互不干扰。

Q8:怎么删除一个渠道

bash
openclaw channels remove <渠道名>

删除后平台上的 Bot 还在,但不再回复消息。重新接入只需 openclaw channels add


本文档版本 V2.0,更新于 2026 年 3 月 11 日。如有疏漏或过时内容,欢迎反馈。