告别复制粘贴!OpenClaw飞书官方插件安装教程,10分钟搞定AI数字员工
|
类别 |
能力 |
|
💬 消息 |
消息读取(群聊/单聊历史、话题回复)、消息发送、消息回复、消息搜索、图片/文件下载 |
|
📄 文档 |
创建云文档、更新云文档、读取云文档内容 |
|
📊 多维表格 |
创建/管理多维表格、数据表、字段、记录(增删改查、批量操作、高级筛选)、视图 |
|
📅 日历日程 |
日历管理、日程管理(创建/查询/修改/删除/搜索)、参会人管理、忙闲查询 |
|
✅ 任务 |
任务管理(创建/查询/更新/完成)、清单管理、子任务、评论 |
我知道很多人看到”安装插件”就头疼,担心技术门槛太高。放心,我保证用最通俗的语言,让你10分钟就能搞定。
第一步:准备工作(2分钟)
你需要准备两样东西:
-
已经安装好的OpenClaw
-
如果你还没装,去openclaw.ai 按照官方教程安装
https://docs.openclaw.ai/install/development-channels#switching-channels -
版本要求:Linux/Mac用2026.2.26以上,Windows用2026.3.2以上
-
检查版本的命令:
openclaw -v -
升级版本命令:
npm install -g openclaw -
一个飞书应用
-
打开飞书开放平台
-
点击”创建企业自建应用”

-
配置应用名、描述及图标,单击“创建”按钮,完成操作

-
添加机器人能力。
在左侧目录树选择“应用能力 > 添加应用能力”。 选择“按能力添加”页签,单击“机器人”能力卡片的“添加”按钮。 
-
配置权限。
在左侧目录树选择“开发配置 > 权限管理”,单击“批量导入/导出权限”按钮。

在“导入”页签中,将如下权限替换原有示例,单击“下一步,确认新增权限”按钮。
{"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.send_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"]}}
在弹窗中确认权限无误后,单击“申请开通”按钮,完成操作。
相关权限的具体含义可查看飞书API权限列表。

(5)发布应用。
单击顶部的“创建版本”按钮。
记住生成的App ID和App Secret(后面要用)

第二步:一键安装插件(1分钟)
不要被代码吓到,就是复制粘贴:(根据自己操作系统类型来选择执行的命令)
如果你是Mac或Linux用户:
npm config set registry https://registry.npmjs.org
curl -o /tmp/feishu.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/4d184b1ba733bae2423a89e196a2ef8f_QATOjKH1WN.tgz
npm install /tmp/feishu.tgz -g
rm /tmp/feishu.tgz
feishu-plugin-onboard install上面的命令一行一行复制,执行完一行再执行下一行,直到5条命令都执行完成
如果你是Windows用户:
npm config set registry https://registry.npmjs.org
curl -o "%TEMP%\feishu.tgz" https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/c53145d7b9eb0e29f4e07bf051231230_XjCy46mAFI.tgz
npm install -g "%TEMP%\feishu.tgz"
del "%TEMP%\feishu.tgz"
feishu-plugin-onboard install上面的命令一行一行复制,执行完一行再执行下一行,直到5条命令都执行完成
简单解释一下:
-
第一行:设置软件源,确保下载快
-
第二行:下载插件安装包
-
第三行:安装插件
-
第四行:清理临时文件
-
第五行:开始安装向导
第三步:配置和授权(2分钟)
安装过程中,系统会问你:
-
“是否沿用历史飞书应用?” → 选”否”,用我们刚创建的应用
-
输入App ID和App Secret → 粘贴刚才记下的那两个字符串

-
运行命令启动服务
openclaw gateway run出现下面这段说明插件已经开始监听飞书的事件,启动成功。

运行
openclaw plugins listID为 feishu-openclaw-plugin 的 Status 为 loaded ,ID为 feishu 的 Status 为 disabled 则标明已成功启用飞书官方插件。

关键一步:授权
-
在飞书里给你的机器人发条消息
-
机器人会回复一个配对码(5分钟内有效)
-
回到终端,输入:
openclaw pairing approve feishu <配对码> --notify -
在飞书里点击授权
完成! 输入/feishu start测试,如果看到版本号,就成功了。
如何配置流式输出
如果想要切换到流式输出怎么配置?
切换到流式输出,可运行指令:openclaw config set channels.feishu.streaming true
不用流式输出 可以通过运行指令:openclaw config set channels.feishu.streaming false
流式输出卡片上支持显示更多内容openclaw config set channels.feishu.footer.elapsed true // 开启耗时openclaw config set channels.feishu.footer.status true // 开启状态展示
常见问题
1、如何更新插件?
运行下面代码:
feishu-plugin-onboard update
feishu-plugin-onboard doctor

feishu-plugin-onboard doctor --fix

夜雨聆风
