‼️本插件目前处于快速迭代阶段，请谨慎尝试。为了提供更优质的用户体验，产品研发团队正在快速优化迭代，每天我们的龙虾插件都在变得更稳定、部署更简单、功能更好用。点击右上角... 关注文档更新。🦞

本插件目前处于快速迭代阶段，请谨慎尝试。为了提供更优质的用户体验，产品研发团队正在快速优化迭代，每天我们的龙虾插件都在变得更稳定、部署更简单、功能更好用。点击右上角... 关注文档更新。🦞

💡飞书插件最新版本：2026.3.8 ｜更新日志

飞书插件最新版本：2026.3.8 ｜更新日志

让你的飞书长出龙虾钳🦞

你或许早就把小龙虾接到了飞书上，他能帮你写东西、查资料、出方案——但它也经常会说，"我没有飞书文档/消息/日历权限，请把内容发给我"，你不得不反复复制粘贴。

今天，飞书 OpenClaw 官方插件正式上线！

在获得你的授权后，OpenClaw 可以直接以你的身份看文档找资料、核对日历看档期、理解群聊上下文。

你说一句话，它就能伸出“钳子”，直接在飞书里帮你把活儿干了。

💡一句话能做什么？

一句话能做什么？

33%

🔧完整能力一览

完整能力一览

| 类别 | 能力 |

| --- | --- |

| 💬 消息 | 消息读取（群聊/单聊历史、话题回复）、消息发送（含发卡片）、消息回复、消息搜索、图片/文件下载 |

| 📄 文档 | 创建云文档、更新云文档、读取云文档内容 |

| 📊 多维表格 | 创建/管理多维表格、数据表、字段、记录（增删改查、批量操作、高级筛选）、视图 |

| 📊 电子表格 | 创建、编辑、查看电子表格 |

| 📅 日历日程 | 日历管理、日程管理（创建/查询/修改/删除/搜索）、参会人管理、忙闲查询 |

| ✅ 任务 | 任务管理（创建/查询/更新/完成）、清单管理、子任务、评论 |

代用户身份发消息需在飞书开放平台额外开通机器人 im:message.send_as_user 权限，部分企业如字节不支持此操作

此外，有了插件，你的 OpenClaw 还能在飞书上和你更好的互动，支持流式输出卡片回复（需手动开启）、识别合并转发消息、发表情等，欢迎体验！

该插件由于有用户身份授权，暂不适合作为群机器人供多人使用，也不建议用公司的飞书账号接入，建议先用个人账号体验，请仔细评估后安装。

1.安装教程

免安装自带飞书插件的平台

使用Coze 编程、ArkClaw平台安装的 OpenClaw 已自带飞书插件，无需阅读后续的安装步骤。

1.1前置准备

安装 openclawhttps://openclaw.ai/

如果你还没有OpenClaw，可以参照快速上手指南：🦞立省 500！30 分钟把 OpenClaw 在飞书上配到可用

💡openclaw 版本限制：

openclaw 版本限制：

•Linux/MacOS：openclaw 2026.2.26 及以上；

•Windows：openclaw 2026.3.2 及以上

可通过openclaw -v命令查看；如果低于该版本可能出现异常执行这个命令升级：npm install -g openclaw其它升级方式可参考：https://docs.openclaw.ai/install/development-channels#switching-channels

1.2创建飞书机器人、导入权限

后续我们将提供一键创建机器人的能力，敬请期待可以复用已有机器人，但注意下面的权限和卡片回调要配置全

🧭注意：导入完整的权限列表对后续功能的使用体验非常重要（不用经常申请权限）！！

注意：导入完整的权限列表对后续功能的使用体验非常重要（不用经常申请权限）！！

| 创建应用o | 附件不支持打印 |

| --- | --- |

| 开启机器人能力 | 添加机器人能力1.在左侧目录选择“应用能力 - 添加应用能力”。2.选择“按能力添加”页签，单击“机器人”能力卡片的“添加”按钮。附件不支持打印 |

| 导入所需权限添加封面 | 在左侧目录选择“开发配置 > 权限管理”，单击“批量导入/导出权限”按钮。附件不支持打印在“导入”页签中，将如下权限替换原有示例，单击“下一步，确认新增权限”按钮。代码块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", |

| | |

1.3安装飞书插件

如果历史上已安装了其他飞书插件，在这一步安装过程中将会自动禁用其他飞书插件，无需额外处理；如果你所在的平台有辅助开发 Agent ，可以试试让Agent辅助安装

执行指令：

npx -y https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/3001f02e44c6269c6df09c01aad601cd_QWN3XUhUSQ.tgz install

提示：👆如果执行这一行命令行出错，可在命令行前增加sudo 重新执行

•如果历史已关联飞书应用，可选是沿用历史飞书应用，还是创建或关联新应用。如果是创建或关联新应用，则填入第1步中创建新应用的 appid 和 appsecret

openclaw gateway run

•验证是否成功：

运行上述代码后，如果出现下面这段说明插件已经开始监听飞书的事件，启动成功35%

