OpenClaw 2.7.5飞书绑定与长连接配置权威指南（含安装包）

OpenClaw 飞书机器人配置教程｜一键对接飞书，实现聊天下达 AI 指令

适配版本：OpenClaw v2.7.5（小龙虾）
前置要求：已部署 OpenClaw Windows 端（Win10/Win11 均可）
核心效果：配置完成后，在飞书聊天窗口直接向机器人发送自然语言指令，OpenClaw 自动拆解任务、操控电脑完成操作——远程下达 AI 任务，就这么简单。

先把几个核心判断放前面：整个过程就是按步骤填信息、点按钮，没有复杂的命令行操作，只要按着来，十分钟内就能搞定。当然，前提是 OpenClaw 已经在 Windows 上部署好并且正常运行（Gateway 在线）。如果还没部署，先搞定基础运行环境，再回来继续。

一、配置前必看

你需要的只是：一个飞书账号（个人或企业均可，企业账号需要应用开发权限）。配置过程中 OpenClaw 要保持运行，不要关掉。飞书开放平台的操作要严格按步骤来——权限导入和事件订阅缺一不可，漏掉任何一个，机器人就会“装死”。配置完成后记得重启 OpenClaw，让新凭证生效。

二、进入飞书开放平台并登录开发者后台

打开飞书开放平台官网（https://open.feishu.cn），用飞书账号扫码或密码登录。进入开发者后台后，个人账号直接可用，不需要额外认证。

三、创建企业自建应用

在开发者后台首页，点击“创建应用”按钮。应用类型选择“企业自建应用”——仅本企业或个人可用，无需上架审核，能快速生效。然后进入应用创建页面，准备填写基础信息。

四、填写应用基础信息

按要求填写以下信息，完成后点击“创建”：

• 应用名称：自定义，建议便于识别（比如“OpenClaw 机器人”、“小龙虾 AI”、“虾壳云”）
• 应用描述：简要说明（如“OpenClaw AI 智能体，飞书聊天下达指令”），字数不超过120
• 应用图标：自定义上传（JPEG/PNG/SVG/BMP 格式，2MB 以内，分辨率≥240×240px）。直接用 OpenClaw 龙虾 Logo 也行，方便在飞书里识别

注意：这些信息后续可以修改。创建后会自动进入应用配置主界面。

五、为应用添加「机器人」能力

进入应用配置页，在左侧菜单栏找到“添加应用能力”并点击。在能力列表中选择“机器人”，点击右侧的“添加”按钮。添加完成后，左侧菜单栏会出现“机器人”相关配置项，说明能力已经加上了。

六、批量导入机器人核心权限（关键步骤）

OpenClaw 需要调用飞书的消息、文档、表格等接口，所以得提前开通对应权限。批量导入可以一次性搞定，避免手动一个个添加漏掉。具体操作：左侧菜单栏进入“权限管理”，找到“批量导入/导出权限”按钮并点击。选择“应用身份权限”，把下方 JSON 代码完整粘贴到输入框，点击“格式化 JSON”（防止格式错误）。然后点击“下一步”，确认新增权限，再点击“申请开通”，等待开通成功（个人账号免审核立即生效，企业账号需要管理员审核）。

{
  "scopes": {
    "tenant": [
      "aily:message:read",
      "aily:message:write",
      "base:app:copy",
      "base:app:create",
      "base:app:read",
      "base:app:update",
      "base:collaborator:create",
      "base:collaborator:delete",
      "base:collaborator:read",
      "base:dashboard:copy",
      "base:dashboard:read",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:form:read",
      "base:form:update",
      "base:record:create",
      "base:record:delete",
      "base:record:read",
      "base:record:retrieve",
      "base:record:update",
      "base:role:create",
      "base:role:delete",
      "base:role:read",
      "base:role:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "bitable:app",
      "bitable:app:readonly",
      "board:whiteboard:node:create",
      "board:whiteboard:node:delete",
      "board:whiteboard:node:read",
      "board:whiteboard:node:update",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly",
      "contact:user.employee_number:read",
      "contact:user.id:readonly",
      "docs:doc",
      "docs:doc:readonly",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.comment:write_only",
      "docs:document.content:read",
      "docs:document.media:download",
      "docs:document.media:upload",
      "docs:document.subscription",
      "docs:document.subscription:read",
      "docs:document:copy",
      "docs:document:export",
      "docs:document:import",
      "docs:event.document_deleted:read",
      "docs:event.document_edited:read",
      "docs:event.document_opened:read",
      "docs:event:subscribe",
      "docs:permission.member",
      "docs:permission.member:auth",
      "docs:permission.member:create",
      "docs:permission.member:delete",
      "docs:permission.member:readonly",
      "docs:permission.member:retrieve",
      "docs:permission.member:transfer",
      "docs:permission.member:update",
      "docs:permission.setting",
      "docs:permission.setting:read",
      "docs:permission.setting:readonly",
      "docs:permission.setting:write_only",
      "docx:document",
      "docx:document.block:convert",
      "docx:document:create",
      "docx:document:readonly",
      "drive:drive",
      "drive:drive.metadata:readonly",
      "drive:drive.search:readonly",
      "drive:drive:readonly",
      "drive:drive:version",
      "drive:drive:version:readonly",
      "drive:export:readonly",
      "drive:file",
      "drive:file.like:readonly",
      "drive:file.meta.sec_label.read_only",
      "drive:file:download",
      "drive:file:readonly",
      "drive:file:upload",
      "drive:file:view_record:readonly",
      "event:ip_list",
      "im:app_feed_card:write",
      "im:chat",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.group_msg",
      "im:message:send_as_bot",
      "im:message:readonly",
      "im:message:update",
      "sheets:spreadsheet",
      "sheets:spreadsheet:create",
      "sheets:spreadsheet:read",
      "space:folder:create",
      "wiki:node:create",
      "wiki:node:read",
      "wiki:node:update",
      "wiki:space:read"
    ],
    "user": []
  }
}

