手把手教你用飞书官方插件接入 OpenClaw,解锁 7 大核心能力

写在前面

如果你在用 OpenClaw，但还在手动复制粘贴飞书消息、文档、日程——这篇就是为你写的。

2026 年 3 月，飞书官方推出了 OpenClaw 插件。装好之后，OpenClaw 能以你的身份直接操作飞书：读消息、写文档、查日程、改多维表格。

不用来回切换，不用复制粘贴。你说一句话，它帮你把活干了。

今天这篇，我把安装步骤、配置方法、使用技巧一次讲清。照着做，10 分钟搞定。

数据来源说明

这篇文章的信息来源：

飞书官网博客：《OpenClaw 飞书官方插件上线｜一文讲清功能、安装更新教程与常见问题！》（2026 年 3 月 5 日）
OpenClaw 官方文档：https://docs.openclaw.ai/
飞书开放平台：权限配置文档

所有步骤我都亲自验证过，能跑通。

一、什么是 OpenClaw 飞书官方插件？

简单说，这是一个让 OpenClaw 能以你的身份操作飞书的插件。

装之前：

OpenClaw 只能陪你聊天
想看飞书文档？你手动复制给它
想查日程？你截图给它
想发消息？你复制粘贴

装之后：

OpenClaw 能直接读你的飞书消息、文档、日程
能帮你写文档、改文档、创建多维表格
能帮你发消息、约会议、查忙闲

核心区别：从”会聊天的 AI”变成”能干活的飞书助手”。

二、核心能力（7 大模块）

2.1 消息管理

消息读取：群聊/单聊历史消息、话题回复
消息发送：以你的名义发消息（私聊/群聊）
消息回复：回复指定消息，支持话题回复
消息搜索：跨会话搜索消息（按关键词、发送者、时间）
资源下载：下载消息中的图片、文件、音频、视频

2.2 文档管理

创建文档：从 Markdown 创建飞书云文档
读取文档：获取文档内容（Markdown 格式）
更新文档：追加、覆盖、定位替换等 7 种模式
评论管理：添加/读取/解决文档评论

2.3 多维表格

应用管理：创建/查询/更新/删除多维表格
数据表管理：创建/查询/更新/删除数据表
字段管理：创建/查询/更新/删除字段（27 种类型）
记录管理：增删改查、批量操作、高级筛选
视图管理：创建/查询/更新/删除视图

2.4 日历日程

日历管理：查询日历列表、获取日历信息
日程管理：创建/查询/修改/删除/搜索日程
参会人管理：添加/查询/移除参会人
忙闲查询：查询 1-10 个用户的忙闲状态

2.5 任务管理

任务管理：创建/查询/更新/完成任务
清单管理：创建/查询/管理任务清单
子任务：创建/查询子任务
评论：添加/查询任务评论

2.6 联系人

用户查询：获取用户信息（姓名、部门、邮箱等）
用户搜索：按姓名/手机号/邮箱搜索
群组管理：搜索群聊、获取群信息、查询群成员

2.7 云空间

文件管理：列出/复制/移动/删除文件
文件上传：上传本地文件到云空间
文件下载：下载云空间文件到本地

三、安装步骤（10 分钟搞定）

3.1 前置条件

已安装 OpenClaw（本地或云端部署）
有飞书账号（个人版或企业版均可）
有飞书开放平台开发者权限（如需自定义机器人）

3.2 步骤一：安装 OpenClaw

本地部署（Mac/Linux）：

curl -fsSL https://openclaw.ai/install.sh | bash

本地部署（Windows）：

iwr -useb https://openclaw.ai/install.ps1 | iex

云端部署：

Coze 编程：https://docs.coze.cn/tutorial/openclaw
ArkClaw：https://www.volcengine.com/activity/codingplan-feishu

安装完成后，打开 OpenClaw Dashboard，能正常显示管理后台即成功。

3.3 步骤二：安装飞书插件

在终端执行：

npx -y @larksuite/openclaw-lark install

如果报错：

Mac/Linux：在命令前加 sudo
Windows：使用管理员权限运行终端

安装过程中：

选择”新建机器人”或”关联已有机器人”
如新建，用飞书客户端扫描二维码
选择”一键创建飞书机器人”
创建完成后，点击”打开机器人”

3.4 步骤三：用户授权

在飞书对话中发送：

/feishu auth

这会完成批量授权，让 OpenClaw 能以你的身份操作飞书。

3.5 步骤四：验证安装

在飞书对话中发送：

/feishu start

如返回版本号信息，代表安装成功。

四、常用配置命令

4.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 # 开启状态展示

4.2 话题独立上下文

开启（机器人在话题群/消息群话题模式中，针对每个话题拥有独立上下文）：

openclaw config set channels.feishu.threadSession true

关闭：

openclaw config set channels.feishu.threadSession false

4.3 回复模式

模式 1：只有@机器人才回复（最常用）

openclaw config set channels.feishu.requireMention true --jsonsh /workspace/projects/scripts/restart.sh # 重启生效

模式 2：所有消息都回复（大群慎用，容易刷屏）

openclaw config set channels.feishu.requireMention false --jsonsh /workspace/projects/scripts/restart.sh # 重启生效

模式 3：特定群@才回复（高级）

# 先设置默认所有群都不需要@openclaw config set channels.feishu.requireMention open --json # 然后给特定群设置需要@（替换成真实群 ID）openclaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true --jsonsh /workspace/projects/scripts/restart.sh # 重启生效

五、诊断命令与问题修复

5.1 常用诊断命令

/feishu start #确认是否安装成功/feishu doctor #检查配置是否正常/feishu auth #批量完成用户授权

5.2 自主修复

在终端执行：

npx @larksuite/openclaw-lark doctor

查看问题，然后执行：

npx @larksuite/openclaw-lark doctor --fix

5.3 查看版本信息

反馈问题时带上：

npx @larksuite/openclaw-lark info

查看详细配置：

npx @larksuite/openclaw-lark info --all

5.4 常见问题

问题 1：报”cannot find module xxx”

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

解决：进入插件安装目录，执行 npm install

问题 2：Coze 上安装失败

依次执行：

export NPM_CONFIG_REGISTRY=https://registry.npmmirror.comnpx -y @larksuite/openclaw-lark install

问题 3：升级到 OpenClaw 3.2 后无法正常调用工具

修复：在 openclaw.json 加上：

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

六、权限申请（如权限不足）

如出现权限不足，需要申请所需权限：

打开飞书开放平台（https://open.feishu.cn/app）
左侧选择”开发配置 > 权限管理”
单击”批量导入/导出权限”
导入以下权限
单击”下一步，确认新增权限”
单击”申请开通”
创建版本并发布

七、安全提醒

核心风险：

插件通过飞书接口连接了你的工作数据（消息、文档、日历、联系人）
AI 能读到的东西理论上就有泄露的可能

强烈建议：

先用个人账号”玩”起来，熟悉后再考虑接入工作环境
对于发送、修改、写入等重要操作，务必”先预览，再确认”
不要让 AI 处于完全脱离人工干预的”全自动驾驶”状态

写在最后

OpenClaw 飞书官方插件的价值不在”会回答”，而在”能把事办完”。

装好插件后，挑一件你最讨厌、最重复的活儿交给它试试：

整理会议纪要
从群聊里提取待办
核对档期
查资料写方案

用着不顺、遇到报错、想要新能力，随时反馈。

互动话题

你装好插件后，最想让它帮你做什么？

欢迎在评论区留言，说说你的需求。

如果这篇文章帮到你了，点个”在看”，分享给更多人。

关注我，AI 副业不迷路。