图文并茂2分钟教会你用飞书聊天就可以控制大龙虾OpenClaw | Connect Clawdbot to Feishu Tutorial
@
- 图文并茂2分钟教会你用飞书聊天就可以控制大龙虾OpenClaw | Connect Clawdbot to Feishu Tutorial
- 📚 官方文档 | Official Documentation
- 🌟 第一步：安装飞书插件 | Install Feishu Plugin
- 🎉 插件安装成功！
- 🌟 第二步：开始配置飞书 | Configure Feishu
- 🚀 第一步：创建飞书自建应用 | Create Feishu Custom App
- 🔑 第二步：获取 App ID 和 App Secret | Get App Credentials
- 🌟 第三步：启用机器人能力 | Enable Bot Capabilities
- 🔧 第四步：配置应用权限 | Configure App Permissions
- 🎯 第五步：配置 OpenClaw | Configure OpenClaw
- 🌟 第六步：设置事件回调 | Configure Event Callback
- 🎯 第七步：发布应用 | Publish Application
- 🎉 完成！测试一下吧 | Testing Time!
- 💖 Conclusion | 结语
宝宝们又来看我啦~👋 今天要教大家一个超实用的技能——让大龙虾AI助手连接飞书！🚀
📚 官方文档 | Official Documentation
- 飞书开放平台文档：https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh
- 飞书国内版文档：https://www.feishu.cn/content/article/7602519239445974205
- GitHub项目地址：https://github.com/m1heng/Clawdbot-feishu
🌟 第一步：安装飞书插件 | Install Feishu Plugin
宝宝们，首先我们要给大龙虾安装飞书插件，让它学会和飞书对话~ 🎯
在OpenClaw界面中输入：
帮我安装Clawdbot plugins install @m1heng-clawd/feishu 这个插件
🎉 插件安装成功！
哇哦~ 看到成功提示了吗？！✨
🌟 第二步：开始配置飞书 | Configure Feishu
🥰！下面是超简单的配置步骤，跟着我一步步来就好啦：
🚀 第一步：创建飞书自建应用 | Create Feishu Custom App
宝宝们，我们要在飞书开放平台创建一个专属应用，让大龙虾能够接入飞书~ 🎯
操作步骤：
1️⃣ 进入飞书开放平台
- 访问：开发者后台 - 飞书开放平台
- 使用飞书账号登录
2️⃣ 创建企业自建应用
- 路径：创建应用 → 企业自建应用
- 填写基础信息（名称、描述等），很简单哒~
- 完成后进入应用详情页
🔑 第二步：获取 App ID 和 App Secret | Get App Credentials
这一步超级重要！我们要获取连接飞书的关键信息~ 🗝️
操作指南：
- 进入应用后台 → 点击「凭证与基础信息」
- 复制关键信息：「App ID」和「App Secret」
⚠️ 重要提醒：这两个值一定要保存好哦！等会儿配置大龙虾的时候会用到～
🌟 第三步：启用机器人能力 | Enable Bot Capabilities
现在我们要给我们的应用添加机器人能力，让它能够收发消息~ 🤖
在【添加应用能力】>【机器人】页面：
- 开启机器人能力 - 把这个开关打开！
- 配置机器人相关设置 - 按提示填写即可
🔧 第四步：配置应用权限 | Configure App Permissions
权限配置很关键哦！我们要让机器人有足够的权限来工作～
在【权限管理】页面：
- 点击【批量导入】按钮
- 粘贴以下JSON配置 - 一键导入所有所需权限！
💡 小贴士：这个JSON包含了所有必要的权限，直接复制粘贴就行，不用一个个手动选择啦～
{"scopes": {"tenant": ["contact:contact.base:readonly","docx:document:readonly","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","application:application:self_manage","cardkit:card:write","cardkit:card:read"],"user": ["contact:user.employee_id:readonly","offline_access","base:app:copy","base:field:create","base:field:delete","base:field:read","base:field:update","base:record:create","base:record:delete","base:record:retrieve","base:record:update","base:table:create","base:table:delete","base:table:read","base:table:update","base:view:read","base:view:write_only","base:app:create","base:app:update","base:app:read","board:whiteboard:node:create","board:whiteboard:node:read","calendar:calendar:read","calendar:calendar.event:create","calendar:calendar.event:delete","calendar:calendar.event:read","calendar:calendar.event:reply","calendar:calendar.event:update","calendar:calendar.free_busy:read","contact:contact.base:readonly","contact:user.base:readonly","contact:user:search","docs:document.comment:create","docs:document.comment:read","docs:document.comment:update","docs:document.media:download","docs:document:copy","docx:document:create","docx:document:readonly","docx:document:write_only","drive:drive.metadata:readonly","drive:file:download","drive:file:upload","im:chat.members:read","im:chat:read","im:message","im:message.group_msg:get_as_user","im:message.p2p_msg:get_as_user","im:message:readonly","search:docs:read","search:message","space:document:delete","space:document:move","space:document:retrieve","task:comment:read","task:comment:write","task:task:read","task:task:write","task:task:writeonly","task:tasklist:read","task:tasklist:write","wiki:node:copy","wiki:node:create","wiki:node:move","wiki:node:read","wiki:node:retrieve","wiki:space:read","wiki:space:retrieve","wiki:space:write_only"]}
}
🎯 第五步：配置 OpenClaw | Configure OpenClaw
现在让我们把刚才获取的App ID和App Secret告诉大龙虾吧～ 🎪
在OpenClaw界面输入：
帮我配置吧，这是我的飞书App ID：xxxx 以及App Secret：xxxx
💡 小贴士：把xxxx替换成你刚才复制的真实值哦！
🌟 第六步：设置事件回调 | Configure Event Callback
这一步很关键哦！我们要让飞书能够把消息传递给大龙虾～ 📡
⚠️ 重要提醒：在配置事件订阅前，请确保完成以下准备：
- ✅ 已运行
openclaw channels add添加Feishu渠道 - ✅ 网关处于启动状态（用
openclaw gateway status检查）
在【事件订阅】页面配置：
1️⃣ 选择连接模式：使用长连接接收事件（WebSocket模式）
2️⃣ 添加订阅事件：im.message.receive_v1（接收消息）
⚠️ 注意：如果网关未启动或渠道未添加，长连接设置会保存失败哦～
🎯 第七步：发布应用 | Publish Application
最后一步啦！我们要把应用发布出去，让大家都能使用～ 🚀
在【版本管理与发布】页面：
1️⃣ 创建新版本 - 填写版本信息
2️⃣ 提交审核并发布 - 点击发布按钮
3️⃣ 等待审批 - 企业自建应用通常自动通过
🔄 需要重启网关
如果配置过程中需要重启，输入：
openclaw gateway restart
小贴士：重启一下让配置生效，这个步骤很重要哦～
🎉 完成！测试一下吧 | Testing Time!
宝宝们，激动人心的时刻到啦！让我们测试一下成果～ ✨
测试步骤：
1️⃣ 在飞书搜索你的机器人名称 → 发个消息试试
2️⃣ 如果一切正常，机器人会回复你哦🥳
3️⃣ 首次对话需要配对 → 让它自己配置就行，你发到框里就可以了
💡 小贴士：第一次对话可能会稍微慢一点，别着急，耐心等待一下～
💖 Conclusion | 结语
-
That's all for today~ | 今天就写到这里啦~
-
Guys, (￣ω￣(￣ω￣〃 (￣ω￣〃)ゝ See you tomorrow~~ | 小伙伴们，(￣ω￣(￣ω￣〃 (￣ω￣〃)ゝ我们明天再见啦~~
-
Everyone, be happy every day! 大家要天天开心哦
-
Welcome everyone to point out any mistakes in the article~ | 欢迎大家指出文章需要改正之处~
-
Learning has no end; win-win cooperation | 学无止境，合作共赢
-
Welcome all the passers-by, boys and girls, to offer better suggestions! ~~~ | 欢迎路过的小哥哥小姐姐们提出更好的意见哇~~
