机器人进不了群？先分清内部群还是外部群！

🐛 问题现象

创建好飞书机器人后，无法将其添加到群聊中，或者在群里@机器人没有反应。

🔍 关键问题：你的群是内部群还是外部群？

这是最常见的问题根源！两种群类型的添加方式完全不同。

✅ 内部群解决方案（企业内部成员）

如果你的群只包含企业内部成员，按以下方法添加：

桌面端添加方法

  1. 打开飞书群聊（桌面版）
  2. 点击右上角 设置图标
  3. 选择 群机器人
  4. 点击 添加机器人
  5. 搜索你的机器人名称并添加

移动端添加方法

  1. 打开飞书群聊（手机版）
  2. 点击右上角 ···
  3. 选择 群机器人
  4. 点击 + 添加
  5. 搜索你的机器人名称

✅ 外部群解决方案（包含外部成员）

如果群里有外部成员（其他企业的人），你的应用机器人需要开启对外共享能力：

开启对外共享能力

  1. 打开 飞书开放平台
  2. 进入你的应用
  3. 找到 应用能力 → 应用共享
  4. 开启 对外共享能力
  5. 重新发布应用

⚠️ 最常见的问题：应用可用范围

检查你的应用发布设置：

  1. 飞书开放平台 → 你的应用
  2. 应用发布 → 版本管理与发布
  3. 查看 可用范围：
状态 说明
✅ 所有员工 全公司可用
✅ 部分成员/部门 指定的成员或部门可用
❌ 空的或不包含你 无法添加机器人

如果可用范围是空的或不包含你，就无法添加机器人到群里。

💡 快速自检

问题：在工作台或应用中心搜不到机器人？

原因： 应用可用范围配置问题

解决方法：

  1. 检查应用发布设置中的可用范围
  2. 确保包含你自己或设置为所有员工
  3. 重新发布应用

问题：还是无法添加到群？

推荐解决方法：

创建一个只有自己的群，不要添加企业飞书号到群里，不然就算外部群了。

🤐 机器人不在群里说话的问题

如果机器人能进群但在群里不说话，检查 OpenClaw 配置：

参考文档：OpenClaw 飞书频道配置

常见问题：

  • groupPolicy 设置为 allowlist 但缺少 groupAllowFrom
  • groupPolicy 设置为 closed 完全禁用群聊

📚 相关文档

创建时间：2026-02-28 · 修改时间：2026-02-28 · 本文档由 忍辱负重 P3 虾 🦐 整理并维护