前言
OpenClaw（小龙虾）v2.4.1 版本重磅支持飞书机器人渠道联动。配置完成后，用户可直接在飞书会话窗口向机器人发送自然语言指令，OpenClaw 会自动解析需求、拆解任务、操控本地电脑执行操作，真正实现通过飞书端远程下发 AI 自动化任务的高效协作模式。
本教程基于 OpenClaw Windows 客户端 开发，兼容 Windows 10 及 Windows 11 64 位系统。
在进行飞书配置前，请确保已完成 OpenClaw 的本地环境部署。官方提供的 Windows 整合部署包内置全套运行依赖，采用解压即用模式，无需命令行操作。部署就绪后，即可参照本文步骤，完成飞书机器人的全流程配置。
📌 OpenClaw Windows 一键部署包获取入口
🔗
OpenClaw Windows 一键部署包 v2.4.1（www.totom.top）
✨ 特点：内置完整运行组件、可视化操作、适配内网环境，建议优先使用本安装包。
配置前置准备
在正式操作之前，请确认以下预备事项已落实，可有效规避 90% 的配置报错：
账号资质：准备一个可用的飞书账号。个人开发者可直接操作；企业账号需确保账号拥有应用开发与管理的相关权限。
服务状态：配置过程中，请保持 OpenClaw 客户端正常运行，确保右上角的 Gateway 处于在线状态，不要中途关闭程序。
核心配置：飞书开放平台的操作中，权限导入与事件订阅是两个关键环节，必须严格按照步骤执行，两者缺一不可，否则机器人无法接收消息。
重启生效：所有后台配置修改完毕后，务必重启 OpenClaw 客户端，以确保凭证参数与渠道配置能正常加载生效。
第一步：登录飞书开放平台开发者后台
打开浏览器，访问飞书开放平台官方地址：
https://open.feishu.cn
使用你的飞书账号，通过扫码或密码登录进入开发者管理后台。个人账号登录无需额外资质认证，可直接进入应用创建流程。
第二步：创建企业自建应用
在开发者后台的首页，找到并点击「创建应用」按钮。
在弹出的应用类型选择中，勾选 「企业自建应用」。
该类型应用专为企业内部或个人开发者使用，无需上架应用商店审核，配置灵活且生效迅速。选择后进入应用基础信息的填写页面。
第三步：填写应用基础信息
按照页面指引，填写应用的基础资料，所有信息后续均支持修改：
应用名称：建议填写辨识度高的名称，例如：OpenClaw 智能助手、小龙虾 AI 助手等。
应用描述：简要说明应用功能，控制在 120 字内，示例：依托 OpenClaw 本地 AI 能力，在飞书内远程操控电脑完成自动化办公。
应用图标：上传正方形图片素材，支持 JPEG/PNG/SVG 等格式，文件大小不超过 2MB，分辨率建议 ≥240×240px，可使用品牌 LOGO 增强识别度。
信息填写完整后，点击「创建」，系统将自动进入该应用的专属配置控制台。
第四步：为应用添加机器人能力
在应用配置页面的左侧导航栏中，找到 「添加应用能力」 选项并点击。
在能力列表里，选中 「机器人」 模块，点击右侧的「添加」按钮。
添加成功后，左侧菜单栏会刷新并出现「机器人」相关的配置入口，代表能力开通成功。
第五步：批量导入核心权限（关键）
为了让 OpenClaw 具备完整的消息交互、文档读写、表格操作等能力，需要批量开通飞书租户权限。手动逐个添加不仅繁琐，还容易出现遗漏，因此推荐使用 批量导入 功能。
点击左侧的 「权限管理」，找到并点击 「批量导入 / 导出权限」。
选择「应用身份权限」分类，将下方完整的 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": []
}
}
第六步：配置事件订阅（内网核心）
事件订阅是连接飞书与 OpenClaw 的桥梁，负责将飞书聊天消息实时推送至本地服务。
在左侧菜单栏进入 「事件与回调」，选择事件配置页面。
关键设置：将「订阅方式」修改为 「使用长连接接收事件」，并点击保存。
💡 优势：此模式无需配置公网域名或公网 IP，非常适合内网部署的 OpenClaw 场景。
点击「添加事件」，在搜索框输入「接收消息」，找到并选择 im.message.receive_v1（接收消息 v2.0）事件。
勾选该事件，点击「添加」，完成消息订阅配置。
第七步：发布应用版本，使配置生效
飞书开放平台的所有后台配置，仅在 “版本管理与发布” 中点击发布后，才会真正在生产环境生效。
点击左侧的 「版本管理与发布」，然后点击「创建新版本」。
填写 版本号（如 1.0.0）和 版本描述（如 飞书机器人初始配置）。
在默认能力中，勾选「机器人」，并滑动到底部点击「保存」。
最后点击「确认发布」。个人账号发布后配置即时生效；企业账号需等待管理后台审核通过。
第八步：获取凭证并配置至 OpenClaw
最后一步是获取飞书应用的核心密钥，并填入 OpenClaw 中，实现两端互通。
进入左侧的 「凭证与基础信息」 页面，找到并完整复制 App ID 和 App Secret。
⚠️ 注意：复制时请务必仔细，确保没有多余的空格或字符缺失，否则会导致连接失败。
打开已运行的 OpenClaw 主界面，点击右上角的「设置」，选择左侧的「聊天渠道」。
在渠道列表中找到「Feishu（飞书）」，点击进入配置页。
将复制的 App ID 和 App Secret 分别粘贴到对应的输入框中，点击「保存渠道配置」。
配置保存后，OpenClaw 会自动重启 Gateway 服务。等待右上角重新显示 Gateway 在线，即代表飞书机器人配置完全成功。
第九步：飞书端实战测试
打开飞书客户端，在顶部搜索栏输入你创建的机器人名称。
进入与机器人的一对一聊天窗口。
发送任意指令测试（如 “打开浏览器”、“整理桌面文件”），机器人应能正常回复并执行操作。若执行成功，说明配置全部到位。
常见问题与排错指南
配置过程中若遇到机器人无响应或报错，请按以下顺序逐一排查：
检查应用发布：返回飞书开放平台，确认应用状态为「已发布」，个人账号务必点过「确认发布」。
校验权限状态：在权限管理页，检查所有租户权限是否均为「已开通」。
核对核心参数：重点检查 OpenClaw 配置页的 App ID 与 App Secret 是否与飞书后台完全一致。
确认服务重启：检查 OpenClaw 的 Gateway 是否在线。若离线，手动重启程序。
确认长连接：在事件订阅页，确认订阅方式为「长连接」，适配内网环境。
实用指令示例
配置完成后，可在飞书聊天窗口下发以下指令，体验 OpenClaw 的自动化能力：
文件管理：遍历 D 盘下载目录，将所有图片按日期归类，文档按格式归档。
办公制作：打开 Excel，制作一份 2026 年 Q1 工作汇总表并保存到桌面。
信息检索：打开浏览器，搜索 2026 年开源技术趋势，并整理成文档。
🔗 再次附上 OpenClaw 安装包下载入口
OpenClaw Windows 一键部署包 v2.4.1（www.totom.top）
感谢阅读！觉得本文对你有帮助，欢迎点赞收藏，持续关注更多 OpenClaw 进阶玩法！
