乐于分享
好东西不私藏

【AI学习】10分钟教你OpenClaw怎么接入飞书?保姆级教程(附图文)

【AI学习】10分钟教你OpenClaw怎么接入飞书?保姆级教程(附图文)

#OpenClaw从入门到实战#AIAgent#开源项目

本文目标

读完本文,你将学会:

  • 在飞书开放平台创建机器人应用

  • 配置事件订阅实现消息互通

  • 在飞书中与OpenClaw对话交互

  • 为后续自动化办公打下基础


锅头导读

上一篇《【AI学习】OpenClaw怎么一键部署?扣子3分钟零门槛搭建教程》发布后,很多朋友问锅头:

"部署是部署好了,但每次都打开扣子网页太麻烦,能不能直接在飞书里用?"

答案是:当然可以!

今天这篇就是来解决这个问题的。锅头会手把手教你,把已经部署好的OpenClaw接入飞书,实现:

  • 对话交互:直接在飞书里和OpenClaw聊天对话

  • 随时随地:手机、电脑上的飞书都能用

  • 实时响应:消息秒回,就像和一个聪明助手聊天

  • 未来可期:今天学会接入,明天就能让它帮你写文档、干农活

跟着做,10分钟就能让你的OpenClaw"入住"飞书。


一、接入前准备

1.1 前置条件检查

在开始之前,请确保你已经完成以下准备:

检查项

状态

说明

OpenClaw部署

必须完成

参考系列第2篇,扣子一键部署

飞书账号

必须注册

个人或企业账号均可

扣子积分

确保充足

对话会继续消耗积分

锅头提示:
 如果你还没部署OpenClaw,请先返回系列第2篇完成部署。接入飞书的前提是OpenClaw已经在扣子后台运行中。

1.2 了解接入原理

简单说,飞书接入是通过飞书开放平台创建一个机器人应用,然后把这个应用的凭证告诉OpenClaw,OpenClaw就能通过飞书的API收发消息了。

消息流程:

你发送消息 → 飞书服务器 → OpenClaw(扣子沙箱)→ AI处理 → 飞书服务器 → 你收到回复

核心概念:飞书机器人应用 = 一座桥梁,连接你的飞书账号和OpenClaw AI大脑

关键点: OpenClaw需要24小时运行才能实时响应,所以必须保持"部署"状态。

为什么这很重要?

接入飞书后,你不仅能和AI对话,更重要的是——

  • 可以边聊天边让它写文档

  • 可以语音说需求,AI自动执行

  • 可以成为你的智能办公助理

今天学会接入,明天就能让它帮你写飞书云文档、整理资料、干活。


二、创建飞书机器人应用

步骤1:进入飞书开放平台

登录飞书开放平台(open.feishu.cn/app),点击【创建企业自建应用】。

锅头提示:
 个人用户没有企业也可以创建,飞书支持个人开发者模式。

步骤2:填写应用信息

根据页面提示配置应用名称、应用描述及应用图标,然后点击【创建】。

步骤3:添加机器人

进入新创建好的“Openclaw助手(锅头1号员工)”企业自建应用页面后,咱们找到左侧【应用能力】-【添加应用能力】-【按能力添加】-【机器人】,然后点击【+添加】。

机器人添加成功后,自动跳转进入机器人页面。

步骤4:配置权限

接下来,咱们要对机器人配置权限。

点击左侧菜单【开发配置】-【权限管理】,进入权限管理页面,然后点击【批量导入/导出权限】。

在导入页面窗口中导入如下权限替换掉官方示例,点击【下一步,确认新增权限】。

附权限json内容如下:

{  "scopes": {    "tenant": [      "im:chat:read",      "im:chat:update",      "im:message.group_at_msg:readonly",      "im:message.p2p_msg:readonly",      "im:message.pins:read",      "im:message.pins:write_only",      "im:message.reactions:read",      "im:message.reactions:write_only",      "im:message:readonly",      "im:message:recall",      "im:message:send_as_bot",      "im:message:send_multi_users",      "im:message:send_sys_msg",      "im:message:update",      "im:resource",      "contact:contact.base:readonly"    ],    "user": [      "contact:user.employee_id:readonly"    ]  }}

