【智能体配置指南】飞书接入 OpenClaw 2.7.8 智能体配置指南（含安装包）
OpenClaw 绑定飞书教程
本文基于 OpenClaw 2.7.8 版本，讲解在飞书开放平台创建企业自建应用，并完成 OpenClaw 与飞书对接的完整流程。全程采用长连接接收事件，无需配置公网回调地址，仅需填写 App ID 与 App Secret 即可完成接入。
下载 OpenClaw Windows 一键部署包，文件大小约 45.8MB下载地址：https://xiake.yun/api/download/package/17?promoCode=IV4E9B04A80C
前置准备
- 已完成 OpenClaw 2.7.8 安装并可正常启动
- 已登录飞书开放平台并进入开发者后台
- 准备可用的飞书组织 / 企业空间
- 企业账号发布应用需管理员审核
一、飞书开放平台创建应用
步骤 1：进入开发者后台创建应用
打开飞书开放平台：https://open.feishu.cn/app点击右上角开发者后台→ 选择创建企业自建应用。
步骤 2：填写应用基础信息
设置应用名称、描述、头像（2MB 以内，240×240px 以上），点击创建。
步骤 3：添加机器人能力
进入应用 → 左侧添加应用能力→ 找到机器人并添加。
二、事件与回调配置（核心）
步骤 4：进入事件与回调
左侧菜单点击事件与回调，在事件配置区域点击编辑。
步骤 5：选择长连接接收事件
选择使用长连接接收事件并保存，不要选择发送至开发者服务器。
步骤 6：添加接收消息事件
点击添加事件，搜索并勾选接收消息 v2.0（im.message.receive_v1），点击添加。
步骤 7：开通关联权限
弹出权限推荐时，点击确认开通权限，确保依赖权限全部为已开通状态。
三、批量导入完整权限
步骤 8：进入权限管理批量导入
左侧权限管理→ 点击批量导入 / 导出权限。
步骤 9：粘贴权限 JSON
清空默认内容，粘贴以下完整权限 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": [] } }步骤 10：确认新增权限
点击下一步，确认新增权限，数据范围保持与应用的可用范围一致并确认。
四、应用发布
步骤 11：创建并发布版本
点击顶部创建版本或进入版本管理与发布：
- 版本号：1.0.0
- 桌面端 / 移动端默认能力：机器人
- 更新说明：更新事件订阅与权限点击保存→确认发布。
- 个人账号：免审直接上线
- 企业账号：需管理员审核
步骤 12：复制 App ID 与 App Secret
左侧进入凭证与基础信息，复制App ID与App Secret。
五、OpenClaw 端配置
步骤 13：填写飞书配置
打开 OpenClaw 2.7.8 → 右上角设置→聊天配置→ 找到Feishu/Lark（飞书）。填入复制的App ID与App Secret，打开右侧开关，点击保存渠道配置。
接入自检清单
- 飞书应用已添加机器人能力
- 事件订阅为 im.message.receive_v1
- 订阅方式为长连接接收事件
- 所有权限已开通
- 应用已发布成功
- App ID 与 Secret 正确填写并保存
常见问题
1. 飞书机器人无响应
- 确认应用已发布
- 检查事件与订阅方式
- 重启 OpenClaw 的 Gateway
- 核对 App ID 与 Secret 无多余空格
2. 无需配置回调地址
本教程采用飞书长连接模式，OpenClaw 仅需两个参数，无需公网 IP 与 Webhook。
3. 权限说明
基础对话可只开通必要权限；需使用多维表格、云文档等能力，建议导入完整权限 JSON。
文章摘要
本文基于 OpenClaw 2.7.8 版本，提供 Windows 平台下 OpenClaw 与飞书机器人的完整对接流程，包含飞书开放平台应用创建、机器人能力添加、长连接事件配置、完整权限批量导入、应用发布，以及 OpenClaw 端参数填写与保存。无需公网回调地址，配置简单稳定，同时给出自检清单与常见问题解决方案，帮助用户快速完成智能体与飞书的集成。
下载 OpenClaw Windows 一键部署包，文件大小约 45.8MB下载地址：https://xiake.yun/api/download/package/17?promoCode=IV4E9B04A80C