运行上述代码后，如果出现下面这段说明插件已经开始监听飞书的事件，启动成功

运行openclaw plugins list，ID为feishu-openclaw-plugin的Status为loaded，ID为feishu的Status为disabled则标明已成功启用飞书官方插件：32%

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

33%

1.4订阅机器人长链接接收事件和卡片回调

🧭注意：需要配置卡片回调，便于小龙虾可以感知到你点击了卡片按钮操作

注意：需要配置卡片回调，便于小龙虾可以感知到你点击了卡片按钮操作

| 进入飞书开放平台，配置事件订阅方式 | 配置方式为长连接附件不支持打印添加事件接收消息、消息被reaction、消息被取消reaction附件不支持打印附件不支持打印 |

| --- | --- |

| | |

1.5完成机器人的配对并开始使用

🌰如果希望快速完成给龙虾的权限授权，便于丝滑调用各种飞书工具，可以随时告诉AI：“我想授予所有用户权限”，来完成权限的授予。

如果希望快速完成给龙虾的权限授权，便于丝滑调用各种飞书工具，可以随时告诉AI：“我想授予所有用户权限”，来完成权限的授予。

1.在飞书中向机器人发送任意消息，系统会生成一个配对码（字母+数字组合）；如果历史已安装过飞书插件，可能没有该配对过程。

2.配对码有效期为 5 分钟，超时需重新触发

3.在服务器终端执行以下命令完成绑定：openclaw pairing approve feishu <配对码>--notify

输入时不带 <>

4.按照下图完成授权，便于后续 openclaw 可以通过你的身份完成消息、文档、多维表格、日历等任务。如果不想在此刻授权，也可以直接开始对话，后续在对话框中输入 /feishu auth 来完成批量授权

| | |

| --- | --- |

| | |

5.确认是否安装成功，可在与AI 的对话中发送：/feishu start；如果返回了版本号信息，则代表安装成功。

6.为了让龙虾能学会这些新技能并正确使用，请和龙虾说“学习一下我安装的新飞书插件，列出有哪些能力”

2.使用教程

2.1如何切换到流式输出

切换到流式输出，可运行指令（如果你是本地部署，需要去终端输入；如果是云端部署，去云端的对话框输入）：

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  // 开启状态展示

2.2设置多任务并行、独立上下文

机器人可在话题群/消息群话题模式中，针对每个话题拥有独立上下文以及多任务并行。

如需开启该能力可运行指令

openclaw config set channels.feishu.threadSession true

如需关闭，可运行指令

openclaw config set channels.feishu.threadSession false

2.3如何修改飞书机器人在群内的回复方式

目前插件默认方式：可被拉进群，只有at 机器人才可回复。

模式 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；让机器人加入群后，发送任意消息，然后在日志里找群 ID，或者让机器人回复群 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}}}}}

2.4常见诊断命令与问题修复

1.可在与AI 的对话中发送a./feishu start：确认是否安装成功；b.c./feishu doctor：可检查配置是否正常；d.如果希望批量完成用户授权，可批量完成用户授权；e.插件中也内置了常见问题的解决方案，遇到问题都可以先问问小龙虾了！

a./feishu start：确认是否安装成功；

c./feishu doctor：可检查配置是否正常；

d.如果希望批量完成用户授权，可批量完成用户授权；

e.插件中也内置了常见问题的解决方案，遇到问题都可以先问问小龙虾了！

2.如果不行，则运行指令：

npx https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/3001f02e44c6269c6df09c01aad601cd_QWN3XUhUSQ.tgz doctor

可以查看问题，自主修复：

运行 fix尝试自动修复

npx https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/3001f02e44c6269c6df09c01aad601cd_QWN3XUhUSQ.tgz doctor --fix

3.如果仍然无法修复，可在反馈群里反馈信息

运行 info 查看版本信息，反馈问题时带上辅助排查

npx https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/3001f02e44c6269c6df09c01aad601cd_QWN3XUhUSQ.tgz info

--all查看详细配置信息

npx https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/3001f02e44c6269c6df09c01aad601cd_QWN3XUhUSQ.tgz info --all

3.更新教程

插件能力实时更新，欢迎更新到插件最新版本体验最新能力

在「终端」中运行下面代码：

npx -y https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/3001f02e44c6269c6df09c01aad601cd_QWN3XUhUSQ.tgz update

提示：👆如果执行这一行命令行出错，可在命令行前增加sudo 重新执行

4.常见问题

4.1没有 OpenClaw 应该如何部署？

•OpenClaw 是本次介绍的飞书插件的运行基础，请先选择符合自己需要的部署方案完成部署。•本地版建议使用 TRAE SOLO 等编程 Agent 辅助安装；•云端版如Coze 编程、ArkClaw等可以一键部署，在后续使用中也可以提供开发Agent辅助你调试；你可以通过视频感受下这类产品的快捷部署方式⬇️50%

•OpenClaw 是本次介绍的飞书插件的运行基础，请先选择符合自己需要的部署方案完成部署。

•本地版建议使用 TRAE SOLO 等编程 Agent 辅助安装；

