LuminaLumina
信息流回顾

OpenClaw飞书官方插件上线

3
分类：资源推荐
作者：飞书
来源：跳转
发表时间：

内容

最近这阵子，OpenClaw 的爆火不是偶然：一方面，大模型越来越能干；另一方面，大家突然意识到——真正的生产力不在模型的聊天框里，而在你每天用的、沉淀了大量信息的工作软件里。于是 OpenClaw 这种"把 AI 变成可扩展工具箱"的智能体编排框架就被点燃了：能接模型、能接工具、能接各种服务，装上去就像给自己雇了个不抱怨、技能极多，还7×24小时待命的数字同事。

所以，你或许早就把那只"小龙虾"接进了飞书里：它能帮你写东西、查资料、出方案。但它也经常会说，"我没有飞书文档/消息/日历权限，请把内容发给我"，你不得不反复复制粘贴。AI 在旁边疯狂进化，人却还在当搬运工：搬文档、搬群聊、搬日程，搬到怀疑人生。

为了解决大家的痛点，今天，飞书 OpenClaw 官方插件来了！

经由用户授权，OpenClaw 可以直接以"你的"身份看文档找资料、理解群聊上下文、核对日历看档期。你说一句话，它就能伸出"钳子"，在飞书里把活儿干了——少复制粘贴，多直接交付。

我们会用一篇文章把你最关心的事一次讲清：什么是 OpenClaw、飞书官方插件目前能做什么、如何安装与更新、常见问题怎么排查。

看完照着做，几分钟就能把插件装好开用，把"会聊天的 AI"升级成"能干活的飞书助手"！

一、什么是 OpenClaw？和其他 Agent 有什么不同？

OpenClaw 是一款开源的个人 AI Agent 系统，可以运行在你的个人电脑或服务器上。

相比以往的 AI Agent，OpenClaw 最大的不同在于：他是完全属于你的私人助理，拥有长期记忆、能力持续进化，拥有更高的权限，能直接操作你电脑、本地运行、还能 24 小时主动干活。

二、什么是 OpenClaw 飞书官方插件？用起来能有多酷？

目前有大量用户主动将 OpenClaw 接入了飞书，得益于飞书各类协同工具和良好的开放能力，能够让你的 Agent 完成很多工作。但早期 OpenClaw 上的三方飞书插件，可能遇到服务不稳定、权限授权繁琐等问题。

此次飞书推出的 OpenClaw官方插件能让你的 OpenClaw 以你的身份更好地调用飞书的各类能力，包括了解群聊和文档中的所有信息、写文档、改文档、帮你发消息、约日程、创建多维表格等。

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

image

image

image

  • 做你真正的数字分身：以你的身份完成工作（回消息、写文档、生成多维表格、创建文档等）；
  • 更懂你的工作：帮你获取飞书内的海量上下文（含消息、文档、会议纪要、多维表格、日程、任务等）；
  • 更顺畅的和你的 Openclaw 沟通，如提供消息流式生成等。

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

相比于 Telegram 等国外平台，飞书是国内的平台，有中文的界面、文档和客服，更容易上手；目前国内的 OpenClaw 用户，绝大多数都选择了接入飞书，使用人数更多，生态更好。

相比于国内的其他平台，飞书的开放能力更强，能带来更好的体验、获取更多工作中必要的上下文，玩法更多。

这个插件通过飞书接口连接了你的工作数据——消息、文档、日历、联系人，AI 能读到的东西理论上就有泄露的可能。虽然我们做了安全防护，但 AI 系统本身还不够成熟稳定，不能保证万无一失。

作为机器人供多人使用或者通过公司飞书账号使用可能会导致数据安全和隐私风险，请注意使用时需要遵守企业内的数据安全和隐私要求，避免发生数据泄露、权限突破、侵犯隐私等后果。

  • AI 并不完美，可能存在"幻觉"：它有时会误解您的意图，或者生成看似合理但不准确的内容。
  • 部分操作不可逆转：例如，AI 代发的飞书消息是以您的名义发出的，发出后即成事实。
  • 应对建议：对于涉及发送、修改、写入等重要操作，请务必做到"先预览，再确认"，切勿让 AI 处于完全脱离人工干预的"全自动驾驶"状态。

三、如何安装与更新飞书官方插件

根据 官方指南 ，执行以下安装命令，安装 OpenClaw：

Linux / MacOS：

Windows：

image.png

根据提示信息完成 OpenClaw 配置。以方舟 Coding Plan 套餐进行对接为例，配置方式参考 Coding Plan 接入 OpenClaw 官方文档。

安装成功后，可以打开 OpenClaw Dashboard URL，正常显示管理后台则代表安装成功。

image.png

在管理后台的聊天页面进行对话验证，若机器人可以正常响应，则说明配置成功。

image.png

