OpenClaw小龙虾对接飞书教程最新版，飞书官方下场开发插件，龙虾长出龙虾钳，体验更丝滑

飞书推出全新OpenClaw插件，让AI助手真正成为你的"智能钳子"。该插件支持流式输出、自动生成飞书文档、按建议修改文档、以用户身份发送消息等功能。用户只需一句话，AI就能直接在飞书内完成各种操作，如撰写文档、总结群聊、生成周报等。安装步骤简单：1)在飞书开放平台创建应用并添加机器人权限；2)导入所需权限配置；3)通过npm安装官方插件。新插件将自动禁用旧版插件，建议用户更

iBaoxing

1637人浏览 · 2026-03-07 21:09:05

iBaoxing · 2026-03-07 21:09:05 发布

各位小伙伴们，大家好，我是Baoxing，见字欢喜！

昨晚看了飞书的「玩虾大会」直播，飞书官方亲自下场开发了对接 OpenClaw 小龙虾插件，体验上更丝滑，能力更强大，真正的让你的龙虾长出龙虾钳🦞。

比如：现在有支持流式输出（就是不用等待很久AI 完全回复完才回复你，而是 AI 输出一部分就回复给你一部分）、有生成飞书文档能力、有按你的修改建议自行修改飞书能力、有以你的身份（这里不是 bot 的身份哦）把内容发给好友或者群的能力。

你说一句话，它就能伸出“钳子”，直接在飞书里帮你把活儿干了，再也不用收到这类回复：我没有飞书文档/消息/日历权限，你可以按照给出的步骤手动操作。

之前写过一篇小龙虾对接飞书的推文，https://111 这个是对接的由 openclaw 社区提供的飞书插件，无法最大化飞书的能力，还有更早期的第三方插件版。可以直接略过按当前这个最新版本的安装对接一下。

用了这个插件后，现在你可以做类似这些操作：

输出沁园春·雪，写入文档，并把文档发给飞书好友 xx

对 xx 文档我做了一些评论，请你按照评论对文档做优化修改

总结 xx 群过去一周的消息

总结现在的未读消息，并推荐我应该怎么回

请结合 xx会议内容和业务信息，帮我写活动方案文档，相关企业知识请列在最后

帮我根据【智能纪要：xx】会议讨论的内容，帮我制定待办计划，把能做的做了

看下这个群聊内容，联系上下文，总结一下AI生图目前的决定因素

帮我用我的身份给他在群里回一段消息，你就说改进点就行；最后注明由你代发

这是一段汇报，请整理后我确认后发给xx

根据我写过、读过的文档、参加过的会议、群聊和私聊的聊天记录。请分析我是什么样的人，我有什么优势和劣势，我该如何找到人生赛道?

根据这个纪要文档和里面最后附上的逐字稿文档【智能纪要：xx】，整理下整体会议纪要、特别是产品进展、后续计划，返回内容上要有纪要文档

读取我上周的飞书消息、参与过的会议、日程、发出和阅读过的文档、已完成的任务、待办事项，帮我生成一份工作周报。

做一个多维表格，把这些字段都配置好，帮我根据 xx配置数据，并能够做不同的表格视图、看板和表单视图。

…

如果你之前对接过，可以直接使用现有的已有的在飞书上创建的 Bot，但需要你重新配置下 AppId、AppSecret，以及检查是否有开放必要权限，这里建议创建新的 Bot，可以跟着我这面的步骤再重新出发。

开始之前，你需要准备

OpenClaw — 已经安装好并能正常运行
飞书账号 — 个人账号就行，不需要企业管理员

Step 1：创建机器人、导入权限

飞书开放平台：https://open.feishu.cn/app

在这里插入图片描述

输入应用名、描述及图标，单击创建按钮，完成操作。

在这里插入图片描述

添加机器人能力。

在左侧目录选择添加应用能力，点击机器人添加按钮。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

在左侧目录选择权限管理，单击批量导入/导出权限按钮。

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

在导入页签中，清空掉原有的内容，将以下内容粘贴进去后，单击下一步，确认新增权限按钮。

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

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

在弹窗中确认权限无误后，单击申请开通按钮，完成操作。

在这里插入图片描述

Step 2：安装飞书官方插件

