夸克文档-海量教育资料模版文档，ppt模板、简历模板、文档免费下载

卷AI的摆烂者
4 阅读4分钟

OpenClaw 飞书官方插件完整指南

原文链接：www.feishu.cn/content/art…

一、OpenClaw 是什么？

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

核心特点：

  • 完全属于你的私人助理

  • 拥有长期记忆

  • 能力持续进化

  • 7×24 小时主动干活

  • 直接操作你的电脑和本地文件

二、飞书官方插件的核心价值

解决痛点

以前接入飞书的 AI 经常说"我没有飞书文档/消息/日历权限"，需要反复复制粘贴。现在有了官方插件，OpenClaw 可以直接以"你的"身份操作飞书。

主要能力

| 类别 | 能力 | | --- | --- | | 💬 消息 | 读取历史、发送回复、搜索消息、下载图片/文件 | | 📄 文档 | 创建、更新、读取云文档 | | 📊 多维表格 | 管理应用/数据表/字段/记录、批量操作、高级筛选 | | 📅 日程 | 管理日程、创建/查询/修改/删除/搜索、参会人管理、忙闲查询 | | ✅ 任务 | 任务管理、清单管理、子任务、评论 |

为什么选择飞书？

  • 中文界面，更容易上手

  • 国内用户最多，生态更好

  • 开放能力强，玩法更多

三、安装步骤

1. 前置条件

  • OpenClaw 已安装（推荐版本：2026.2.26）升级命令：

  • 飞书机器人已创建

2. 安装插件命令

# 切换 npm 源
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

3. 启动 OpenClaw

openclaw gateway run

4. 验证安装

# 检查插件状态
openclaw plugins list

# 在飞书中测试
/feishu start

四、常用配置

机器人回复模式

| 模式 | 效果 | 配置 | | --- | --- | --- | | 模式1 | 只有 @机器人 才回复 | requireMention: true | | 模式2 | 所有消息都回复 | requireMention: false | | 模式3 | 特定群 @ 才回复 | 单独配置 groups |

设置方法：

# 需要 @ 才回复（推荐）
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

# 重启生效
sh /workspace/projects/scripts/restart.sh

流式输出配置

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

# 显示耗时
openclaw config set channels.feishu.footer.elapsed true

# 显示状态
openclaw config set channels.feishu.footer.status true

五、常用命令

插件管理

# 更新插件
feishu-plugin-onboard update

# 检查问题
feishu-plugin-onboard doctor

# 自动修复
feishu-plugin-onboard doctor --fix

# 查看版本信息
feishu-plugin-onboard info

# 查看详细配置
feishu-plugin-onboard info --all

诊断与帮助

  • /feishu start - 确认是否安装成功

  • /feishu doctor - 检查配置是否正常

  • /feishu auth - 批量完成用户授权

六、常见问题

Q1: 插件安装完毕后报 "cannot find module xxx"？

原因： 系统没有安装插件的依赖

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

Q2: 如何快速完成权限授权？

告诉 AI："我想授予所有用户权限"，即可批量授权。

Q3: 如何让 AI 学会使用新插件？

说："学习一下我安装的新飞书插件，列出有哪些能力"

七、总结

OpenClaw + 飞书官方插件 = 你的数字分身

不再需要反复复制粘贴，说一句话就能让 AI 在飞书里把活儿干了：

  • 整理会议纪要

  • 从群聊提取待办

  • 核对档期

  • 查资料写方案

  • 创建多维表格

今晚就去试试吧！🚀

八、官方插件 vs 其他飞书插件

经过实际测试对比，飞书官方插件具有以下核心优势：

🔥 独家功能：知识库操作

| 功能 | 官方插件 | 其他插件 | | --- | --- | --- | | 创建知识库 | ✅ 支持 | ❌ 不支持 | | 删除知识库 | ❌ 不支持 | ❌ 不支持 | | 在知识库中创建文档 | ✅ 支持 | ❌ 不支持 | | 列出知识库列表 | ✅ 支持 | ❌ 不支持 | | 知识库节点管理 | ✅ 支持 | ❌ 不支持 |

结论： 目前只有官方插件能够操作知识库，这是核心差异化能力。

📋 完整功能对比

| 功能类别 | 官方插件 | 其他插件 | | --- | --- | --- | | 稳定性 | 官方维护，稳定可靠 | 可能不稳定 | | 权限授权 | 一次性批量授权 | 授权繁琐 | | 文档操作 | 创建/读取/更新 | 可能受限 | | 多维表格 | 完整支持 | 可能受限 | | 日程管理 | 完整支持 | 可能受限 | | 任务管理 | 完整支持 | 可能受限 | | 消息发送 | 用户身份发送 | 可能受限 | | 知识库 | ✅ 完整支持 | ❌ 不支持 |

🎯 为什么选择官方插件？

  1. 知识库独占能力 - 唯一支持知识库操作的插件

  2. 官方维护 - 由飞书官方维护，更稳定可靠

  3. 简化授权 - 一次性批量授权，无需反复操作

  4. 能力完整 - 覆盖飞书所有开放能力

  5. 快速迭代 - 官方插件每日更新，快速响应需求

⚠️ 注意事项

  • 如果你之前已经安装了其他飞书插件，安装官方插件时会自动禁用其他插件

  • 官方插件目前不支持 Windows（已知 bug，正在修复中）

  • 插件每日更新，建议定期使用 feishu-plugin-onboard update 更新

💡 最佳实践

推荐使用官方插件作为唯一的飞书接入方式，避免同时使用多个插件导致冲突。

avatar
文章
阅读
粉丝