执行指令：

npx -y @larksuite/openclaw-lark-tools install

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

执行过程中，可选择新建机器人或关联已有机器人。

image.png

若选择新建机器人，可通过飞书客户端扫描二维码，选择一键创建飞书机器人。

image.png

创建完成后，点击打开机器人，在飞书中向机器人发送任意消息，即可开始对话。

验证是否安装成功：在飞书对话中发送/feishu start。若返回了版本号信息，则代表安装成功。

为提供更优质的用户体验，飞书团队正在快速优化迭代官方插件，详情参考飞书插件最新版本更新日志。

运行 openclaw -v 命令查看已安装的 OpenClaw 的版本，新版插件对 OpenClaw 的版本要求如下。若低于该版本，插件运行可能出现异常，可执行 npm install -g openclaw 命令升级。

  • Linux / MacOS：2026.2.26 及以上
  • Windows：2026.3.2 及以上

在终端中运行以下命令升级飞书官方插件到最新版本：

npx -y @larksuite/openclaw-lark-tools update

如何切换到流式输出

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

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

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

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

openclaw config set channels.feishu.threadSession true

openclaw config set channels.feishu.threadSession false

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

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

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

需要额外在开发者后台申请权限-应用身份权限：获取群组中所有消息（敏感权限） 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": false,
      "groupPolicy": "open"
    }
  }
}

⚠️注意：这个模式在大群里容易刷屏，谨慎使用！

  • 大部分群：不用@也能回复（或者完全不回复）
  • 特定群：必须@才回复
  • 适合：不同群不同规则，比如工作群严格一点，闲聊群随意一点

第一步：获取群 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
        }
      }
    }
  }
}

常见诊断命令与问题修复

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

如果不行，则运行指令：

npx @larksuite/openclaw-lark-tools doctor

npx @larksuite/openclaw-lark-tools doctor --fix

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

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

npx @larksuite/openclaw-lark-tools info

npx @larksuite/openclaw-lark-tools info --all

如果在使用插件时出现权限不足，需要申请所需权限应该如何操作？

（1）打开飞书开放平台，在左侧目录树选择"开发配置 > 权限管理"，单击"批量导入/导出权限"按钮。

在"导入"页签中，将如下权限替换原有示例，单击"下一步，确认新增权限"按钮。

"contact:contact.base:readonly",
"docx:document:readonly",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message:send_as_bot",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"application:application:self_manage",
"contact:user.employee_id:readonly",
"offline_access", "base:app:copy",
"sheets:spreadsheet.meta:read",
"sheets:spreadsheet:read",
"sheets:spreadsheet:create",
"sheets:spreadsheet:write_only",
"docs:document.media:upload",
"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",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.media:download",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user",
"space:document:delete",
"space:document:retrieve"

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

按需配置应用版本号、默认能力及更新说明等信息。了解更多。

单击页面右上角的"确认发布"按钮，完成应用发布。

如何在飞书插件中配置OpenClaw关联多个飞书机器人，对应不同Agent

  • 创建新的飞书机器人，用于关联到新的账号上
  • 告诉AI你想创建一个怎样的新Agent，以及这个Agent关联的飞书账号是什么，并将操作指南发给OpenClaw请他自己完成对应配置。

没有 OpenClaw 应该如何部署？

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

  • 本地版建议使用 TRAE SOLO 等编程 Agent 辅助安装；
  • 云端版如Coze 编程、ArkClaw等可以一键部署，在后续使用中也可以提供开发Agent辅助你调试。

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

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

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

Coze上安装失败的处理方式

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

export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com

npx -y @larksuite/openclaw-lark-tools install

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

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

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

这个OpenClaw版本默认把新agent的工具权限关闭。修复方式在openclaw.json加上这段内容：

读完这篇文章，你应该已经能感受到：OpenClaw 的价值不在"会回答"，而在"能把事办完"。当它和飞书通过官方插件连起来，文档、消息、日历这些真正承载工作的信息流，就不需要你再一趟趟搬运了——你只要下达目标，它就能在飞书里完成动作。

今晚插件上线，趁热开玩：去飞书里把 OpenClaw 官方插件装起来，按本文步骤完成授权和安装，挑一件你最讨厌、最重复的活儿交给它试试（整理会议纪要、从群聊里提取待办、核对档期、查资料写方案……都行）。用着不顺、遇到报错、想要的新能力，也别憋着——欢迎把问题和建议直接反馈给我们，我们会快速定位，并更快地为插件进行升级！

你还可以把你的使用心得发到你常用的平台，分享你用 OpenClaw 在飞书里解决了什么问题、节省了多少时间、有哪些坑和小技巧——这些真实经验，会让更多人少走弯路，也会推动我们把插件做得更强、更稳、更好用。

评论

(0)
未配置登录方式
暂无评论