PS: 如果历史上已安装了其他飞书插件，在这一步安装过程中将会自动禁用其他飞书插件，无需额外处理，但也会导致你之前对接的飞书机器人不能用哦。Baoxing 这里建议根据步骤安装飞书官方版的，至少更新有保障，且你可控制使用的功能更多。

MacOS/Linux 在终端执行以下命令

# 配置npm镜像地址（如果你是国际版环境可忽略该命令，直接执行下面两个）
npm config set registry https://registry.npmjs.org
# 下载插件到 /tmp 目录
curl -o /tmp/feishu-openclaw-plugin-onboard-cli.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/195a94cb3d9a45d862d417313ff62c9c_gfW8JbxtTd.tgz
# 安装插件
npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g

在这里插入图片描述

Windows在PowerShell中执行以下命令

# 配置npm镜像地址（如果你是国际版环境可忽略该命令，直接执行下面两个）
npm config set registry https://registry.npmjs.org
# 下载插件到 /tmp 目录
curl -o "%TEMP%\feishu.tgz" https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/195a94cb3d9a45d862d417313ff62c9c_gfW8JbxtTd.tgz
# 安装插件
npm install -g "%TEMP%\feishu.tgz"

接着执行后续命令

feishu-plugin-onboard install

在这里插入图片描述

我这里因为之前安装过OpenClaw社区提供的feishu插件，所以这里会提示我是否使用之前的机器人接入，我这里输入n，不使用之前的机器人，使用新建的机器人

在这里插入图片描述

会进入到需要我们填写appid和appsecret的界面

在这里插入图片描述

Step 3：配置 appid 和 appsecret

我们回到飞书开放平台，进入到Bot详情页，点击左侧凭证与基础信息。

在这里插入图片描述

配置appid 和 appsecret 到终端

在这里插入图片描述

我们在终端重启下网关服务

openclaw gateway restart

Step 4：配置长链接接收事件和卡片回调

我们回到飞书开放平台，进入到Bot详情页，点击左侧事件与回调。

点击事件配置下的编辑按钮

在这里插入图片描述

添加事件接收消息、消息被reaction、消息被取消reaction

在这里插入图片描述

点击回调配置下的编辑按钮

在这里插入图片描述

添加回调添加回调

在这里插入图片描述

Step 5：创建版本，发布应用

在这里插入图片描述

Step 6：完成机器人的配对并开始使用

打开飞书，搜索你的机器人名称，进入机器人私聊界面

在这里插入图片描述

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

在这里插入图片描述

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

在服务器终端执行以下命令完成绑定：

openclaw pairing approve feishu <配对码>

在这里插入图片描述

再次进行测试。

在这里插入图片描述

Step 7：优化体验

到这里，其实我们大部分已经配置好了，但还有些体验上的可以优化。

默认是没有开启流式输出的，我们可以执行以下命令开启。

# 开启流式输出
openclaw config set channels.feishu.streaming true

流式输出卡片上支持显示更多内容

# 开启耗时
openclaw config set channels.feishu.footer.elapsed true
# 开启状态展示
openclaw config set channels.feishu.footer.status true

其他补充说明

遇到问题搞不定可以在后台回复 养虾进群，加入交流群，大家帮你解决。

在这里插入图片描述

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

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

在这里插入图片描述

以下是一些其他的可用的命令，供各位小伙伴参考使用

# 更新插件
feishu-plugin-onboard update
# 插件检查
feishu-plugin-onboard doctor
# 插件检查并自动修复
feishu-plugin-onboard doctor --fix
# 插件版本查看
feishu-plugin-onboard info 
# 开启流式输出
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
# 机器人在群组内设置需要 @ 才回复（默认就是需要@才回复）需重启生效sh /workspace/projects/scripts/restart.sh
openclaw config set channels.feishu.requireMention true --json
# 机器人在群组内设置不需要 @ 也回复（如果机器人在大群内请谨慎使用）需重启生效sh /workspace/projects/scripts/restart.sh
openclaw config set channels.feishu.requireMention false --json
# 指定群 @机器人 才回复，先设置默认所有群都不需要 @，在设置特定群需要 @ 需重启生效sh /workspace/projects/scripts/restart.sh
openclaw config set channels.feishu.requireMention open --json
openclaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true --json
# 设置机器人在话题群/话题模式群 针对每个话题拥有独立上下文以及多任务并行，true 开启，false 关闭
openclaw config set channels.feishu.threadSession true
openclaw config set channels.feishu.threadSession false