最近这阵子，OpenClaw 的爆火不是偶然：一方面，大模型越来越能干；另一方面，大家突然意识到——真正的生产力不在模型的聊天框里，而在你每天用的、沉淀了大量信息的工作软件里。于是 OpenClaw 这种“把 AI 变成可扩展工具箱”的智能体编排框架就被点燃了：能接模型、能接工具、能接各种服务，装上去就像给自己雇了个不抱怨、技能极多，还7×24小时待命的数字同事。
所以，你或许早就把那只“小龙虾”接进了飞书里：它能帮你写东西、查资料、出方案。但它也经常会说，“我没有飞书文档/消息/日历权限，请把内容发给我”，你不得不反复复制粘贴。AI 在旁边疯狂进化，人却还在当搬运工：搬文档、搬群聊、搬日程，搬到怀疑人生。
为了解决大家的痛点，今天，飞书 OpenClaw 官方插件来了！
经由用户授权，OpenClaw 可以直接以“你的”身份看文档找资料、理解群聊上下文、核对日历看档期。你说一句话，它就能伸出“钳子”，在飞书里把活儿干了——少复制粘贴，多直接交付。
我们会用一篇文章把你最关心的事一次讲清：什么是 OpenClaw、飞书官方插件目前能做什么、如何安装与更新、常见问题怎么排查。
看完照着做，几分钟就能把插件装好开用，把“会聊天的 AI”升级成“能干活的飞书助手”！
250px|700px|reset
一、什么是 OpenClaw？和其他 Agent 有什么不同？
相比以往的 AI Agent，OpenClaw 最大的不同在于：他是完全属于你的私人助理，拥有长期记忆、能力持续进化，拥有更高的权限，能直接操作你电脑、本地运行、还能 24 小时主动干活。
二、什么是 OpenClaw 飞书官方插件？用起来能有多酷？
目前有大量用户主动将 OpenClaw 接入了飞书，得益于飞书各类协同工具和良好的开放能力，能够让你的 Agent 完成很多工作。但早期 OpenClaw 上的三方飞书插件，可能遇到服务不稳定、权限授权繁琐等问题。
此次飞书推出的 OpenClaw官方插件 能让你的 OpenClaw 以你的身份更好地调用飞书的各类能力，包括了解群聊和文档中的所有信息、写文档、改文档、帮你发消息、约日程、创建多维表格等。
你说一句话，它就能伸出“钳子”，直接在飞书里帮你把活儿干了！
250px|700px|reset
250px|700px|reset
250px|700px|reset
具体能力包括：
- 做你真正的数字分身：以你的身份完成工作（回消息、写文档、生成多维表格、创建文档等）；
- 更懂你的工作：帮你获取飞书内的海量上下文（含消息、文档、会议纪要、多维表格、日程、任务等）；
- 更顺畅的和你的 Openclaw 沟通，如提供消息流式生成等。
完整能力一览：
此外，相比于 Telegram 等国外平台，飞书是国内的平台，有中文的界面、文档和客服，更容易上手；目前国内的 OpenClaw 用户，绝大多数都选择了接入飞书，使用人数更多，生态更好。
相比于国内的其他平台，飞书的开放能力更强，能带来更好的体验、获取更多工作中必要的上下文，玩法更多。
三、OpenClaw 飞书官方插件安装步骤
飞书官方插件目前还在飞速迭代，每日都可能有新版本上新，请大家多多更新测试，多多反馈。
- 安装前提
- 装好了OpenClaw
推荐版本为：2026.2.26，可通过openclaw -v命令查看
执行这个命令升级：npm install -g openclaw@2026.2.26
其它升级方式可参考：https://docs.openclaw.ai/install/development-channels#switching-channels
- 飞书机器人创建& 权限开通完毕
- 登录飞书开放平台，单击“创建企业自建应用”按钮。
250px|700px|reset
- 配置应用名、描述及图标，单击“创建”按钮，完成操作。
250px|700px|reset
- 添加机器人能力。
- 在左侧目录树选择“应用能力 > 添加应用能力”。
- 选择“按能力添加”页签，单击“机器人”能力卡片的“添加”按钮。
250px|700px|reset
- 配置权限。
在左侧目录树选择“开发配置 > 权限管理”，单击“批量导入/导出权限”按钮。
250px|700px|reset
在“导入”页签中，将如下权限替换原有示例，单击“下一步，确认新增权限”按钮。
{
"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"
]
}
}
在弹窗中确认权限无误后，单击“申请开通”按钮，完成操作。
250px|700px|reset
- 发布应用。
单击顶部的“创建版本”按钮。
250px|700px|reset
- 按需配置应用版本号、默认能力及更新说明等信息。了解更多。
250px|700px|reset
- 单击页面底部的“保存”按钮，创建版本。
250px|700px|reset
单击页面右上角的“确认发布”按钮，完成应用发布。
250px|700px|reset
- 获取配置信息。
- 在左侧目录树选择“基础信息 > 凭证与基础信息”。
- 在“应用凭证”模块中，获取并记录App ID与App Secret信息。
- 安装插件
如果历史上已安装了其他飞书插件，在这一步安装过程中将会自动禁用其他飞书插件，无需额外处理；如果你所在的平台有辅助开发 Agent ，可以试试让Agent辅助安装。
但如果您安装飞书官方插件后再升级 OpenClaw 版本，需要手动禁用其他飞书插件。
依次在终端中执行一下命令：
npm config set registry https://registry.npmjs.org
curl -o /tmp/feishu-openclaw-plugin-onboard-cli.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/4d184b1ba733bae2423a89e196a2ef8f_QATOjKH1WN.tgz
npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g
rm /tmp/feishu-openclaw-plugin-onboard-cli.tgz
feishu-plugin-onboard install
- 如果历史已关联飞书应用，可选是沿用历史飞书应用，还是创建或关联新应用。如果是创建或关联新应用，则填入第1步中创建新应用的 appid 和 appsecret
250px|700px|reset
- 运行 OpenClaw
openclaw gateway run
出现下面这段说明插件已经开始监听飞书的事件，启动成功。
250px|700px|reset
运行 openclaw plugins list，ID为 feishu-openclaw-plugin 的 Status 为 loaded ，ID为 feishu 的 Status 为 disabled 则标明已成功启用飞书官方插件。
250px|700px|reset
- 订阅机器人长链接接收事件
配置事件订阅方式
250px|700px|reset
添加接收消息事件
250px|700px|reset
发布版本
250px|700px|reset
- 完成机器人的配对并开始使用
如果希望快速完成给龙虾的权限授权，便于丝滑调用各种飞书工具，可以随时告诉AI：“我想授予所有用户权限”，来完成权限的授予。
- 在飞书中向机器人发送任意消息，系统会生成一个配对码（字母+数字组合）；如果历史已安装过飞书插件，可能没有该配对过程。
- 配对码有效期为 5 分钟，超时需重新触发
- 在服务器终端执行以下命令完成绑定：openclaw pairing approve feishu <配对码> --notify
- 按照下图完成授权，便于后续 openclaw 可以通过你的身份完成消息、文档、多维表格、日历等任务。
如果不想在此刻授权，也可以直接开始对话，后续在对话框中输入 /feishu auth 来完成批量授权
- 确认是否安装成功，可在对话框中输入：/feishu start；如果返回了版本号信息，则代表安装成功。
为了让龙虾能学会这些新技能并正确使用，请和龙虾说：“学习一下我安装的新飞书插件，列出有哪些能力”，或者“学习一下我安装的新飞书插件，我想让你使用相关的xx功能，向我发起授权”。
龙虾会将相关权限以授权卡片的形式发给你，点击授权后，它就可以帮你干活啦！
四、OpenClaw 飞书官方插件使用注意事项
- 如何更新插件？
运行下面代码：
feishu-plugin-onboard update
Q：如果发现找不到该指令，则可以先安装一下以下脚本
npm config set registry https://registry.npmjs.org
curl -o /tmp/feishu-openclaw-plugin-onboard-cli.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/4d184b1ba733bae2423a89e196a2ef8f_QATOjKH1WN.tgz
npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g
rm /tmp/feishu-openclaw-plugin-onboard-cli.tgz
- 遇到使用问题怎么办？
- 通过在对话框中输入
- /feishu start：确认是否安装成功；
- /feishu doctor：可检查配置是否正常；
- 如果希望批量完成用户授权，/feishu auth 可批量完成用户授权；
- 插件中也内置了常见问题的解决方案，遇到问题 都可以先问问小龙虾了！
- 如果不行，则运行指令：
feishu-plugin-onboard doctor
可以查看问题，自主修复：
250px|700px|reset
运行 fix尝试自动修复
feishu-plugin-onboard doctor --fix
250px|700px|reset
- 如果仍然无法修复，可在反馈群里反馈信息
运行 info 查看版本信息，反馈问题时带上辅助排查
feishu-plugin-onboard info
250px|700px|reset
--all查看详细配置信息
feishu-plugin-onboard info --all
- 如果之前你已经在 OpenClaw 中 安装过飞书MCP
需要移除，避免使用冲突。你可以和 AI 对话，告诉AI：移除飞书MCP
五、OpenClaw 飞书官方插件安装常见问题
- 插件安装完毕运行后，报cannot find module xxx？
原因是系统没有安装插件的依赖（可能是安装被中断or权限问题）
解决方法：进入插件安装目录，运行npm install
250px|700px|reset
- 如果想要切换到流式输出怎么配置？
切换到流式输出，可运行指令：
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 | 只有 @机器人 才回复 | requireMention: true |
模式 2 | 不用 @，所有消息都回复 | requireMention: "open" 或 false |
模式 3 | 只有指定群 @机器人 才回复 | groups 里单独配置 |
常用命令汇总
# 查看当前配置
openclaw config get channels.feishu
# 设置需要 @ 才回复
openclaw config set channels.feishu.requireMention true --json# 设置不需要 @ 也回复
openclaw config set channels.feishu.requireMention open --json# 给特定群设置规则
openclaw config set channels.feishu.groups.群ID.requireMention true --json# 重启 Gateway 生效sh /workspace/projects/scripts/restart.sh
# 查看频道状态
openclaw channels status
模式 1：只有 @机器人 才回复（最常用）
配置方法
# 设置需要 @ 才回复
openclaw config set channels.feishu.requireMention true --json# 重启生效sh /workspace/projects/scripts/restart.sh
完整配置示例
{"channels": {"feishu": {"enabled": true,"appId": "cli_你的AppID","appSecret": "你的AppSecret","requireMention": true,"groupPolicy": "open"}}}
模式 2：不用 @，所有消息都回复
前置条件：需要在应用管理后台给应用开启 获取群组中所有消息（敏感权限）im:message.group_msg
配置方法
# 设置不需要 @ 也回复
openclaw config set channels.feishu.requireMention false --json# 重启生效sh /workspace/projects/scripts/restart.sh
完整配置示例
{"channels": {"feishu": {"enabled": true,"appId": "cli_你的AppID","appSecret": "你的AppSecret","requireMention": "open","groupPolicy": "open"}}}
⚠️ 注意：这个模式在大群里容易刷屏，谨慎使用！
模式 3：只有指定群 @机器人 才回复（高级）
效果
- 大部分群：不用 @ 也能回复（或者完全不回复）
- 特定群：必须 @ 才回复
- 适合：不同群不同规则，比如工作群严格一点，闲聊群随意一点
配置方法
第一步：获取群 ID；让 Bot 加入群后，发送任意消息，然后在日志里找群 ID，或者让 Bot 回复群 ID。或飞书群设置页面中有ID
第二步：配置特定群规则
# 先设置默认所有群都不需要 @
openclaw config set channels.feishu.requireMention open --json# 然后给特定群设置需要 @（这里群ID只是示例，你要替换成真实的）
openclaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true --json# 重启生效sh /workspace/projects/scripts/restart.sh
完整配置示例
{"channels": {"feishu": {"enabled": true,"appId": "cli_你的AppID","appSecret": "你的AppSecret","requireMention": "open","groupPolicy": "open","groups": {"oc_532044075a61d112f04fa63109c75e9b": {"requireMention": true},"oc_另一个群ID": {"requireMention": true}}}}}
六、结语
读完这篇文章，你应该已经能感受到：OpenClaw 的价值不在“会回答”，而在“能把事办完”。当它和飞书通过官方插件连起来，文档、消息、日历这些真正承载工作的信息流，就不需要你再一趟趟搬运了——你只要下达目标，它就能在飞书里完成动作。
今晚插件上线，趁热开玩：去飞书里把 OpenClaw 官方插件装起来，按本文步骤完成授权和安装，挑一件你最讨厌、最重复的活儿交给它试试（整理会议纪要、从群聊里提取待办、核对档期、查资料写方案……都行）。用着不顺、遇到报错、想要的新能力，也别憋着——欢迎把问题和建议直接反馈给我们，我们会快速定位，并更快地为插件进行升级！
你还可以把你的使用心得发到你常用的平台，分享你用 OpenClaw 在飞书里解决了什么问题、节省了多少时间、有哪些坑和小技巧——这些真实经验，会让更多人少走弯路，也会推动我们把插件做得更强、更稳、更好用。
