OpenClaw实操指南12｜飞书机器人从0到1：创建、配置、打通OpenClaw完整流程
飞书是目前和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）和发布说明 → "申请发布"
- 企业自建应用：需要企业管理员在飞书管理后台审批
- 个人应用：通常直接审批通过
审批通过后，应用正式上线。
第九步：验证全流程
- 打开飞书
- 顶部搜索框搜索你的机器人名称（应用名称）
- 点开与机器人的对话
- 发送"你好"
成功标志： 收到AI回复，内容合理有意义。
常见问题排查
| 问题 | 排查步骤 |
|---|---|
| 发消息完全没反应 | 1. 检查openclaw status，确认飞书渠道状态是connected2. 检查事件订阅是否保存 3. 检查应用版本是否已发布 |
| 报错"access not configured" | 权限未开通或未生效，重新检查第五步权限列表，发布新版本 |
| 搜不到机器人 | 应用未发布，回到版本管理完成发布流程 |
| 能收到消息但AI不回复 | 模型配置问题，执行openclaw health检查模型连接状态 |
| 企业飞书申请发布卡住 | 联系企业管理员在"飞书管理后台→应用审核"里审批 |
进阶配置：让机器人在群里也能用
默认配置只支持和机器人私聊。要让机器人加入群聊并响应消息：
- 权限管理里开通
im:chat - 事件订阅里额外添加
im.message.receive_v1（群消息事件，同一个事件，已订阅则跳过） - 在飞书群里 → 群设置 → 群机器人 → 添加机器人 → 找到你的机器人
- 在群里发消息时，**@机器人名字**触发回复
个人体感
飞书机器人的配置步骤多，但每一步都有明确目的。
最容易卡住的地方是两个：权限没开够和版本没发布。这两个问题加起来占了90%的"为什么机器人没反应"。
配置好之后的体验非常流畅——私聊、群聊都能用，飞书的消息格式支持也比微信好得多（可以发代码块、表格、链接），OpenClaw和飞书真的是天生一对。
下一篇：OpenClaw实操指南13｜用AI接管飞书多维表格：自动建表、写数据、做分析，一条指令搞定
获取更多 AI 咨询、一人公司、创业读书笔记、Openclaw、Claude Code 实战干货，欢迎关注我的公众号 「Rubin 智造社」
关键词：飞书机器人配置、飞书自建应用、OpenClaw飞书集成、飞书开发者后台、飞书事件订阅、AI机器人教程
相关阅读：OpenClaw实操指南11｜OpenClaw模型配置全攻略：智谱/通义/硅基/Claude，哪个最值？
OpenClaw实操指南10｜海外节点部署：接入Claude / Gemini，解锁顶级大模型能力