OpenClaw飞书官方插件安装教程

以下是基于飞书官方文档及CSDN社区经验整理的OpenClaw飞书插件安装详细教程，适用于本地或云端部署环境：

OpenClaw飞书官方插件安装教程

2026年3月最新版

一、前置条件

二、创建飞书机器人并配置权限

1. 创建企业自建应用

2. 添加机器人能力

3. 导入权限配置

{
"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. 发布应用

三、安装飞书官方插件

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. 机器人配对授权

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等）。
• 检查防火墙是否拦截回调地址。

七、注意事项

附录：完整配置示例

{
"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与飞书集成，实现文档处理、日程管理、消息自动化等场景的智能化升级。遇到问题可随时联系飞书开发者支持或加入社区交流群！