OpenClaw 接入飞书指南
本文将介绍如何将 OpenClaw 接入飞书，实现读文档、写文档、操作表格及管理日程的功能。配置过程分为四个阶段。
第一阶段：在飞书上创建机器人
创建应用
打开飞书开放平台，点击创建企业自建应用。
填写应用名称、描述、图标后点击创建。
添加机器人能力
在配置页面找到「添加应用能力」里的机器人模块，点击添加。
批量导入权限
点击左侧的权限管理，再点批量导入导出权限按钮。
删除默认内容，粘贴以下配置：
{"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"]}}
点击「下一步，确认新增权限」并确定数据范围。
发布上线
点击页面顶部的创建版本按钮，填写版本号后保存。
申请线上发布，在飞书开发小助手通知中进入管理后台审核，选择机器人并点通过。
⚠️ 注意：此处为开发者自审批流程。
记录凭证
回到基础信息 → 凭证与基础信息，记录 App ID 和 App Secret。
⚠️ 安全提示：App Secret 是敏感凭证，请勿公开。
第二阶段：在服务器上安装飞书插件
SSH 连接服务器，执行以下命令：
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.tgz
执行安装命令：
feishu-plugin-onboard install
按提示输入 App ID 和 App Secret。
看到 Installation finished 表示成功。最后重启 gateway：
openclaw gateway restart
第三阶段：配置长连接
回到飞书开放平台，找到事件与回调 → 事件配置。
点击订阅方式右侧铅笔图标，选择长连接方式。
点击添加事件，搜索并勾选'接收消息'。
完成后需再次创建版本并发布使配置生效。
第四阶段：让机器人正式上岗
群聊使用
在飞书群中点击群机器人，添加刚才创建的机器人。
在群里 @机器人即可测试。
私聊配对
双击机器人头像进入私聊，发送消息获取配对码。
在服务器执行：
openclaw pairing approve feishu <配对码>--notify
替换 <配对码> 为实际值，授权成功后私聊通道即打通。
集成完成后，OpenClaw 可直接操作飞书工作台，包括文档、表格及日程管理。
