OpenClaw 本身功能很强,但很多人装完之后只用命令行或者 Web UI 来跑任务,有点可惜。把 OpenClaw 接入飞书之后,你可以直接在飞书对话框里给 Agent 发指令、收结果、管任务——团队协作场景下特别顺手。这篇文章把整个接入流程走一遍,操作比你想的简单。
为什么要让openclaw接入飞书
最直接的理由:你本来就在飞书里工作。与其在命令行和飞书之间来回切换,不如直接让 Agent 住进飞书,想用的时候@一下就行。
具体好处有几个:一是随时随地可以触发任务,手机上也能用;二是团队成员可以共用同一个 Agent,不需要每个人都装 OpenClaw;三是结果可以直接在飞书群里分享,不需要再手动复制粘贴。
接入前准备
需要准备两样东西:
- 一个正常运行的 OpenClaw 实例(本地或云端都行)
- 飞书开发者账号,有权限创建企业自建应用
飞书这边需要在开发者后台创建一个自建应用,拿到 App ID 和 App Secret。整个过程不需要写任何代码,飞书的开发者后台操作还算直观。
第一步:在飞书创建自建应用
登录飞书开发者后台(open.feishu.cn),点击「创建企业自建应用」,填好应用名称和描述。名字随便起,比如「OpenClaw Bot」或者你自己的项目名都行。
创建完成后,进入应用详情页,把 App ID 和 App Secret 复制下来,后面要用。然后在「权限管理」里,至少开启以下权限:
- 读取消息(im:message:receive_v1)
- 发送消息(im:message)
- 读取用户信息(contact:user.id:readonly)
权限申请完记得发布应用版本,否则权限不会生效。
第二步:在 OpenClaw 里配置飞书 Channel
打开 OpenClaw 的配置文件(或者通过 Gateway 的 Config 视图),找到 Channels 配置部分,添加飞书 Channel:
channels:
feishu:
app_id: "你的App ID"
app_secret: "你的App Secret"
verification_token: "飞书后台的Verification Token"
Verification Token 在飞书开发者后台的「事件订阅」页面里可以找到。配置好之后重启 OpenClaw Gateway,Channel 就会激活。
第三步:配置飞书消息事件订阅
回到飞书开发者后台,在「事件订阅」里填入 OpenClaw 的 Webhook 地址。地址格式一般是:
https://你的OpenClaw域名/channel/feishu/webhook
本地部署的话,需要用 ngrok 或者其他内网穿透工具把本地端口暴露出去,飞书的服务器才能回调到你的 OpenClaw 实例。云端部署就没这个问题,直接填公网地址就行。
然后在「事件」列表里,订阅「接收消息(im.message.receive_v1)」这个事件。保存配置,飞书会发一个验证请求到你的 Webhook 地址,OpenClaw 收到后自动回复,验证通过就完成了。
第四步:把 Bot 加到飞书群或对话
在飞书里搜索你的应用名称,把它添加为联系人或者加入到目标群组。加好之后,直接发一条消息试试,格式跟平时给 OpenClaw 发指令一样。
在群里使用的话,需要 at 机器人,比如「@OpenClaw Bot 帮我搜索最新的 AI 新闻」。私信模式则不需要 at,直接发就行。
几个实用的使用姿势
接入之后最常用的几个场景:
每日简报:配合 OpenClaw 的定时任务,设置每天早上 8 点自动聚合昨日 AI 资讯、发到指定飞书群。团队里的人打开飞书就能看到,不需要有人专门整理。
即时信息查询:在飞书群里直接问 Agent「帮我查一下 XXX 的最新动态」,Agent 去搜索、整理、回复,比自己去搜要快。
任务触发:给 Agent 发「帮我把这份文档翻译成英文」「帮我整理这周的会议记录」,Agent 处理完直接回复到飞书,结果随手可得。
openclaw接入飞书的常见问题
发消息没有回复:先检查 OpenClaw Gateway 是否在运行,然后查看 Channel 配置是否正确,最后确认飞书的事件订阅验证是否通过。Gateway 日志里一般会有明确的错误提示。
本地部署回调失败:这基本就是内网穿透的问题。ngrok 免费版有连接时间限制,频繁断开会导致 Webhook 失效。生产环境建议用云端部署或者有稳定公网 IP 的服务器。
权限报错:飞书的权限申请需要审核,企业内部应用一般很快,但如果申请了权限没有发布新版本,权限是不生效的。确认在飞书后台把应用版本发布了。
接入 Telegram 是类似流程
如果你更常用 Telegram,接入方式类似:在 BotFather 那里创建一个 Bot 拿到 Token,填进 OpenClaw 的 Channel 配置里,设好 Webhook,就跑起来了。社区里有很多现成的 Telegram 接入教程,步骤更少,对于个人用户来说往往比飞书更快上手。
两个平台各有适合的场景:飞书更适合团队协作、企业内部使用;Telegram 更适合个人使用、快速触发任务。根据你的实际情况选就行。
