前言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 进阶玩法！