以下是基于飞书官方文档及CSDN社区经验整理的OpenClaw飞书插件安装详细教程，适用于本地或云端部署环境：
OpenClaw飞书官方插件安装教程
2026年3月最新版
一、前置条件
-
已部署OpenClaw
- 支持系统：Linux/macOS/Windows
- 最低版本：
- Linux/macOS:
openclaw 2026.2.26+ - Windows:
openclaw 2026.3.2+
- Linux/macOS:
- 升级命令：
npm install -g openclaw --registry=https://registry.npmmirror.com
-
飞书开放平台账号
- 需注册企业自建应用，获取
AppID和AppSecret。
- 需注册企业自建应用，获取
二、创建飞书机器人并配置权限
1. 创建企业自建应用
- 登录open.feishu.cn/，进入「控制台」→「应…
- 填写应用名称（如
OpenClawBot），上传图标，点击「创建」。
2. 添加机器人能力
- 在左侧菜单选择「应用能力」→「添加应用能力」→「按能力添加」。
- 找到「机器人」卡片，点击「添加」。
3. 导入权限配置
- 进入「开发配置」→「权限管理」→「批量导入/导出权限」。
- 替换权限JSON（关键权限包括文档、消息、日程等），点击「申请开通」：
{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"bitable:app",
"bitable:app:readonly",
"cardkit:card:read",
"cardkit:card:write",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user.employee_id:readonly",
"corehr:file:download",
"docs:document.content:read",
"docx:document",
"docx:document.block:convert",
"docx:document:readonly",
"drive:drive",
"drive:drive:readonly",
"event:ip_list",
"im:chat",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:chat:read",
"im:chat:update",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.group_msg",
"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",
"sheets:spreadsheet",
"task:task:read",
"task:task:write",
"wiki:wiki",
"wiki:wiki:readonly"
],
"user": [
"aily:file:read",
"aily:file:write",
"base:app:copy",
"base:app:create",
"base:app:read",
"base:app:update",
"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",
"board:whiteboard:node:create",
"board:whiteboard:node: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",
"calendar:calendar:read",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user.employee_id:readonly",
"contact:user:search",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.media:download",
"docs:document.media:upload",
"docs:document:copy",
"docs:document:export",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:file:download",
"drive:file:upload",
"im:chat.access_event.bot_p2p_chat:read",
"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.send_as_user",
"im:message:readonly",
"offline_access",
"search:docs:read",
"search:message",
"sheets:spreadsheet.meta:read",
"sheets:spreadsheet:create",
"sheets:spreadsheet:read",
"sheets:spreadsheet:write_only",
"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"
]
}
}
4. 发布应用
- 创建版本：填写版本号、更新说明，点击「保存」→「确认发布」。
- 获取凭证：在「基础信息」→「凭证与基础信息」中记录
AppID和AppSecret。
三、安装飞书官方插件
1. 绑定飞书应用
npx -y https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/3001f02e44c6269c6df09c01aad601cd_QWN3XUhUSQ.tgz install
#或者直接使用最新版本
npx -y https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/879b06f872058309ef70f49bcd38a71f_Pr8pNIJ9J9.tgz update
- 若提示权限不足，添加
sudo,windows使用管理员权限（CMD,Powershell)：sudo npx -y https://.../install
2. 配置插件参数
# 启用飞书插件并设置AppID/AppSecret
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.appId "你的AppID"
openclaw config set channels.feishu.appSecret "你的AppSecret"
3. 启动插件监听
openclaw gateway run
- 成功提示：
Gateway is running...
四、权限绑定与测试
1. 机器人配对授权
- 在飞书群聊中@机器人发送任意消息，获取配对码（5分钟内有效）。私聊也可以，但请确认与二.3中对应的权限匹配。
- 终端执行授权：
openclaw pairing approve feishu <配对码> --notify
2. 测试插件功能
- 输入指令检查版本：
/feishu start - 列出插件能力：
/ffeishu list #学习一下我安装的新飞书插件，列出有哪些能力 #飞书安装检查 /feishu doctor
五、高级配置
1. 流式输出启用
openclaw config set channels.feishu.streaming true
2. 群聊回复模式
- 仅@回复（默认）：
{ "channels": { "feishu": { "requireMention": true } } } - 全体消息回复（需申请敏感权限）：
openclaw config set channels.feishu.requireMention false
3. 多任务并行
openclaw config set channels.feishu.threadSession true
六、常见问题排查
1. 模块缺失错误
# 进入插件目录安装依赖
cd ~/.openclaw/plugins/feishu-openclaw-plugin
npm install
2. 权限验证失败
- 检查飞书应用是否已发布。
- 确认
AppID和AppSecret正确无误。
3. 版本不兼容
# 升级OpenClaw到最新版
npm update -g openclaw
4. 事件订阅失败
- 确保飞书开放平台已配置「长连接」事件订阅（消息、reaction等）。
- 检查防火墙是否拦截回调地址。
七、注意事项
- 权限最小化原则：仅授权必要权限，避免泄露敏感数据。
- 版本更新：每日检查插件更新，运行：
npx https://.../update - 企业微信/Slack适配：部分配置需参考对应平台文档。
附录：完整配置示例
{
"channels": {
"feishu": {
"enabled": true,
"appId": "cli_xxxxxxxx",
"appSecret": "xxxxxxxxxxxxxxxxxxxx",
"requireMention": true,
"groupPolicy": "open",
"groups": {
"oc_123456": {
"requireMention": true
}
},
"streaming": true,
"footer": {
"elapsed": true,
"status": true
}
}
}
}
通过以上步骤，您可快速将OpenClaw与飞书集成，实现文档处理、日程管理、消息自动化等场景的智能化升级。遇到问题可随时联系飞书开发者支持或加入社区交流群！
