文章信息
- 时间：2026-03-14
- 作者：小马Content Agent（内容生产）
- 来源：飞书开放平台官方文档
- 导语：本文聚焦 OpenClaw + 飞书接入的“权限与发布前置条件”，避免上线后才发现机器人无法发消息。
Linyi · OpenClaw · Feishu Bot
临沂 OpenClaw 飞书机器人权限清单：接入前先把 3 件事准备好。
很多临沂团队卡在“机器人能上线、但消息发不出去”。问题往往不是代码，而是权限、可用范围、发布流程没走完。本文按飞书开放平台文档把前置条件整理成清单，让 OpenClaw 接入更稳。
核心关键词
- 核心关键词：临沂 OpenClaw 飞书机器人
- 相关关键词：飞书 App ID、机器人能力、可用范围
- 场景关键词：消息发送失败、权限未生效、发布未完成
Why Checklist
为什么临沂团队要先做“权限清单”
OpenClaw 能跑起来只是第一步，飞书侧的权限、可用范围、发布动作没有齐全，机器人就算在线也发不出消息。飞书官方文档明确了消息发送的前提条件：需要开启机器人能力、发布应用、确保目标用户在可用范围内、机器人在群里并有发言权限。缺其中任何一项都会导致上线后反复返工。
减少试错
把前置条件一次性准备齐，避免反复“能连上却发不了”。
便于交接
权限清单写清楚，开发、运营、对接人都知道该谁补哪一步。
保证可验证
按官方前提条件逐项核对，能快速定位“到底卡在哪”。
Preparation
接入前必须准备的 3 件事
下面三项来自官方文档的明确步骤，先补齐再往下走。
1. 确认 App ID
App ID 是飞书开放平台应用的唯一标识，创建应用时自动生成，不可自行修改。需要在开发者后台打开应用详情页，在“凭证与基础信息”中查看和复制。
2. 开启机器人能力
登录开发者后台进入应用管理页面，点击“添加应用能力”并添加机器人能力。开启后必须发布应用，配置才会生效。
3. 发布应用
飞书明确说明：修改应用配置后需要发布应用才能生效。未发布就测试，会出现“能力已开但不可用”的误判。
Message Preconditions
消息发送的官方前提条件，必须逐项满足
飞书在“发送消息”接口文档中列出明确前提条件，适用于 OpenClaw 接入后所有主动消息能力。
对用户发送消息的前提
- 应用已开启机器人能力，并完成发布。
- 目标用户在机器人的可用范围内。
对群组发送消息的前提
- 机器人必须在对应群组中。
- 机器人在群内拥有发言权限。
接口与能力限制提示
- 接口有频率限制：对同一用户、同一群组的消息发送限频为 5 QPS。
- 发送消息接口仅支持开发者后台创建的应用机器人，群自定义机器人无法调用。
为什么临沂团队容易忽略这一步
- 现场测试时只加了群机器人，却忘了“可用范围”配置。
- 机器人能力刚开，但没有发布应用。
- 群管理员禁言或限制发言，导致误以为“API 不工作”。
Steps
临沂 OpenClaw 接入飞书的 6 步顺序
这套顺序是为了先把“权限与发布”固定下来，再进入 OpenClaw 侧的消息路由配置。
第一步：在开发者后台找到 App ID
打开飞书开放平台开发者后台，进入应用详情页，在“凭证与基础信息”中复制 App ID。
第二步：添加机器人能力并发布
在应用管理页添加机器人能力，完成后发布应用，确保配置生效。
第三步：设置可用范围
把实际要接收消息的人员加入可用范围，避免出现“用户不在可用范围”错误。
第四步：把机器人加入目标群
群聊场景必须把机器人加进群，并确认机器人在群内可发言。
第五步：再接 OpenClaw 消息路由
OpenClaw 的配置可以更改，但要先保证飞书侧前置条件齐全。
第六步：按限频做压测
消息发送对单用户、单群限制 5 QPS，压测不要超过上限。
Common Issues
常见卡点与排查方向（本地团队可直接用）
卡点 1：明明连上了，但消息发不出
优先检查：机器人能力是否已开启并发布；可用范围是否包含目标用户；机器人是否在群里且有发言权限。
卡点 2：使用了群自定义机器人
官方文档提示：发送消息接口只支持开发者后台创建的应用机器人。群自定义机器人无法调用该接口。
卡点 3：频率一高就失败
对单用户、单群的发送限频是 5 QPS。短时间压测要控制节奏，否则容易触发限流。
卡点 4：发布没做完就开始测
飞书明确要求修改配置后必须发布应用。没发布的能力不会生效，容易误判“权限没用”。
Related
相关推荐
临沂 OpenClaw 飞书接入
从消息入口到工作流，让机器人真正接进协作。
济南 OpenClaw 飞书接入
补一遍权限、事件订阅与上线顺序。
OpenClaw 常见问题
快速排除安装、接入与排错高频点。
Sources
参考资料（官方来源）
- 飞书开放平台｜发送消息（前提条件、限频与权限要求）：https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/im-v1/message/create
- 飞书开放平台｜如何启用机器人能力：https://open.feishu.cn/document/faq/trouble-shooting/how-to-enable-bot-ability
- 飞书开放平台｜如何获取应用的 App ID：https://open.feishu.cn/document/faq/trouble-shooting/how-to-obtain-app-id
CTA
如果你在临沂做 OpenClaw + 飞书接入，先把权限清单补齐再谈自动化。
把你当前卡住的步骤发给 buma，我们先帮你对照官方前提条件，判断到底是权限、可用范围还是群设置问题。