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

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: [] } }步骤 12点击下一步确认新增权限确认 JSON 已经完整粘贴后点击“下一步确认新增权限”。步骤 13如出现数据范围配置保持默认并确认部分权限会要求确认“可访问的数据范围”。 按图示保持默认的“与应用的可用范围一致”然后点击“确认”即可。步骤 14创建版本或进入版本管理与发布权限和事件配置好以后需要创建并发布一个版本飞书侧的配置才会真正生效。 如果页面顶部直接有“创建版本”就点顶部按钮如果没有就从左侧“版本管理与发布”进入。步骤 15填写版本信息在版本详情页里把版本号改成一个新的值比如1.0.0、1.0.1。移动端默认能力和桌面端默认能力都保持“机器人”。更新说明可以简单写比如“更新事件订阅更新权限”。步骤 16保存版本下拉到页面底部点击“保存”。步骤 17确认发布保存完成后继续点击“确认发布”。 如果你是个人用户通常点击后可以直接免审发布如果你是企业账号往往需要企业管理员审核后才能发布成功。步骤 18复制 App ID 和 App Secret回到左侧“凭证与基础信息”复制这两个值App IDApp SecretOpenClaw 端只需要这两个参数。步骤 19打开 OpenClaw 的飞书渠道配置页回到 OpenClaw点击右上角“设置”进入“聊天配置”找到Feishu/Lark飞书这张卡片。 把刚才复制的 App ID 和 App Secret 分别填进去。步骤 20启用飞书渠道并保存确认右侧开关已经打开最后点击右上角“保存渠道配置”。 保存后飞书渠道就会在 OpenClaw 里处于已配置状态。接入完成后的自检清单飞书应用已经添加“机器人”能力。事件与回调里使用的是“长连接接收事件”。已添加im.message.receive_v1事件。事件关联权限都显示为“已开通”。权限管理里完整权限已经导入或逐项开通。版本已经保存并发布。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. 权限一定要全部导入吗如果你只想先跑通“飞书给机器人发消息OpenClaw 能收到并回复”的最小流程可以先按事件弹窗把必要权限开通。 但如果你希望后续配合 OpenClaw 使用文档、云空间、多维表格、知识库等能力建议直接导入步骤 11 里的完整权限 JSON。参考链接飞书开放平台开发者后台https://open.feishu.cn/app小龙虾open claw一键装机包www.totom.top最后提示完成配置后建议在飞书中向机器人发送一条测试消息如“你好”验证是否能正常回复。如果遇到问题可依次检查自检清单中的每一项或重启 OpenClaw Gateway 后重试。