飞书是目前和OpenClaw配合最丝滑的IM平台。
但很多人卡在这一步——飞书开发者后台又多又复杂,配置哪些权限、订阅哪些事件、回调地址怎么填……一不小心就错了,然后发消息没反应,不知道问题出在哪。
这篇是飞书机器人配置的完整图解版教程。每一步都有截图说明,常见报错全部给出解法。跟着做,30分钟之内飞书机器人必定跑通。
这篇解决什么问题?
从零创建飞书自建应用,完成所有配置,打通与OpenClaw的连接,让你的AI助手在飞书里真正活起来。
主线逻辑:
飞书开发者后台 → 创建自建应用 ↓ 开通机器人能力 + 配置权限 ↓ 事件订阅(接收用户消息) ↓ 将App ID / Secret填入OpenClaw ↓ 发布应用版本 ↓ 飞书搜索机器人 → 发消息 → 验证成功
开始之前,确认以下内容已就绪:
- ✅ OpenClaw已部署并运行(本地或云端,参见第06-10篇)
- ✅ 飞书账号(个人版或企业版均可)
- ✅ 如果是企业飞书,需要有管理员权限或能联系管理员审批
访问:https://open.feishu.cn/app
- 个人飞书账号:登录后可直接创建个人应用
- 企业飞书账号:需在对应企业的开发者后台创建
点击右上角“创建企业自建应用”(如果是个人账号会显示“创建应用”)。
填写应用信息:
点击“创建”,进入应用详情页。
进入应用详情页后,左侧菜单选“凭证与基础信息”。
找到并复制以下两个值,妥善保存(后面配置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操作多维表格
提示: 权限开通后需要发布新版本才生效(第七步操作)。
左侧菜单 → “事件与回调” → “事件订阅”
选择订阅方式:
选“长连接” → 点击“添加事件” → 搜索“接收消息” → 勾选 im.message.receive_v1。
保存。
回到服务器(或本地终端),执行:
openclaw channels add feishu
按提示依次输入:
App ID:cli_xxxxxxxxxx(第三步复制的) App Secret:xxxxxxxxxxxxxxxx(第三步复制的)
看到“飞书渠道配置成功”提示后,执行:
openclaw status
确认飞书渠道状态显示为 connected。
这步容易被忽略,不发布版本机器人不会出现在飞书里。
回到飞书开发者后台 → 左侧菜单 → “版本管理与发布”
点击“创建版本” → 填写版本号(如1.0.0)和发布说明 → “申请发布”
- 企业自建应用:需要企业管理员在飞书管理后台审批
- 个人应用:通常直接审批通过
审批通过后,应用正式上线。
- 打开飞书
- 顶部搜索框搜索你的机器人名称(应用名称)
- 点开与机器人的对话
- 发送“你好”
成功标志: 收到AI回复,内容合理有意义。
openclaw status,确认飞书渠道状态是connected
2. 检查事件订阅是否保存
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,解锁顶级大模型能力
OpenClaw实操指南09|云端部署实战:腾讯云+OpenClaw,打造7×24小时不断线AI助手
OpenClaw 实操指南 08:飞书 CLI 命令速查表,办公效率直接拉满
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/254816.html