飞书是目前和OpenClaw配合最丝滑的IM平台。

但很多人卡在这一步——飞书开发者后台又多又复杂，配置哪些权限、订阅哪些事件、回调地址怎么填……一不小心就错了，然后发消息没反应，不知道问题出在哪。

这篇是飞书机器人配置的完整图解版教程。每一步都有截图说明，常见报错全部给出解法。跟着做，30分钟之内飞书机器人必定跑通。

---

核心概要

这篇解决什么问题？

从零创建飞书自建应用，完成所有配置，打通与OpenClaw的连接，让你的AI助手在飞书里真正活起来。

主线逻辑：

飞书开发者后台 → 创建自建应用
        ↓
开通机器人能力 + 配置权限
        ↓
事件订阅（接收用户消息）
        ↓
将App ID / Secret填入OpenClaw
        ↓
发布应用版本
        ↓
飞书搜索机器人 → 发消息 → 验证成功

---

前置条件确认

开始之前，确认以下内容已就绪：

• ✅ OpenClaw已部署并运行（本地或云端，参见第06-10篇）

• ✅ 飞书账号（个人版或企业版均可）

• ✅ 如果是企业飞书，需要有管理员权限或能联系管理员审批

---

第一步：进入飞书开发者后台

访问：https://open.feishu.cn/app

• 个人飞书账号：登录后可直接创建个人应用

• 企业飞书账号：需在对应企业的开发者后台创建

点击右上角**"创建企业自建应用"**（如果是个人账号会显示"创建应用"）。

---

第二步：创建应用

填写应用信息：

字段	填写建议
应用名称	随意，如"AI助手"、"智能管家"
应用描述	随意，如"OpenClaw AI助手"
应用图标	可跳过，后续再设置

点击"创建"，进入应用详情页。

---

第三步：获取App ID 和 App Secret

进入应用详情页后，左侧菜单选**"凭证与基础信息"**。

找到并复制以下两个值，妥善保存（后面配置OpenClaw要用）：

• App ID：格式类似 cli_xxxxxxxxxx

• App Secret：点击"查看"后显示，格式类似 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

安全提示： App Secret相当于密码，不要分享给他人，不要提交到Git仓库。

---

第四步：开通机器人能力

左侧菜单 → "添加应用能力"

在能力列表里找到**"机器人"**，点击开通。

开通后，你的应用就具备了在飞书里发送和接收消息的基础能力。

---

第五步：配置权限（重要，容易漏）

左侧菜单 → "权限管理"

搜索并开通以下权限（企业应用需要管理员审批，个人应用直接开通）：

必须开通的权限：

权限名称	权限标识	用途
获取与发送单聊、群组消息	im:message	接收和发送消息
以应用的身份发消息	im:message:send_as_bot	机器人主动发消息
读取用户发给机器人的消息	im:message.p2p_msg:readonly	读取私聊消息

建议额外开通（用于后续高级功能）：

权限名称	权限标识	用途
访问群组信息	im:chat	在群里使用机器人
获取用户基本信息	contact:user.base:readonly	识别是谁在说话
读写云文档	docs:doc	AI直接操作飞书文档
读写多维表格	bitable:app	AI操作多维表格

提示： 权限开通后需要发布新版本才生效（第七步操作）。

---

第六步：配置事件订阅（接收用户消息的关键）

左侧菜单 → "事件与回调" → "事件订阅"

选择订阅方式：

方式	说明	推荐
长连接（WebSocket）	无需公网IP，飞书主动推送	✅ 推荐
HTTP回调	需要配置公网可访问的回调地址	不推荐新手使用

选"长连接" → 点击"添加事件" → 搜索"接收消息" → 勾选 im.message.receive_v1。

保存。

---

第七步：将凭证填入OpenClaw

回到服务器（或本地终端），执行：

openclaw channels add feishu

按提示依次输入：

App ID：cli_xxxxxxxxxx（第三步复制的）
App Secret：xxxxxxxxxxxxxxxx（第三步复制的）

看到"飞书渠道配置成功"提示后，执行：

openclaw status

确认飞书渠道状态显示为 connected。

---

第八步：发布应用版本

这步容易被忽略，不发布版本机器人不会出现在飞书里。

回到飞书开发者后台 → 左侧菜单 → "版本管理与发布"

点击"创建版本" → 填写版本号（如1.0.0）和发布说明 → "申请发布"

• 企业自建应用：需要企业管理员在飞书管理后台审批

• 个人应用：通常直接审批通过

审批通过后，应用正式上线。

---

第九步：验证全流程

1. 打开飞书

2. 顶部搜索框搜索你的机器人名称（应用名称）

3. 点开与机器人的对话

4. 发送"你好"

成功标志： 收到AI回复，内容合理有意义。

---

常见问题排查

问题	排查步骤
发消息完全没反应	1. 检查openclaw status，确认飞书渠道状态是connected 2. 检查事件订阅是否保存 3. 检查应用版本是否已发布
报错"access not configured"	权限未开通或未生效，重新检查第五步权限列表，发布新版本
搜不到机器人	应用未发布，回到版本管理完成发布流程
能收到消息但AI不回复	模型配置问题，执行openclaw health检查模型连接状态
企业飞书申请发布卡住	联系企业管理员在"飞书管理后台→应用审核"里审批

---

进阶配置：让机器人在群里也能用

默认配置只支持和机器人私聊。要让机器人加入群聊并响应消息：

1. 权限管理里开通 im:chat

2. 事件订阅里额外添加 im.message.receive_v1（群消息事件，同一个事件，已订阅则跳过）

3. 在飞书群里 → 群设置 → 群机器人 → 添加机器人 → 找到你的机器人

4. 在群里发消息时，**@机器人名字**触发回复

---

个人体感

飞书机器人的配置步骤多，但每一步都有明确目的。

最容易卡住的地方是两个：权限没开够和版本没发布。这两个问题加起来占了90%的"为什么机器人没反应"。

配置好之后的体验非常流畅——私聊、群聊都能用，飞书的消息格式支持也比微信好得多（可以发代码块、表格、链接），OpenClaw和飞书真的是天生一对。

---

下一篇：OpenClaw实操指南13｜用AI接管飞书多维表格：自动建表、写数据、做分析，一条指令搞定

---

获取更多 AI 咨询、一人公司、创业读书笔记、Openclaw、Claude Code 实战干货，欢迎关注我的公众号 「Rubin 智造社」

关键词：飞书机器人配置、飞书自建应用、OpenClaw飞书集成、飞书开发者后台、飞书事件订阅、AI机器人教程

相关阅读：OpenClaw实操指南11｜OpenClaw模型配置全攻略：智谱/通义/硅基/Claude，哪个最值？

OpenClaw实操指南10｜海外节点部署：接入Claude / Gemini，解锁顶级大模型能力

OpenClaw实操指南09｜云端部署实战：腾讯云+OpenClaw，打造7×24小时不断线AI助手

OpenClaw 实操指南 08：飞书 CLI 命令速查表，办公效率直接拉满