之前用社区插件接入飞书的人应该都有体会——AI 动不动就说「我没有飞书文档权限，请把内容发给我」，然后你就变成了人肉搬运工。官方插件解决的就是这个问题：授权之后，OpenClaw 可以直接伸手去拿它需要的信息，帮你在飞书里把活干了。

官方插件能做什么

一句话概括：你说一句话，它能直接在飞书里操作。具体能力包括查看文档、查找资料、核对日历档期、理解群聊上下文等。此外还支持流式输出卡片回复（需手动开启）、识别合并转发消息、发表情等交互增强。

需要注意的是，由于插件使用的是用户身份授权，暂不适合作为群机器人供多人共用，安装前请评估使用场景。

安装前的准备

首先确保已安装 OpenClaw，版本要求：

  • Linux/macOS：2026.2.26 及以上
  • Windows：2026.3.2 及以上（部分版本仍有兼容问题，建议暂时回避）

通过 openclaw -v 查看当前版本，版本过低可执行升级：

npm install -g openclaw

第一步：创建飞书机器人并导入权限

这一步稍微繁琐但很重要——导入完整权限列表能避免后续反复授权的麻烦。

  1. 登录飞书开放平台，点击「创建企业自建应用」
  2. 填写应用名、描述及图标，完成创建
  3. 在左侧目录选择「应用能力 - 添加应用能力」，切换到「按能力添加」页签，添加「机器人」能力
  4. 进入「开发配置 > 权限管理」，点击「批量导入/导出权限」，在导入页签中替换权限列表并申请开通
  5. 点击顶部「创建版本」，配置版本号等信息后保存并发布
  6. 在「基础信息 > 凭证与基础信息」中记录 App ID 和 App Secret，后面要用

第二步：安装飞书插件

如果之前装过其他飞书插件，安装过程会自动禁用旧插件，不需要额外处理。

在终端依次执行安装命令。安装过程中，如果历史已关联飞书应用，可以选择沿用还是关联新应用。选择新应用的话，填入上一步拿到的 App ID 和 App Secret。

验证安装是否成功：如果终端显示插件已开始监听飞书事件，说明启动成功。运行 openclaw plugins list，确认 feishu-openclaw-plugin 的 Status 为 loaded，原来的 feishu 插件 Status 为 disabled 即可。

第三步：配置事件订阅和卡片回调

这一步容易被忽略，但不配置卡片回调的话，AI 感知不到你点击卡片按钮的操作。

进入飞书开放平台：

  1. 事件订阅：配置方式选「长连接」，添加事件：接收消息、消息被 reaction、消息被取消 reaction
  2. 卡片回调：配置方式同样选「长连接」，添加回调
  3. 发布新版本并等待审核通过

第四步：配对并开始使用

  1. 在飞书中向机器人发送任意消息，系统会生成一个配对码（字母+数字组合，5分钟有效）
  2. 在终端执行绑定：openclaw pairing approve feishu <配对码> --notify
  3. 按提示完成授权，让 OpenClaw 能以你的身份操作消息、文档、多维表格、日历等

如果想一次性搞定所有权限授权，直接告诉 AI「我想授予所有用户权限」即可。也可以后续在对话框中输入 /feishu auth 批量授权。

验证安装成功：发送 /feishu start，返回版本号信息即表示成功。最后别忘了让 AI 学习新能力——跟它说「学习一下我安装的新飞书插件，列出有哪些能力」。

插件更新与问题排查

更新插件的方式因平台而异。Linux/macOS 下：

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
rm /tmp/feishu-openclaw-plugin-onboard-cli.tgz

如果权限不够，在 npm install 前加 sudo。

Windows 下：

npm config set registry https://registry.npmjs.org
curl -o "%TEMP%\feishu.tgz" https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/195a94cb3d9a45d862d417313ff62c9c_gfW8JbxtTd.tgz
npm install -g "%TEMP%\feishu.tgz"
del "%TEMP%\feishu.tgz"

遇到问题时，几个自检命令很实用：

  • /feishu start：确认安装状态
  • /feishu doctor：检查配置是否正常
  • /feishu auth：批量完成用户授权
  • feishu-plugin-onboard info：查看版本信息（反馈问题时带上）
  • feishu-plugin-onboard info --all：查看详细配置

插件内置了常见问题的解决方案，遇到问题可以先问 AI 试试，也可以运行 fix 命令尝试自动修复。

写在最后

对于用 OpenClaw 搭建个人工作流的人来说，这个官方插件的价值很明确：把飞书从一个需要手动搬运信息的「外部系统」，变成了 AI 可以直接操作的「工作台」。虽然安装流程确实有点长，但配置好之后的使用体验是质的提升。建议先在个人场景下跑通整个流程，再考虑更复杂的自动化应用。