乐于分享
好东西不私藏

OpenClaw飞书官方插件部署指南

本文最后更新于2026-03-10,某些文章具有时效性,若有错误或已失效,请在下方留言或联系老夜

OpenClaw飞书官方插件部署指南

之前大家部署 OpenClaw 飞书机器人时,主要使用的是 OpenClaw 内置的飞书能力。现在飞书官方推出了官方插件,提供了更完整的能力,包括日历、任务、多维表格、云文档等高级功能的打通。

可以看一下整个OpenClaw的整体架构图。

用户层接入各种通讯渠道(飞书、Telegram、Discord 等),用户在哪里发声,AI 就在哪里回应;网关层(Gateway)负责接收消息、路由分发和安全验证,是整个系统的入口;代理层(Agent)是 AI 的大脑,它管理对话上下文、选择合适的工具、调用大模型生成回复;工具层(Tools)则是 AI 的四肢,内置了文件读写、命令执行、浏览器控制等通用能力,还可以扩展飞书官方插件来操作日历/任务/文档等企业数据。

记忆系统贯穿整个 Agent 层,Agent 在处理对话时会读取和写入记忆。

今天给大家实践一下怎么让你的OpenClaw接入飞书机器人,并部署飞书官方的插件的。

OpenClaw本地部署可参考:

OpenClaw本地部署及入门教程

1 创建飞书企业自建应用

1.1 创建企业自建应用

1、登录飞书开发者后台:https://open.feishu.cn/app?lang=zh-CN点击创建企业自建应用。

2、填写应用名称和应用描述,名称随意。点击创建按钮。

1.2 添加应用能力

在能力列表中,选择机器人,点击添加按钮。

1.3 添加应用权限

找到左侧权限管理,点击批量导入/导出权限。

复制下面这段代码进去,点击新增权限。

{"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"]}}

点击申请开通。

开通好后会在列表中显示出来。

1.4 获取应用凭证

点击左侧目录凭证与基础信息,记录好App ID和App Secret的值。

2 安装飞书官方插件

我的命令适用于 Windows PowerShell 环境,如果是其他环境需要修改一下。

1、设置 npm 的包下载源为官方源:https://registry.npmjs.org

npm config set registry https://registry.npmjs.org

2、使用 curl 工具下载飞书的 npm 安装包并保存到临时目录

curl-o"$env:TEMP\feishu.tgz" https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/195a94cb3d9a45d862d417313ff62c9c_gfW8JbxtTd.tgz

3、使用 npm 全局安装刚才下载到临时目录的飞书安装包

npm install -g"$env:TEMP\feishu.tgz"

4、清理临时安装包Remove-Item “$env:TEMP\feishu.tgz” -Force

Remove-Item"$env:TEMP\feishu.tgz"-Force

5、安装飞书插件

feishu-plugin-onboard install

6、重启网关

openclaw gateway run --allow-unconfigured

3 订阅事件与发布应用

3.1 事件配置

在左侧目录找到事件与回调,订阅方式选择长连接。

点击添加事件,选择接收消息事件。

3.2 回调配置

回调配置中选择长连接。

添加回调,选择卡片回传交互。

3.3 发布应用

选择创建版本:

填写版本号和更新说明

4 与飞书完成配对与配置

4.1 找到你的机器人

开发者小助手会将审批通过的应用推送到你的消息界面,打开应用。

4.2 完成配对

给机器人随便发送一条消息。

复制这个消息到OpenClaw的web界面中。

4.3 批量权限授权

在飞书中输入下面命令完成授权。

/feishu auth

4.4 开启流式输出

在飞书中输入下面命令开启流式输出。

openclaw config set channels.feishu.streaming true

流式模式开启后需要重启Gateway,咱们让小龙虾自己重启就好了。

可以看到弹出命令行重启网关了。

4.5 验证安装是否成功

1、检查飞书插件状态

/feishu start

2、检查配置是否正常,如果有未通过的项就让小龙虾自己解决就OK了。

/feishu doctor

5 实战应用

到此为止,我们就可以愉快地在飞书和自己的小龙虾交流了。比如创建一个多维表格。

学废了或有启发,别忘了顺手给我点个赞、在看、转发,三连~因为你的反馈真的很重要!如果想第一时间收到推送,也可以给我个星标⭐

OpenClaw本地部署及入门教程

当OpenClaw遇到钉钉AI表格,办公效率瞬间起飞
本站文章均为手工撰写未经允许谢绝转载:夜雨聆风 » OpenClaw飞书官方插件部署指南

评论 抢沙发

4 + 9 =
  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
×
订阅图标按钮