乐于分享
好东西不私藏

OpenClaw接入飞书全流程:让AI在飞书群里帮你干活

OpenClaw接入飞书全流程:让AI在飞书群里帮你干活

装完OpenClaw之后,很多朋友问:能不能不开网页,直接在飞书上指挥它?答案是可以。今天胖豆手把手教你把OpenClaw接入飞书,实现在聊天窗口里直接让AI帮你干活。


为什么要接入飞书?

上几篇教程里,我们一直通过浏览器打开 http://127.0.0.1:18789 的WebChat来跟OpenClaw对话。能用,但不够方便——你得专门开个浏览器窗口,来回切换。
接入飞书之后,体验完全不一样了:
你在飞书里直接@机器人,它就帮你干活。跟同事聊天的间隙,顺手让AI帮你处理个文件、查个数据、写段代码,无缝衔接。
而且飞书是国内OpenClaw用户最主流的选择——中文界面、文档齐全、开放能力强,比Telegram和Discord对国内用户友好太多了。
飞书甚至推出了OpenClaw官方插件,说明官方也在认真推这个生态。
好了,废话不多说,开干。

前置条件

在开始之前,请确认:
✅ 你已经按照第三篇教程成功安装了OpenClaw
✅ OpenClaw的Gateway服务正在运行(openclaw gateway status 能看到状态)
✅ 你有一个飞书账号(个人免费版就够用)
如果OpenClaw还没装好,先去翻我的第三篇文章《Windows部署OpenClaw保姆级教程》。

整体流程预览

飞书接入一共分5大步,先给你一个全景图,心里有数:
在飞书开放平台创建应用
获取App ID和App Secret
在OpenClaw中配置飞书通道
回到飞书配置权限和事件订阅
发布应用,测试对话
看起来步骤多,但跟着走其实就是"飞书点点点 → 终端敲几行命令 → 飞书再点点点"的节奏。大概20-30分钟能搞定。

第一步:在飞书开放平台创建应用

打开浏览器,访问飞书开放平台:
用你的飞书账号登录
点击右上角「开发者后台」
点击「创建企业自建应用」
填写应用信息:
创建完成后,你会进入应用的管理界面。

💡 胖豆提示: 飞书免费版就能创建自建应用,不需要付费。


第二步:获取App ID和App Secret

在应用管理界面,找到「凭证与基础信息」页面。
你会看到两个关键信息:
App ID
(以 cli_ 开头)
App Secret
把这两个值复制下来,保存好,后面要用。

⚠️ 安全提醒: App Secret相当于你应用的密码,不要分享给任何人,不要贴到公开的地方。


第三步:在OpenClaw中配置飞书通道

回到你的电脑,打开PowerShell,执行以下命令配置飞书:
powershell

启用飞书通道

openclaw configsetchannels.feishu.enabled true

填入你的App ID(替换成你自己的)

openclaw configsetchannels.feishu.accounts.main.appId"cli_你的AppID"

填入你的App Secret(替换成你自己的)

openclaw configsetchannels.feishu.accounts.main.appSecret"你的AppSecret"

设置机器人名称

openclaw configsetchannels.feishu.accounts.main.botName"我的AI助手"

使用WebSocket长连接模式(推荐,不需要公网IP)

openclaw configsetchannels.feishu.connectionMode websocket

设置私聊策略为配对模式

openclaw configsetchannels.feishu.dmPolicy pairing

设置群聊需要@才回复

openclaw configsetchannels.feishu.requireMention true

配置完成后,重启Gateway让配置生效:
powershell

openclaw gateway restart

💡 胖豆踩坑笔记: 如果你之前安装过旧版的第三方飞书插件,建议先卸载干净再配置。新版OpenClaw已经内置了官方飞书支持,不需要额外装插件了。如果是老版本,可能需要执行 openclaw plugins install @openclaw/feishu 来安装飞书插件。


第四步:回到飞书配置权限和事件

这一步回到飞书开放平台的应用管理界面,需要配置三样东西。
4.1 添加机器人能力
左侧菜单 →「应用能力」→ 找到「机器人」→ 点击「添加」
添加后给机器人起个名字就行。
4.2 配置权限
左侧菜单 →「权限管理」→ 点击「批量导入」
粘贴以下权限JSON,一键导入:
json

[

"im:message",

"im:message.group_at_msg",

"im:message.group_at_msg:readonly",

"im:message.p2p_msg",

"im:message.p2p_msg:readonly",

"im:message:send_as_bot",

"im:resource",

"contact:user.id:readonly"

]

