OpenClaw 飞书官方插件：把飞书工作台交给 AI Agent 的官方姿势

OpenClaw 是这两年最出圈的开源 AI Agent 框架之一——装在你自己的设备上，通过 Telegram、飞书这类聊天软件给它下指令，它就能真的去读文件、跑命令、操作各种应用，而不是只陪你聊天。

但「能收发消息」只是第一步。真正值钱的是让 Agent 操作你飞书里的东西：翻聊天记录、写云文档、改多维表格、约会议室。以前这要自己配长连接、手动加一堆机器人权限，劝退大部分人。现在飞书开放平台官方出了 OpenClaw 插件，一条命令装完，扫码授权就能用。

适用：OpenClaw 用户 / 飞书自动化爱好者｜插件版本：2026.6.10（飞书团队官方维护）｜更新：2026-09-08

一、这个插件到底能干什么？

一句话：让 OpenClaw 以「机器人」或「你的身份」直接读写飞书工作台，官方维护，覆盖飞书绝大多数高频业务：

业务类别	能力
💬 消息	读群聊/单聊历史、发消息/回复（含卡片）、消息搜索、图片/文件下载
📄 云文档	创建、更新、读取文档
📊 多维表格	增删改查、批量操作、视图管理
📊 电子表格	创建、编辑、查看
📅 日历	日程增删改查、忙闲查询、参会人管理
✅ 任务	任务/清单管理、子任务、评论

也就是说，你在飞书里日常点鼠标的那几件事，Agent 都能替你以命令的方式完成——和它聊一句话，比你自己开五个 Tab 找入口快得多。

二、3 分钟装好

1. 安装插件

npx -y @larksuite/openclaw-lark install

执行过程中会引导你新建机器人或关联已有机器人，然后弹出二维码，飞书扫码授权即可——不需要再手动配长连接、不需要去开放平台逐个勾权限，这也是官方插件比第三方方案省心的地方。

2. 在飞书里验证

装完回到飞书对话，给 Agent 发斜杠命令确认：

命令	用途
`/feishu start`	确认插件安装成功
`/feishu doctor`	检查配置是否完整
`/feishu auth`	批量给用户授权

如果一切正常，从第一条「帮我看看今天有什么会」开始，它就能动手了。

三、两种身份，先想清楚用哪种

安装时最关键的选择是让 Agent 以什么身份行动，这决定了权限边界：

以机器人身份：适合做「团队助手」——挂群里，处理群聊、发通知、读写公共文档。它的一举一动都顶着机器人马甲，好审计。
以你的身份：适合个人使用——读你自己的文档、搜你的消息、改你的日程。注意，这种模式下 Agent 是以你的名义操作，权限更大，风险也更高。

我的建议：先拿个人账号、以机器人身份在自己小范围里玩，摸清它怎么干活，再考虑接入工作环境。

四、插件内还能一键装飞书 CLI

如果你想让 OpenClaw 在飞书里干更重的活，官方还提供了「一键安装飞书 CLI」——把官方安装文档链接丢给飞书里的 Agent，它会自己照着文档把 CLI 装好。

这和插件是互补关系：插件负责把 OpenClaw 接进飞书，飞书 CLI 负责在接入后执行更细粒度的操作（它有 200+ 精选命令、24+ 现成 Agent 技能，怎么用我之前专门写过，见文末）。

五、几个值得开的配置

装好只是开始，下面几个开关能明显改善体验：

想实现的效果	命令
回复实时流式输出（不用干等）	`openclaw config set channels.feishu.streaming true`
每个话题独立上下文（不串台）	`openclaw config set channels.feishu.threadSession true`
必须 @ 才回复（默认推荐）	`openclaw config set channels.feishu.requireMention true --json`
只允许指定主人触发	`groupPolicy: "allowlist"` + `groupAllowFrom: ["ou_XXX"]`

改完配置记得重启网关生效：openclaw gateway restart。

六、群聊回复模式：按群定规则

放在群里用，最怕的是 Agent 什么消息都接话。插件提供四档模式：

模式	行为	适用
模式 1	仅主人 @ 才回复	默认推荐
模式 2	任何人 @ 都回复	工作群
模式 3	群里所有消息都回	慎用，容易刷屏
模式 4	按群指定不同规则	混合场景

拿不准就从模式 1 起步——先让 Agent 只在你明确召唤时才开口，跑顺了再放宽。

七、出问题了怎么查

插件自带一套诊断命令，从轻到重：

/feishu doctor                    # 飞书里直接查配置
npx @larksuite/openclaw-lark doctor       # 命令行诊断
npx @larksuite/openclaw-lark doctor --fix # 自动修复
npx @larksuite/openclaw-lark info --all   # 查看版本详情

几个已知坑：

升级后群消息不回复 → 给配置加 messages.groupChat.visibleReplies: "automatic"
提示权限不足 → 从官方文档复制全量权限 JSON 批量导入，别手动一个个勾
安装超时/失败（尤其在国内网络） → 先执行 export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com 再装
多 Agent 对应多机器人 → 为每个 Agent 创建独立机器人，配各自的 App ID/Secret，互不干扰