•云端版如Coze 编程、ArkClaw等可以一键部署，在后续使用中也可以提供开发Agent辅助你调试；你可以通过视频感受下这类产品的快捷部署方式⬇️

0305 扣子编程一键部署 OpenClaw50%

0305 扣子编程一键部署 OpenClaw

4.2插件安装完毕运行后，报cannot find module xxx

原因是系统没有安装插件的依赖（可能是安装被中断or权限问题）

解决方法：进入插件安装目录，运行npm install

4.3Coze上安装失败的处理方式

依次在终端执行以下命令，如果未能正常运行，请等待飞书插件和 Coze 的后续更新。

// 先执行
export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com

npx -y https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/3001f02e44c6269c6df09c01aad601cd_QWN3XUhUSQ.tgz install

提示：👆如果执行这一行命令行出错，可在命令行前增加sudo 重新执行

检查一下老插件的配置，参考下图。如果为“true”需要改成“false”

4.4升级到 openclaw 3.2 版本上无法正常调用工具

这个openclaw 版本默认把新 agent 的工具权限关闭。修复方式在 openclaw.json 找到并修改为下面这段内容：

{
  "tools": {
    "profile": "full",
    "sessions": {
      "visibility": "all"
    }
  }
}

4.5飞书官方插件与 OpenClaw 社区原有插件有何区别？

飞书官方插件，能以用户身份读写消息、文档等，体验更丝滑；以下为粗略的对比（由AI整理，供参考）50%

飞书官方插件，能以用户身份读写消息、文档等，体验更丝滑；以下为粗略的对比（由AI整理，供参考）

50%

5.用户内测体验互助群

欢迎群内大家彼此帮助回复问题，老玩家带带新玩家，一起探索龙虾新玩法提升工作效率

6.更新日志

v2026.3.8

1.支持电子表格的读写：小龙虾现在可以帮你看表格数据、追加内容啦！使用前记得在开发者后台导入电子表格相关权限哦权限配置指南

2.支持在云文档中添加文件和图片：小龙虾写文档时可以插入图片、文件附件了，让文档内容更丰富

3.AI 可感知表情反馈：小龙虾现在能"看懂"你的表情了！收到你的 👍、❤️ 等表情后，可以据此调整回复逻辑，比如通过 👍 确认操作执行

v 2026.3.7-beta.1

问题修复：修复windows 使用反复授权问题，可升级到最新版本体验

v 2026.3.6

感谢大家的使用和反馈，基于大家提出的问题和建议，我们进行了如下更新：

1.安装支持windows 环境：已支持windows 系统安装插件

2.话题群和话题模式群能力升级：可通过命令一键开启在话题群、话题模式群中让每个独立话题中拥有独立上下文和并行执行任务，让小龙虾同时干多件事。配置方式

3.问题修复：修复知识库文档无法读取评论的问题，修复 /feishu doctor 指令中版本号错误问题

如果你已经用上了我们的插件，建议更新到我们的新插件，可以参考这里的更新指令快速升级到最新版更新指令

OpenClaw飞书官方插件使用指南（公开版）

让你的飞书长出龙虾钳🦞​

1.安装教程​

免安装自带飞书插件的平台​

1.1前置准备​

1.2创建飞书机器人、导入权限​

1.3安装飞书插件​

1.4订阅机器人长链接 接收事件和卡片回调​

1.5完成机器人的配对并开始使用​

2.使用教程​

2.1如何切换到流式输出​

2.2设置多任务并行、独立上下文​

2.3如何修改飞书机器人在群内的回复方式​

2.4常见诊断命令与问题修复​

3.更新教程​

4.常见问题​

4.1没有 OpenClaw 应该如何部署？​

4.2插件安装完毕运行后，报cannot find module xxx​

4.3Coze上安装失败的处理方式​

4.4升级到 openclaw 3.2 版本上无法正常调用工具​

4.5飞书官方插件与 OpenClaw 社区原有插件有何区别？​

5.用户内测体验互助群​

6.更新日志​

v2026.3.8​

v 2026.3.7-beta.1​

v 2026.3.6​

让你的飞书长出龙虾钳🦞

1.安装教程

免安装自带飞书插件的平台

1.1前置准备

1.2创建飞书机器人、导入权限

1.3安装飞书插件

1.4订阅机器人长链接接收事件和卡片回调

1.5完成机器人的配对并开始使用

2.使用教程

2.1如何切换到流式输出

2.2设置多任务并行、独立上下文

2.3如何修改飞书机器人在群内的回复方式

2.4常见诊断命令与问题修复

3.更新教程

4.常见问题

4.1没有 OpenClaw 应该如何部署？

4.2插件安装完毕运行后，报cannot find module xxx

4.3Coze上安装失败的处理方式

4.4升级到 openclaw 3.2 版本上无法正常调用工具

4.5飞书官方插件与 OpenClaw 社区原有插件有何区别？

5.用户内测体验互助群

6.更新日志

v2026.3.8

v 2026.3.7-beta.1

v 2026.3.6