夜雨聆风
OpenClaw飞书官方插件使用完整指南(公开版)
OpenClaw飞书官方插件使用完整指南（公开版）
先说下飞书官方插件与 OpenClaw 社区原有插件有何区别？
飞书官方插件，能以用户身份读写消息、文档等，体验更丝滑；以下为粗略的对比（由AI整理，供参考）
让你的飞书长出龙虾钳 🦞
你或许早就把小龙虾接到了飞书上，他能帮你写东西、查资料、出方案——但它也经常会说，”我没有飞书文档/消息/日历权限，请把内容发给我”，你不得不反复复制粘贴。
今天，飞书 OpenClaw 官方插件正式上线！【2026.3.6】
在获得你的授权后，OpenClaw 可以直接以你的身份看文档找资料、核对日历看档期、理解群聊上下文。
你说一句话，它就能伸出”钳子”，直接在飞书里帮你把活儿干了。
一、前置准备
安装 openclaw
如果你还没有OpenClaw，可以参照快速上手指南：30 分钟把 OpenClaw 在飞书上配到可用
openclaw 版本限制：
-
Linux/MacOS：openclaw 2026.2.26 及以上 -
Windows：openclaw 2026.3.2 及以上
可通过 openclaw -v 命令查看；如果低于该版本可能出现异常。
升级命令：
npm install -g openclaw
插件最新版本号：2026.3.6
二、安装步骤
1、创建飞书机器人、导入权限
注意：导入完整的权限列表对后续功能的使用体验非常重要（不用经常授权）！！
先创建应用
-
登录飞书开放平台，单击”创建企业自建应用”按钮 -
输入应用名、描述及图标，单击”创建”按钮，完成操作
开启机器人能力
-
添加机器人能力 -
在左侧目录选择”应用能力 – 添加应用能力” -
选择”按能力添加”页签，单击”机器人”能力卡片的”添加”按钮
-
导入所需权限
-
在左侧目录选择”开发配置 > 权限管理”，单击”批量导入/导出权限”按钮 -
在”导入”页签中，将权限配置替换原有示例
-
在弹窗中确认权限无误后，单击”申请开通”按钮，完成操作
发布应用并审核通过
-
发布应用。单击顶部的”创建版本”按钮 -
按需配置应用版本号、默认能力及更新说明等信息
-
单击页面底部的”保存”按钮，创建版本 -
单击页面右上角的”确认发布”按钮，完成应用发布
获取应用凭证
-
在左侧目录选择”基础信息 > 凭证与基础信息” -
在”应用凭证”模块中，获取并记录App ID与App Secret信息
2、安装飞书插件
依次在「终端」app 中执行以下命令：
Linux/MacOS：
npm config set registry https://registry.npmjs.org
npm install -g feishu-openclaw-plugin-onboard-cli
feishu-plugin-onboard install
如果历史已关联飞书应用，可选是沿用历史飞书应用，还是创建或关联新应用。
openclaw gateway run
验证是否成功：
运行 openclaw plugins list，ID为feishu-openclaw-plugin的Status为loaded。
3、订阅机器人长链接
进入飞书开放平台，配置事件订阅方式：
-
配置方式为长连接 -
添加事件：接收消息、消息被reaction、消息被取消reaction
点击回调配置：
3. 配置方式为长连接
4. 添加回调
发布版本并审核通过
4、完成机器人的配对并开始使用
-
在飞书中向机器人发送任意消息，系统会生成一个配对码 -
在服务器终端执行命令完成绑定
-
按照提示完成授权
-
确认安装成功：发送 /feishu start
三、使用注意事项
1、如何更新插件
运行命令：
feishu-plugin-onboard update
如果找不到该指令，先安装脚本。
2、遇到使用问题怎么办
可在与AI 的对话中发送：
-
/feishu start：确认是否安装成功 -
/feishu doctor：检查配置是否正常 -
/feishu auth：批量完成用户授权
运行诊断命令：
feishu-plugin-onboard doctor
feishu-plugin-onboard doctor --fix
查看版本信息：
feishu-plugin-onboard info
feishu-plugin-onboard info --all
四、常见问题
想要查看完整的问题，以及过程中反馈问题，大家可以去看官方的文档。
原文档链接：
https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh[1]
#OpenClaw #飞书插件 #AI助手 #效率工具 #自动化办公 #生产力提升 #开源工具 #办公神器 #小龙虾飞书指南
引用链接
[1]https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh
