之前写了 OpenClaw 怎么接企业微信，后台有不少同学问：我们公司不用企微，用飞书，能接吗？能，而且流程和企微高度类似。飞书在国内企业的渗透率越来越高，让 OpenClaw 走进飞书，等于给整个团队的日常办公配了一个随叫随到的 AI 帮手。
这篇把 OpenClaw 接飞书的完整流程讲一遍：创建企业自建应用、配置机器人权限、安装渠道插件、消息收发到群聊通知，以及高频踩坑点。
先搞明白：OpenClaw 接飞书，接的是什么
OpenClaw 通过「渠道（Channel）」接入即时通讯工具，飞书是官方支持的渠道之一。接好之后的效果：你可以在飞书里直接跟 Agent 对话，让它查资料、写周报、跑任务，也可以把结果主动推到群里。
原理不复杂：飞书开放平台提供机器人能力（应用），OpenClaw 负责处理消息逻辑，中间通过「事件订阅」通道互通——飞书把用户发的消息推给 OpenClaw，OpenClaw 处理后把回复发回去。理解了这个模型，后面的配置步骤就都顺了。
第一步：在飞书开放平台创建企业自建应用
登录飞书开放平台，进入开发者后台，选择「企业自建应用」创建。填好应用名称、描述、图标，提交后进入应用详情页。
这里有两样东西是核心凭证：App ID 和 App Secret。App ID 是应用的唯一标识，App Secret 是调用 API 的密钥——务必妥善保管，别写进代码仓库。这个账号密码的管理思路，和 AI Agent 权限管理 里讲的最小权限原则一致：只给应用必要的权限，不给多余的。
注意一个前置条件：创建企业自建应用需要管理员权限或开发者权限，纯个人账号建不了。团队里找管理员开个权限就行。
第二步：配置机器人能力与权限
应用建好后，在「功能」模块启用机器人能力，然后去「权限管理」添加消息相关的权限范围。常用的权限集：
"scopes": {
"tenant": [
"im:message", // 读取与发送消息
"im:message:send_as_bot", // 以机器人身份发消息
"im:chat", // 读取群信息
"im:chat:read",
"im:message.p2p_msg:readonly", // 读取单聊消息
"im:message.group_at_msg:readonly" // 读取群里 @机器人的消息
]
}权限加完之后，记得「创建版本并发布」，权限才会真正生效——这是新手最容易漏的一步，后面收不到消息往往就卡在这。权限遵循够用就行的原则，先给消息相关的最小集，后面需要再加。
第三步：安装并配置 OpenClaw 飞书渠道
回到 OpenClaw 这边，安装飞书渠道插件并写入凭证：
openclaw plugins install @m1heng-clawd/feishu
openclaw config set channels.feishu.appId "你的AppId" && openclaw config set channels.feishu.appSecret "你的AppSecret" && openclaw config set channels.feishu.enabled true或者用交互式命令更省事：openclaw channels add，按提示选择飞书渠道，粘贴 App ID / App Secret 即可。配置完成后重启网关（openclaw gateway --port 18789），确认渠道状态正常。
第四步：配置事件订阅，打通消息通道
这一步是能不能收到消息的关键。回到飞书开放平台，在应用里配置「事件订阅」的回调地址，指向你的 OpenClaw 服务：
https://你的公网地址/feishu/events本地开发阶段没有公网地址，可以用 ngrok、frp 之类的内网穿透工具把本地端口暴露出去；正式使用建议部署到服务器上，部署方案参考 OpenClaw 怎么部署到服务器。订阅事件时，勾选接收消息相关的事件（如 im.message.receive_v1），并配置好 Encrypt Key 和 Verification Token 用于验签。
配置完，在飞书里给机器人发条消息测试。通了，就是真的通了——Agent 已经在你的办公 IM 里上线了。
常见坑：收不到消息，九成是这三件事
一是回调地址没通：事件订阅 URL 必须是公网可达的，本地 localhost 地址飞书推不进来；二是权限没生效：加完权限忘了「发布版本」，或者没勾选对应的事件订阅；三是凭证配错：App Secret 抄错、大小写不对，都会 401。
排查时记得看日志：OpenClaw 会记录渠道事件和工具调用，结合 审计查询字段 的思路，把失败的那次事件还原出来，问题基本就定位了。
进阶：飞书 + 知识库 + 定时任务的组合拳
飞书渠道通了之后，能玩的花样很多：让 Agent 在飞书里回答业务问题，接上知识库做 RAG 校准，检索侧优化见 知识库检索怎么做才准确；让 Agent 每天早上把日报、周报自动推到飞书群里，定时配置参考 OpenClaw 怎么定时发日报周报；再配合 MCP 工具调用能力，OpenClaw 怎么接 MCP 工具 里的场景全部能在飞书里唤起。
优缺点与适合人群
优点：飞书国内企业渗透率高、机器人交互体验好、消息即入口，Agent 融进日常协作几乎没有学习成本。缺点：需要企业管理员配合建应用、事件回调要求公网可达、权限配置步骤比企微略多。
它最适合「用飞书办公的团队」：运营要数据播报、管理者要日报汇总、客服要自动应答、HR 要制度问答。流程和企微版本基本平行，OpenClaw 接企业微信 那篇的很多经验可以直接平移。
总结
OpenClaw 接飞书，核心五步：创建企业自建应用、配置机器人权限并发布、安装飞书渠道插件、配置事件订阅回调、测试消息收发。记住一句话——飞书是 OpenClaw 办公场景最顺手的入口之一，权限给最小集、回调打通、凭证管好，Agent 就能从「单机版」变成「团队版」。
