OpenClaw实操指南12|飞书机器人从0到1:创建、配置、打通OpenClaw完整流程

张开发
2026/4/16 20:53:06 15 分钟阅读

分享文章

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_xxxxxxxxxxApp Secret点击查看后显示格式类似xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx安全提示App Secret相当于密码不要分享给他人不要提交到Git仓库。第四步开通机器人能力左侧菜单 →添加应用能力在能力列表里找到**机器人**点击开通。开通后你的应用就具备了在飞书里发送和接收消息的基础能力。第五步配置权限重要容易漏左侧菜单 →权限管理搜索并开通以下权限企业应用需要管理员审批个人应用直接开通必须开通的权限权限名称权限标识用途获取与发送单聊、群组消息im:message接收和发送消息以应用的身份发消息im:message:send_as_bot机器人主动发消息读取用户发给机器人的消息im:message.p2p_msg:readonly读取私聊消息建议额外开通用于后续高级功能权限名称权限标识用途访问群组信息im:chat在群里使用机器人获取用户基本信息contact:user.base:readonly识别是谁在说话读写云文档docs:docAI直接操作飞书文档读写多维表格bitable:appAI操作多维表格提示权限开通后需要发布新版本才生效第七步操作。第六步配置事件订阅接收用户消息的关键左侧菜单 →事件与回调→事件订阅选择订阅方式方式说明推荐长连接WebSocket无需公网IP飞书主动推送✅ 推荐HTTP回调需要配置公网可访问的回调地址不推荐新手使用选长连接→ 点击添加事件 → 搜索接收消息 → 勾选im.message.receive_v1。保存。第七步将凭证填入OpenClaw回到服务器或本地终端执行openclaw channels add feishu按提示依次输入App IDcli_xxxxxxxxxx第三步复制的 App Secretxxxxxxxxxxxxxxxx第三步复制的看到飞书渠道配置成功提示后执行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实操指南11OpenClaw模型配置全攻略智谱/通义/硅基/Claude哪个最值OpenClaw实操指南10海外节点部署接入Claude / Gemini解锁顶级大模型能力OpenClaw实操指南09云端部署实战腾讯云OpenClaw打造7×24小时不断线AI助手OpenClaw 实操指南 08飞书 CLI 命令速查表办公效率直接拉满

更多文章