夜雨聆风
MaxClaw搭配飞书官方插件实战
📌 前言
OpenClaw 飞书官方插件让你的 OpenClaw 以你的身份更好地调用飞书的各类能力。你说一句话，它就能直接在飞书里帮你把活儿干了！
本文将详细介绍从零开始配置飞书官方插件的完整步骤。
🧱 一、安装前提
1.1 安装好 OpenClaw/maxclaw
我使用的是maxclaw，就是minimax提供的云openclaw，它相当于在云上配好了环境，内置了一些插件和skills，解决了很多人不会部署的问题，适合新手快速上手。只要开通基础版，1个月39就可以使用maxclaw，而且还送了每个月5000的M币，每天还送200个，基本不用再花钱买大模型token了。
1.2 创建飞书应用
-
登录 飞书开放平台
-
点击「创建企业自建应用」
-
配置应用名、描述及图标，点击「创建」
1.3 添加机器人能力
-
在左侧目录选择「应用能力」→「添加应用能力」
-
选择「按能力添加」页签
-
点击「机器人」能力卡片的「添加」按钮
🔐 二、配置权限
2.1 进入权限管理
在左侧目录选择「开发配置」→「权限管理」，点击「批量导入/导出权限」
2.2 导入权限
将以下权限 JSON 复制粘贴进去：
{"scopes": {"tenant": ["contact:contact.base:readonly","docx:document:readonly","im:chat:read","im:chat:update","im:message.group_at_msg:readonly","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","application:application:self_manage","cardkit:card:write","cardkit:card:read"],"user": ["contact:user.employee_id:readonly","offline_access","base:app:copy","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","base:app:create","base:app:update","base:app:read","board:whiteboard:node:create","board:whiteboard:node:read","calendar:calendar: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","contact:contact.base:readonly","contact:user.base:readonly","contact:user:search","docs:document.comment:create","docs:document.comment:read","docs:document.comment:update","docs:document.media:download","docs:document:copy","docx:document:create","docx:document:readonly","docx:document:write_only","drive:drive.metadata:readonly","drive:file:download","drive:file:upload","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","search:docs:read","search:message","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"]}}
2.3 发布应用
-
点击顶部「创建版本」
-
配置版本号、默认能力及更新说明
-
点击「保存」→「确认发布」
2.4 获取凭证
在「基础信息」→「凭证与基础信息」中获取：
-
App ID
-
App Secret
⚙️ 三、安装插件
3.1 下载并安装 CLI
# 设置 npm 镜像npm config set registry https://registry.npmjs.org
# 下载插件curl -o /tmp/feishu-openclaw-plugin-onboard-cli.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/4d184b1ba733bae2423a89e196a2ef8f_QATOjKH1WN.tgz
# 安装npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g
# 清理rm /tmp/feishu-openclaw-plugin-onboard-cli.tgz3.2 运行安装
feishu-plugin-onboard install根据提示完成配置：
-
如果已有飞书应用，可选择沿用或创建新应用
-
填入第1步获取的 App ID 和 App Secret
🚀 四、启动 OpenClaw
openclaw gateway run出现以下内容说明插件开始监听飞书事件：
[plugins] feishu-openclaw-plugin: loaded
验证插件状态：
openclaw plugins list
-
feishu-openclaw-plugin的 Status 为 loaded ✅ -
feishu的 Status 为 disabled ✅
📱 五、配置事件订阅
5.1 配置订阅方式
-
进入飞书应用 → 「事件订阅」
-
配置请求网址（URL）
-
添加接收消息事件：
-
im.message.receive_v1 -
发布版本
🎯 六、完整能力一览
|
类别 |
能力 |
|
💬 消息 |
消息读取、发送、回复、搜索、图片/文件下载 |
|
📄 文档 |
创建、更新、读取云文档 |
|
📊 多维表格 |
创建/管理多维表格、数据表、字段、记录 |
|
📅 日历日程 |
日程管理、参会人管理、忙闲查询 |
|
✅ 任务 |
任务管理、清单、子任务、评论 |