确认导入权限无误后,点击【申请开通】。

申请开通后,提示“应用身份权限”可访问的数据范围,锅头在这里点击【确认】。

步骤5:获取凭证

然后咱们点击左侧菜单中【基础信息-凭证与基础信息】,获取应用凭证App ID和 App Secret,用于配置Openclaw。

记录以下信息(后面会用到):

  • App ID(应用ID)

  • App Secret(应用密钥)

安全提醒:
 App Secret 非常重要,不要泄露给别人!

步骤6:发布机器人版本

然后点击【创建版本】。

进入创建新版本页面后,输入应用版本号和更新说明,点击【保存】。

弹窗提示“确认提交发布申请?”,点击【确认发布】。

可以看到版本已发布。


三、配置飞书消息订阅

步骤6:配置飞书渠道

这时候,咱们再回到扣子编程平台的Openclaw预览窗口界面,配置飞书渠道对话窗口。

直接输入对话内容:

帮我配置飞书渠道

App ID :{替换为你的飞书应用 App ID}

App Secret:{替换为你的飞书应用 App Secret}

点击【Send】发送后,大约1分钟得到反馈说“飞书渠道配置成功”。

锅头特意留意了下积分消耗情况,配置成功后,大概消耗300积分,积分消耗用量已经从103积分提升到了401积分。

步骤7:配置飞书事件订阅

接着,咱们再回到飞书开放平台,点击进入刚才创建好的企业自建应用“Openclaw助手(锅头的1号员工)”。

点击【开发配置-事件与回调】-【事件配置-订阅方式】,修改订阅方式。

选择“使用 长连接 接收事件”,点击【保存】。

这时候可以点击【添加事件】。

进入添加事件界面,搜索“接收消息”,这时候在应用身份订阅页签下勾选【接收消息】,点击【确认添加】。

点击成功后,可以看到已添加事件中多了接收消息事件。

步骤8:添加群组消息权限

锅头还想将机器人添加到聊天群组中使用,这时候还需开通获取群组消息权限,点击【查看其他权限】。

展开所有权限后,点击【获取群组中所有消息(敏感权限)】,弹窗后点击【开通权限】。

这时候看到获取群组中所有消息权限已开通,接着点击【回调配置】进入回调配置界面,订阅方式也同样选择“使用 长连接 接收回调”后,点击【保存】。

到这里,群组消息也配置完成。

步骤9:创建版本发布

接着,点击【创建版本】。

进入创建版本界面后,输入版本号、更新说明后,点击【保存】,弹窗后点击【确认发布】。

可以看到1.0.1版本发布成功。

步骤10:开始使用

接着,咱们在飞书中跟Openclaw助手(锅头1号员工)发起对话,例如继续输入“你好”,此时会收到一段英文提示,说还不能用。需要在飞书和Openclaw中配对。

这时候,咱们直接复制这段句话,粘贴到Openclaw助手(锅头1号员工)预览聊天窗口中,让Openclaw自己完成配对工作。

到这里,咱们完成了Openclaw助手(锅头1号员工)接入飞书渠道工作。


四、开始使用飞书OpenClaw助手

最后,咱们在飞书中跟Openclaw助手(锅头1号员工)开始对话和下指令吧。

体验如下:

后面,锅头会给大家分享更多实战体验效果,敬请期待哦。


五、常见问题(FAQ)

Q1:机器人不回复消息怎么办?

按以下顺序排查:

  1. 检查OpenClaw部署状态

    1. 登录扣子平台,确认OpenClaw处于"已部署"状态

    2. 如未部署,点击【部署】按钮

  2. 检查事件订阅验证状态

    1. 进入飞书开放平台→事件订阅

    2. 确认显示【已验证】绿色标识

    3. 如未验证,重新检查配置

  3. 检查扣子积分余额

    1. 积分不足会导致服务暂停

    2. 建议保持充足积分(至少10000+)

  4. 检查飞书应用发布状态

    1. 进入【版本管理与发布】

    2. 确认应用已发布且审核通过

  5. 查看扣子平台日志

    1. 在OpenClaw项目页面查看运行日志

    2. 确认是否收到飞书的请求

