文章标签:#OpenClaw #小龙虾 AI #本地 AI #飞书机器人 #AI 办公自动化 #Windows 一键部署
前言
本文基于飞书开放平台官方页面、配套截图素材,以及 OpenClaw Windows 现有飞书配置方式整理,适用于先在飞书开放平台创建企业自建应用,再将 App ID 和 App Secret 填入 OpenClaw的标准接入流程。小龙虾一键部署包下图:


核心结论:OpenClaw 当前飞书渠道仅需填写App ID、App Secret两个参数;飞书侧推荐使用长连接接收事件,并完成应用创建、机器人能力、事件订阅、权限开通、版本发布 5 个核心环节,即可实现稳定对接。
前置准备
已安装并可正常启动 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": []
    }
}


步骤 12:确认新增权限
粘贴完成后,点击下一步,确认新增权限。


步骤 13:配置数据范围(保持默认)
部分权限需确认可访问数据范围,保持默认与应用的可用范围一致,点击「确认」。


步骤 14:进入版本管理与发布
权限与事件配置完成后,需发布版本使配置生效;可点击顶部「创建版本」,或左侧进入「版本管理与发布」。


步骤 15:填写版本信息
设置版本号(如 1.0.0、1.0.1),移动端 / 桌面端默认能力保持机器人,填写更新说明(如:更新事件订阅、开通完整权限)。


步骤 16:保存版本信息
下拉页面至底部,点击「保存」。


步骤 17:完成应用发布
保存后点击确认发布;个人用户可直接发布,企业用户需等待管理员审核通过。


步骤 18:复制 App ID 与 App Secret
返回左侧「凭证与基础信息」,复制App ID、App Secret两个参数。


步骤 19:填入 OpenClaw 飞书配置
打开 OpenClaw,点击右上角「设置」→「聊天配置」,找到 Feishu/Lark(飞书)配置卡片,填入复制的 App ID、App Secret。


步骤 20:启用并保存渠道配置
打开飞书渠道开关,点击右上角保存渠道配置,完成接入。


接入完成自检清单
飞书应用已添加「机器人」能力
事件与回调使用「长连接接收事件」
已添加 im.message.receive_v1 接收消息事件
所有事件关联权限均为已开通状态
完整权限 JSON 已导入并生效
应用版本已保存并发布
App ID、App Secret 正确填入 OpenClaw
OpenClaw 已完成渠道配置保存
常见问题解答
1. OpenClaw 配置完成,飞书机器人无响应
检查飞书应用是否发布成功
确认事件订阅为 im.message.receive_v1
核对订阅方式为长连接接收事件
保存配置后重启 OpenClaw Gateway 服务
检查 App Secret 是否存在多余空格或参数错误
2. 为何无需配置公网回调地址
当前 OpenClaw 飞书接入采用飞书官方长连接模式,仅需 App ID 与 App Secret,无需手动配置 Webhook URL。
3. 权限是否必须完整导入
仅实现消息收发可开通基础权限;如需使用文档、云空间、多维表格、知识库等扩展能力,建议导入完整权限 JSON。
参考链接
飞书开放平台开发者后台:https://open.feishu.cn/app

小龙虾一键部署包下图:

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