这些权限让机器人能收发消息、读取被@的内容、发送回复。

💡 胖豆提示: 如果你希望机器人能做更多事情(比如读写文档、管理日历),可以后续在权限管理里按需添加更多权限。先把基础的跑通再说。

4.3 配置事件订阅
左侧菜单 →「事件与回调」「事件配置」
订阅方式选择:「使用长连接接收事件(WebSocket)」
然后添加事件:搜索并添加 im.message.receive_v1(接收消息事件)
点击保存。

第五步:发布应用并测试

5.1 发布应用
左侧菜单 →「版本管理与发布」→ 点击「创建版本」
填写版本号和更新说明(随便写),然后提交发布。
如果是个人飞书(不是企业),发布后直接就能用。如果是企业飞书,可能需要管理员审批。
5.2 测试对话
打开飞书客户端,找到你刚才创建的机器人(在应用列表或搜索栏搜名字)。
发送一条消息:"你好,请介绍一下你自己"
如果机器人正常回复了——恭喜,飞书接入成功!
5.3 配对确认
第一次对话时,机器人可能会回复一个配对码。这是OpenClaw的安全机制,需要你确认授权。
回到OpenClaw的WebChat界面(http://127.0.0.1:18789),在里面输入配对码完成确认。这是一次性操作,后面就不需要了。

接入成功后能做什么?

飞书接入成功后,你可以这样玩:
场景1:工作中随手指挥AI
在飞书里跟同事聊完工作,顺手切到机器人窗口:"帮我把今天讨论的3个待办事项整理成清单"。
场景2:群里@机器人协助
在工作群里@机器人:"帮我总结一下刚才大家讨论的核心结论"(需要给机器人加入群聊的权限)。
场景3:手机上也能用
飞书有手机端,接入之后你在手机上也能跟OpenClaw对话。躺在沙发上用手机指挥电脑上的AI干活,这感觉绝了。
场景4:定时任务提醒
配合OpenClaw的cron功能,让机器人每天早上在飞书给你发一份今日待办和天气预报。

常见问题排查

Q:机器人不回复消息
检查清单:
OpenClaw的Gateway是否在运行?执行 openclaw gateway status 确认
查看日志:openclaw logs --follow,看有没有报错
确认飞书应用已发布(测试版也行)
确认已添加 im.message.receive_v1 事件订阅
确认连接模式是WebSocket
Q:提示权限不足
回到飞书开放平台 → 权限管理,检查是否缺少必要权限。添加权限后需要重新发布版本才能生效。
Q:群里@机器人没反应
检查两点:
机器人是否已加入该群
OpenClaw配置中 requireMention 是否设为 true(设为true则必须@才会回复)
Q:配对码在哪里确认?
打开浏览器访问 http://127.0.0.1:18789,在WebChat里告诉OpenClaw配对码即可。你也可以直接执行命令:
powershell

openclaw devices approve <配对码>


安全注意事项(认真看)

飞书接入之后,机器人是以你的身份在运作的。这意味着:
① 它发的消息就是"你发的"。AI代你在飞书里发的消息,对方看到的发送者就是你。发出去就收不回来了。所以涉及重要沟通的操作,务必先预览再确认,不要让AI全自动运行。
② 先用个人账号玩,别急着上公司账号。等你熟悉了OpenClaw的行为模式,确认它不会乱发消息之后,再考虑接入工作环境。
③ 定期检查权限范围。不需要的权限不要给。机器人能读到的信息越少,风险越小。

完整流程回顾

再走一遍:
✅ 飞书开放平台创建自建应用
✅ 复制App ID和App Secret
✅ 在OpenClaw终端配置飞书通道参数
✅ 飞书侧添加机器人能力 + 导入权限 + 事件订阅
✅ 发布应用,飞书里发消息测试
✅ 完成配对确认
整个过程大约20-30分钟。一旦配好,以后就是打开飞书直接聊的事了。

下篇预告

OpenClaw系列到这里告一段落。我们已经完成了:认识它→安装它→体验它→接入飞书。你的私人AI助手已经就位了。
下一篇我们换个话题,聊一个很多人都在想但不好意思问的问题——
《AI会取代程序员吗?一个老程序员的真心话》
结合VibeCoding的爆发、Spotify工程师不再写代码的新闻,以及我自己作为程序员的真实感受,跟你聊聊AI对我们这行的真实影响。不贩卖焦虑,只说真话。
别人聊概念,我动手给你看。
我们下篇见。✌️