Q2:回复速度很慢?

可能原因:

  • 扣子沙箱资源紧张(高峰期)

    • 建议错峰使用,或等待几秒再试

  • 问题太复杂,AI处理时间长

    • 简单问题3-5秒回复

    • 复杂问题可能需要10-30秒

  • 网络延迟

    • 检查网络连接

    • 尝试切换网络环境

优化建议: 如果超过30秒未回复,可以尝试重新发送消息。

Q3:对话消耗多少积分?

参考数据:

对话类型

积分消耗

说明

普通对话

100-500积分/次

简单问答、闲聊

联网查询

500-1500积分/次

查询天气、新闻等

长文本生成

1000-3000积分/次

写文章、生成代码

省钱技巧:
 开启部署后持续运行,但不要同时开启多个对话窗口。建议定期监控积分使用情况。

Q4:可以同时给多个人用吗?

个人应用: 默认只能你自己使用。

分享给朋友使用的方法:

  1. 进入飞书开放平台【版本管理与发布】

  2. 修改"可用范围"为【指定成员】

  3. 添加朋友的飞书账号

  4. 点击【申请发布】等待审核

  5. 审核通过后,朋友就能在飞书搜索到该机器人

注意:
 分享后,所有使用者的对话都会消耗你的扣子积分。

Q5:接入飞书安全吗?

安全性分析:

方面

安全性

说明

数据隔离

OpenClaw运行在扣子沙箱,与系统隔离

凭证存储

App Secret存储在扣子环境,不会泄露

消息传输

飞书服务器会暂存消息内容

敏感信息

不要在对话中分享API Key等敏感信息

安全建议:

  • 定期轮换凭证(建议每月一次)

  • 不要在群里分享敏感信息

  • 仅为可信用户开放使用权限


六、学习回顾

核心知识点

接入流程4大步:

  1. 创建应用 → 飞书开放平台创建机器人应用

  2. 获取凭证 → 记录App ID和App Secret

  3. 配置对接 → 扣子平台添加飞书渠道

  4. 发布使用 → 创建版本发布,飞书里搜索使用

关键配置:

配置项

作用

App ID / App Secret

应用的"身份证"和"密码"

事件订阅

让OpenClaw知道有人发消息了

进阶方向:

  • 云文档写作:边聊天边写文档

  • 资料整理:语音说需求,AI自动执行

  • 群聊接入:把机器人拉进群,@它提问

注意事项

安全:

  • App Secret不要泄露

  • 定期轮换凭证

  • 不要在对话中分享敏感API Key

成本:

  • 对话会持续消耗积分

  • 联网查询比普通对话更贵

  • 建议监控积分使用情况

稳定:

  • 保持OpenClaw部署状态

  • 定期检查事件订阅验证状态


七、课后练习

思考题: 为什么接入飞书需要配置"事件订阅"?如果不配置会怎样?

实践题:

  1. 按照本文步骤,成功把OpenClaw接入飞书

  2. 尝试提问:"你能帮我做什么?"了解它的能力边界


八、参考资料

[1] 飞书开放平台文档《机器人开发指南》:https://open.feishu.cn/document/home/develop-a-bot

[2] 扣子官方文档《配置飞书渠道》:https://docs.coze.cn/tutorial/feishu

[3] OpenClaw官方文档《Channels配置》:https://docs.openclaw.ai/channels


【互动一下】


【下篇预告】 

《飞书聊天就能写文档?OpenClaw自动化办公实战》——不用打开文档编辑器,直接在飞书聊天窗口告诉AI你的需求,它自动帮你:

  • 创建飞书云文档

  • 收集情报信息

  • 生成工作复盘报告

动动嘴就把活儿干了,这才是AI办公的正确姿势。

【资料领取】

关注公众号「跟锅头一起学AI」,回复【AI手册】领取: 《零基础学习使用AI工具——快速入门手册》