飞书机器人+OpenClaw（小龙虾）本地AI：从创建应用到配置AppID/Secret全流程

本文提供OpenClaw连接飞书的完整图文教程，主要包含以下步骤：1.在飞书开放平台创建企业自建应用；2.添加机器人能力并配置"长连接接收事件"；3.订阅im.message.receive_v1消息接收事件；4.导入完整权限JSON；5.创建并发布应用版本；6.将获取的AppID和AppSecret填入OpenClaw配置页。教程强调必须完成应用创建、机器人能力、事件订阅、权

a75206628

150人浏览 · 2026-05-18 17:00:13

a75206628 · 2026-05-18 17:00:13 发布

OpenClaw 连接飞书完整图文教程

本文结合当前飞书开放平台页面、本目录里的截图素材，以及 OpenClaw Windows 现有飞书配置方式整理。适用于“先在飞书开放平台创建企业自建应用，再把 App ID 和 App Secret 填回 OpenClaw”的接入流程。

先说结论：OpenClaw 当前飞书渠道页只需要填写 App ID 和 App Secret 两个参数；飞书侧推荐按本文选择“长连接接收事件”，并至少完成应用创建、机器人能力、事件订阅、权限开通、版本发布这 5 个环节。

前置准备

下载OpenClaw（小龙虾）一键安装包（www.totom.top），并安装
已安装并能正常打开 OpenClaw Windows。
已登录飞书开放平台，并能进入开发者后台。
准备一个可用的飞书组织或企业空间。
如果你是企业账号，发布版本时可能需要企业管理员审核。

图文步骤

步骤 1：打开飞书开放平台并创建企业自建应用

先打开飞书开放平台：https://open.feishu.cn/app

进入页面后，点击右上角“开发者后台”，然后选择“创建企业自建应用”。

步骤 2：填写应用名称、描述和头像

给机器人起一个名字，补一段简短描述，并选择默认头像或上传自定义头像，然后点击“创建”。

步骤 3：给应用添加“机器人”能力

进入应用后，点击左侧“添加应用能力”，在能力列表里找到“机器人”，点击“添加”。

步骤 4：进入事件与回调

左侧进入“事件与回调”，在事件配置区域点击订阅方式右侧的编辑按钮。

步骤 5：选择“使用长连接接收事件”并保存

这里不要切到“将事件发送至开发者服务器”。 OpenClaw 当前这套飞书接入方式不需要你单独配置公网回调地址，按图中选择“使用长连接接收事件”，然后保存。

步骤 6：点击“添加事件”

保存订阅方式后，在“已添加事件”区域点击右侧“添加事件”。

步骤 7：添加接收消息事件

在弹窗里搜索“接收”，勾选 接收消息，事件名是 im.message.receive_v1，然后点击“添加”。

这个事件是飞书机器人收消息的关键事件，没有它，OpenClaw 就收不到飞书里发给机器人的消息。

步骤 8：按提示开通关联权限

如果飞书弹出“推荐开通以下权限”，直接点击“确认开通权限”。

步骤 9：检查事件依赖权限是否全部为已开通

回到事件列表后，展开事件下方的权限说明，确保每一项都是“已开通”状态。如果有未开通的权限，直接点击权限名称继续补开。

步骤 10：进入权限管理并准备批量导入

左侧打开“权限管理”，然后点击“批量导入/导出权限”。

步骤 11：粘贴完整权限 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": []
    }
}