使用OpenClaw飞书插件玩转飞书

本插件目前处于快速迭代阶段，请谨慎尝试。为了提供更优质的用户体验，产品研发团队正在快速优化迭代，每天

💡OpenClaw 使用建议

先拿个人账号安全地"玩"起来，等后续安全隔离能力更成熟了，再考虑接入真实工作环境。

使用过程中遇到任何问题或体验不佳的地方，随时向我们反馈，我们正在持续快速迭代中！

从 0 安装飞书插件

步骤一：安装并配置 OpenClaw

根据官方指南，执行以下安装命令，安装 OpenClaw：
1. Linux /MacOS ：curl -fsSL ``https://openclaw.ai/install.sh`` | bash
2. Windows ：iwr -useb ``https://openclaw.ai/install.ps1`` | iex
根据提示信息完成 OpenClaw 配置。以方舟 Coding Plan 套餐进行对接为例，配置方式参考 Coding Plan 接入 OpenClaw 官方文档。
安装成功后，可以打开 OpenClaw Dashboard URL，正常显示管理后台则代表安装成功。

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

步骤二：安装飞书官方插件

在命令行终端中，执行以下安装指令。

若执行命令行出错，可在命令行前增加 sudo 重新执行。

复制代码

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

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

若选择新建机器人，可通过飞书客户端扫描二维码，选择 一键创建飞书机器人。
1. 如果 Windows 设备中无法扫码成功，可能是因为终端的分辨率问题导致，建议更换终端使用 Cmder。
创建完成后，点击 打开机器人，在飞书中向机器人发送任意消息，即可开始对话。

若希望快速完成用户授权，便于后续 OpenClaw 通过你的身份完成消息、文档、多维表格、日历等任务，可以在飞书对话中发送 /feishu auth`` 来完成批量授权。
为了让 OpenClaw 能学会这些新技能并正确使用，建议在飞书对话中发送 学习一下我安装的新飞书插件，列出有哪些能力。

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

升级飞书插件版本

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

运行 openclaw -v 命令查看已安装的 OpenClaw 的版本，新版插件对 OpenClaw 的版本要求如下。若低于该版本，插件运行可能出现异常，可执行 npm install -g openclaw ****命令升级。
1. Linux /MacOS： 2026.2.26 及以上
2. Windows： 2026.3.2 及以上
在终端中运行以下命令升级飞书官方插件到最新版本：

若执行该命令行出错，可在命令行前增加 sudo 重新执行。

复制代码

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

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

目前插件支持的默认方式是机器人被拉进群后，只有 at 机器人时才可回复。

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

配置方法

复制代码

# 设置需要 @ 才回复
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"}}}

模式 2：不用 @，所有消息都回复

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

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

模式 3： 只有指定群 @机器人才回复（高级）

效果

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

配置方法

第一步：获取群 ID

可通过以下任意方式获取目标群 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}}}}}

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

详细操作参考：如何在飞书插件中配置 OpenClaw 关联多个飞书机器人，对应不同Agent

快捷方法：

创建新的飞书机器人，用于关联到新的账号上

一键创建一个OpenClaw 机器人：立即创建

告诉 AI 你想创建一个怎样的新 Agent，以及这个 Agent 关联的飞书账号是什么，并将操作指南发给 OpenClaw 请他自己完成对应配置：如何在飞书插件中配置 OpenClaw 关联多个飞书机器人，对应不同Agent

如何集成飞书项目读写能力？

参考文档：OpenClaw x 飞书项目集成实践

常用诊断命令与问题修复方法

可以在与 OpenClaw 的对话中发送以下命令：

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

插件中也内置了常见问题的解决方案，遇到问题都可以先问问小龙虾。如果不行，则运行以下指令查看问题，并自主修复：

复制代码

npx @larksuite/openclaw-lark-tools doctor

运行 fix 尝试自动修复：

复制代码

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

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

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

npx @larksuite/openclaw-lark-tools info

--all 查看详细配置信息

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

常见问题

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

在左侧导航栏选择 权限管理 ，点击 批量导入/导出权限。
在导入页签中，复制下面权限替换原有示例，点击 下一步，确认新增权限 按钮。

{
"scopes": {
"tenant": [
"contact:contact.base:readonly",
"docx:document:readonly",
"im:chat:read",
"im:chat:update",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"application:application:self_manage",
"cardkit:card:write",
"cardkit:card:read"
],
"user": [
"contact:user.employee_id:readonly",
"offline_access","base:app:copy",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:record:create",
"base:record:delete",
"base:record:retrieve",
"base:record:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"base:app:create",
"base:app:update",
"base:app:read",
"sheets:spreadsheet.meta:read",
"sheets:spreadsheet:read",
"sheets:spreadsheet:create",
"sheets:spreadsheet:write_only",
"docs:document:export",
"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",
"contact:user:search",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.media:download",
"docs:document:copy",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:file:download",
"drive:file:upload",
"im:chat.members:read",
"im:chat:read",
"im:message",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user",
"im:message:readonly",
"search:docs:read",
"search:message",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"task:comment:read",
"task:comment:write",
"task:task:read",
"task:task:write",
"task:task:writeonly",
"task:tasklist:read",
"task:tasklist:write",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only"
]
}
}

确认导入权限无误后，点击 申请开通 按钮。
"应用身份权限"可访问的数据范围的设置保持默认 "与应用的可用范围一致 " ，点击确认完成操作。

没有 OpenClaw 应该如何部署

OpenClaw 是本次介绍的飞书插件的运行基础，请先选择符合自己需要的部署方案完成部署。
本地版建议使用 TRAE SOLO 等编程 Agent 辅助安装；
云端版如 Coze 编程、ArkClaw等可以一键部署，在后续使用中也可以提供开发 Agent 辅助你调试；你可以通过视频感受下该类产品的快捷部署方式⬇️

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

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

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

Coze上安装失败的处理方式

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

// 先执行
export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com

//👆若执行该行命令行出错，可在命令行前增加 sudo 重新执行。
npx -y @larksuite/openclaw-lark-tools install
检查老插件的配置，参考下图。如果为true，需要改成 false。

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

这个 OpenClaw 版本默认把新 agent 的工具权限关闭。修复方式为在 openclaw.json 找到并修改为下面这段内容：

复制代码

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

飞书官方插件与 OpenClaw 社区原有插件有何区别

飞书官方插件，能以用户身份读写消息、文档等，体验更丝滑；以下对比由 AI 整理，供参考。

使用OpenClaw飞书插件玩转飞书

💡OpenClaw 使用建议

从 0 安装飞书插件

步骤一：安装并配置 OpenClaw

步骤二：安装飞书官方插件

升级飞书插件版本

高级配置指令

切换到流式输出

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

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

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

如何集成 飞书项目 读写能力？

常用诊断命令与问题修复方法

常见问题

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

没有 OpenClaw 应该如何部署

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

Coze上安装失败的处理方式

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

飞书官方插件与 OpenClaw 社区原有插件有何区别

如何集成飞书项目读写能力？