七、配置事件订阅，实现飞书消息接收

左侧菜单栏进入“事件与回调”，选择“事件配置”。将订阅方式修改为“使用长连接接收事件”（推荐，无需配置公网域名，个人账号首选），点击保存。然后点击“添加事件”，在搜索框输入“接收消息”，选择“接收消息 v2.0（im.message.receive_v1）”。勾选后点击“添加”，完成消息订阅配置——这样飞书发送的消息会通过长连接推送给 OpenClaw。

八、发布应用，使所有配置生效

左侧菜单栏进入“版本管理与发布”，点击“创建版本”。填写版本信息：应用版本号自定义（如 1.0.0），更新说明简要填写（如“OpenClaw 飞书机器人初始配置”）。移动端/桌面端默认能力都选择“机器人”。滑动到底部，点击“保存”，再点击“确认发布”。注意：个人未认证账号发布后免审核立即生效；企业认证账号需要进入飞书管理后台完成应用审核后才生效。

九、获取应用凭证，配置至 OpenClaw

左侧菜单栏进入“凭证与基础信息”，找到“应用凭证”板块。复制 App ID 和 App Secret（必须完整复制，不含空格，建议手动复制避免粘贴错误）。然后打开已运行的 OpenClaw 主界面，点击右上角“设置”，选择左侧“聊天渠道”。在渠道列表中找到“Feishu（飞书）”，点击进入配置页。将复制的 App ID 和 App Secret 分别粘贴到对应输入框，点击页面底部“保存渠道配置”。OpenClaw 将自动重启，等待 Gateway 重新在线即配置完成。

十、飞书端使用 OpenClaw 机器人（最终步骤）

打开飞书 PC 或手机端，在顶部搜索栏输入你创建的应用名称（如“OpenClaw 机器人”）。点击进入机器人聊天窗口，发送任意测试指令（比如“你好”、“帮我整理桌面文件”）。如果机器人正常回复或执行指令，说明配置成功。如果没反应，往下看问题排查。

十一、常见问题排查（机器人无响应 / 指令执行失败）

• 飞书应用未发布：返回飞书开放平台，确认版本已发布且审核通过（个人账号检查是否点击了“确认发布”）
• 权限未开通：进入权限管理，检查所有权限是否都显示“已开通”，没开通就重新批量导入并申请
• App ID/Secret 复制错误：检查 OpenClaw 飞书配置页的凭证是否与飞书开放平台一致，有没有多字、少字或空格
• OpenClaw 未重启：配置完成后需确保 OpenClaw 自动重启，如果没有重启，手动点击右上角重启 Gateway
• 长连接未生效：返回飞书事件与回调，确认订阅方式为“长连接”，重新保存后再测试
• OpenClaw 未正常部署：检查 Gateway 是否显示“在线”，如果离线，重新运行 OpenClaw 一键启动程序

十二、OpenClaw 飞书机器人常用指令示例

配置成功后，在飞书聊天窗口直接发送以下指令，AI 会自动操控电脑完成：

• 办公类：「帮我打开 Excel，制作一份本周工作汇报表格，保存到 D 盘」
• 文件类：「整理 D 盘下载文件夹，按文件类型分类创建文件夹」
• 浏览器类：「打开浏览器，搜索 2026 年 AI 智能体发展趋势，整理成文档」
• 消息类：「帮我给飞书备注“同事 A”发送消息，内容是“工作汇报已发至你邮箱”」

未部署的用户先下载安装，部署完成后按本教程配置，全程 10 分钟即可实现飞书对接 OpenClaw！