OpenClaw飞书官方插件安装教程(3月最新版)

目录

• OpenClaw飞书官方插件安装教程
• 一、前置条件
• 二、创建飞书机器人并配置权限
• 1. 创建企业自建应用
• 2. 添加机器人能力
• 3. 导入权限配置
• 4. 发布应用
• 三、安装飞书官方插件
• 1. 绑定飞书应用
• 2. 配置插件参数
• 3. 启动插件监听
• 四、权限绑定与测试
• 1. 机器人配对授权
• 2. 测试插件功能
• 五、高级配置
• 1. 流式输出启用
• 2. 群聊回复模式
• 3. 多任务并行
• 六、常见问题排查
• 1. 模块缺失错误
• 2. 权限验证失败
• 3. 版本不兼容
• 4. 事件订阅失败
• 七、注意事项
• 附录：完整配置示例
• 总结

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

2026年3月最新版

1. 已部署OpenClaw

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

         npm install -g openclaw --registry=https://registry.npmmirror.com

2. 飞书开放平台账号

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

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

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

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"
    ]
  }
}

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

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

# 启用飞书插件并设置AppID/AppSecret
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.appId "你的AppID"
openclaw config set channels.feishu.appSecret "你的AppSecret"

openclaw gateway run

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

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

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

• 输入指令检查版本：

  /feishu start

• 列出插件能力：

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

openclaw config set channels.feishu.streaming true

• 仅@回复（默认）：

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

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

  openclaw config set channels.feishu.requireMention false

openclaw config set channels.feishu.threadSession true

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

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

# 升级OpenClaw到最新版
npm update -g openclaw

• 确保飞书开放平台已配置「长连接」事件订阅（消息、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与飞书集成，实现文档处理、日程管理、消息自动化等场景的智能化升级。

到此这篇关于OpenClaw飞书官方插件安装教程的文章就介绍到这了,更多相关OpenClaw飞书官方插件安装内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！