OpenClaw飞书官方插件安装教程

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

OpenClaw飞书官方插件安装教程

2026年3月最新版

一、前置条件

1. 已部署OpenClaw

   • 支持系统：Linux/macOS/Windows
   • 最低版本：
     • Linux/macOS:openclaw 2026.2.26+
     • Windows:openclaw 2026.3.2+
   • 升级命令：

     npminstall-gopenclaw--registry=https://registry.npmmirror.com

2. 飞书开放平台账号

   • 需注册企业自建应用，获取AppID和AppSecret。

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

1. 创建企业自建应用

1. 登录https://open.feishu.cn/，进入「控制台」→「应用」→「创建企业自建应用」。
2. 填写应用名称（如OpenClawBot），上传图标，点击「创建」。

2. 添加机器人能力

1. 在左侧菜单选择「应用能力」→「添加应用能力」→「按能力添加」。
2. 找到「机器人」卡片，点击「添加」。

3. 导入权限配置

1. 进入「开发配置」→「权限管理」→「批量导入/导出权限」。
2. 替换权限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. 发布应用

1. 创建版本：填写版本号、更新说明，点击「保存」→「确认发布」。
2. 获取凭证：在「基础信息」→「凭证与基础信息」中记录AppID和AppSecret。

三、安装飞书官方插件

1. 绑定飞书应用

npx-yhttps://sf3-cn.feishucdn.com/obj/open-platform-opendoc/3001f02e44c6269c6df09c01aad601cd_QWN3XUhUSQ.tgzinstall#或者直接使用最新版本npx-yhttps://sf3-cn.feishucdn.com/obj/open-platform-opendoc/879b06f872058309ef70f49bcd38a71f_Pr8pNIJ9J9.tgz update

• 若提示权限不足，添加sudo：

  sudonpx-yhttps://.../install

2. 配置插件参数

# 启用飞书插件并设置AppID/AppSecretopenclaw configsetchannels.feishu.enabledtrueopenclaw configsetchannels.feishu.appId"你的AppID"openclaw configsetchannels.feishu.appSecret"你的AppSecret"

3. 启动插件监听

openclaw gateway run

• 成功提示：Gateway is running...

四、权限绑定与测试

1. 机器人配对授权

1. 在飞书群聊中@机器人发送任意消息，获取配对码（5分钟内有效）。私聊也可以，但请确认与二.3中对应的权限匹配。
2. 终端执行授权：

   openclaw pairing approve feishu<配对码>--notify

2. 测试插件功能

• 输入指令检查版本：

  /feishu start

• 列出插件能力：

  /ffeishu list#学习一下我安装的新飞书插件，列出有哪些能力#飞书安装检查/feishu doctor

五、高级配置

1. 流式输出启用

openclaw configsetchannels.feishu.streamingtrue

2. 群聊回复模式

• 仅@回复（默认）：

  {"channels":{"feishu":{"requireMention":true}}}

• 全体消息回复（需申请敏感权限）：

  openclaw configsetchannels.feishu.requireMentionfalse

3. 多任务并行

openclaw configsetchannels.feishu.threadSessiontrue

六、常见问题排查

1. 模块缺失错误

# 进入插件目录安装依赖cd~/.openclaw/plugins/feishu-openclaw-pluginnpminstall

2. 权限验证失败

• 检查飞书应用是否已发布。
• 确认AppID和AppSecret正确无误。

3. 版本不兼容

# 升级OpenClaw到最新版npmupdate-gopenclaw

4. 事件订阅失败

• 确保飞书开放平台已配置「长连接」事件订阅（消息、reaction等）。
• 检查防火墙是否拦截回调地址。

七、注意事项

1. 权限最小化原则：仅授权必要权限，避免泄露敏感数据。
2. 版本更新：每日检查插件更新，运行：

   npx https://.../update

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