openclaw

关注公众号 jb51net

关闭
AI > openclaw >

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

i建模

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

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. 创建企业自建应用

  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 -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

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

四、权限绑定与测试

1. 机器人配对授权

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

2. 测试插件功能

五、高级配置

1. 流式输出启用

openclaw config set channels.feishu.streaming true

2. 群聊回复模式

3. 多任务并行

openclaw config set channels.feishu.threadSession true

六、常见问题排查

1. 模块缺失错误

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

2. 权限验证失败

3. 版本不兼容

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

4. 事件订阅失败

七、注意事项

  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飞书官方插件安装内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！