飞书对接(群互@) - GPT

#资料
	#官方
	https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh
	
	#对接skill
	https://scnaxdwsmxcy.feishu.cn/wiki/EVT7wUmGZiDfKzkRrdgcFW4DnlQ
	
---
##创建机器人
####首先需要使用这个链接创建一个openclaw专用的飞书机器人，这个机器人会把权限和回调自动配置好。你只需要输入名称和选个头像就行了 
	https://open.feishu.cn/page/openclaw?form=multiAgent
	
---
##安装skill
####直接跟openclaw说
	安装以下skill：https://leochens.feishu.cn/file/LQlMbuUonowakBxd7tpcRk8AnBf
	
---
##使用
####使用统一激活话术来激活
	你有一个feishu-bot-manager技能，使用这个技能添加机器人
####绑定已有的Agent到飞书机器人
	你有一个feishu-bot-manager技能，使用这个技能添加机器人，绑定到【运维专员】的Agent。
####新建一个Agent同时绑定到飞书机器人
	你有一个feishu-bot-manager技能，使用这个技能添加机器人，新建一个【日程小助手】的Agent，对他的要求如下：xxx
	
---
#群聊方式
#### 设置默认所有群都需要 @
	openclaw config set channels.feishu.requireMention true --json
---
#### 设置默认所有群都不需要 @
	openclaw config set channels.feishu.requireMention false --json
---
####⚠️ 注意：这个模式在大群里容易刷屏，谨慎使用！
####需要额外在开发者后台申请应用身份权限：获取群组中所有消息（敏感权限）im:message.group_msg

---

#### 然后给特定群设置需要 @（这里群ID只是示例，你要替换成真实的）
	openclaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true --json
---
#### 然后给特定群设置不需要 @（这里群ID只是示例，你要替换成真实的）
	openclaw config set channels.feishu.groups.oc_fd98f6b960d1c403e6ec2e7c2a4ab7d8.requireMention false --json
---
#### 重启生效
	openclaw gateway restart
	
---
# 飞书群内多 Agent 协作插件 - 安装使用指南

> 创建时间：2026-04-23
> 来源：罐头（guantou.site）+ B站视频 BV11QdmBEESq
> 项目：https://github.com/Leochens/feishu-bot-chat-plugin

## 效果预览

在飞书群里部署 **产品、前端、后端、测试** 四个 Agent，以"老板"身份发指令，它们自动协作完成产品交付：

- 产品 @ 其他人分配任务 → 前端/后端/测试 各出方案
- 产品汇总方案 + 出 MVP 清单
- 定时进度汇报
- 测试回归验证
- 最终输出使用手册

---

## 一、前置依赖

| 依赖 | 版本要求 | 安装命令 |
|------|---------|---------|
| **OpenClaw** | > 20260412 | - |
| **openclaw-lark** | 飞书官方插件 | `npx -y @larksuite/openclaw-lark` |
| **Node.js** | 最新稳定版 | - |

官方文档：https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh

---

## 二、插件安装

### 方式一：从 ClawHub 安装（推荐）

```bash
# 安装插件
openclaw plugins install clawhub:feishu-bot-chat

# 启用插件
openclaw plugins enable feishu-bot-chat
```

### 方式二：从网盘下载（需魔法）

1. 下载压缩包：https://pan.quark.cn/s/f5cb5a70e801
2. 把压缩包扔给 Agent，说：
   > "这是一个 openclaw 插件，你把它解压后安装到 extensions 目录下，注意同步在 openclaw.json 中打开这个插件并配置好目录"

### 方式三：从 GitHub 安装

```bash
# 克隆仓库
git clone https://github.com/Leochens/feishu-bot-chat-plugin.git

# 手动安装到 extensions 目录
```

---

## 三、飞书机器人权限配置

**关键权限**：每个参与协作的 Bot 必须开通 `im:message.group_at_msg.include_bot:readonly`

### 开通步骤

1. 进入 **飞书开发者后台** → 选择你的应用
2. → **权限管理** → 搜索 `im:message.group_at_msg.include_bot:readonly`
3. 勾选并申请权限（大部分是免审权限）

> ⚠️ **新创建的机器人**这个权限是默认配好的，**之前创建的机器人**需要手动开通。

### 关闭流式输出

由于流式输出会影响 @ 功能，需在 `openclaw.json` 中关闭：

```json
{
  "plugins": {
    "feishu-bot-chat": {
      "streamOutput": false
    }
  }
}
```

---

## 四、配置多个飞书机器人

如果还没配置过多机器人，需先阅读置顶文章《Openclaw 高级龙虾开课》了解如何绑定多个飞书机器人到不同 Agent。

核心要点：
- 每个 Agent 对应一个飞书机器人
- 在 openclaw.json 中为每个 Agent 配置不同的飞书机器人
- 把它们都拉进同一个群聊

---

## 五、6 大配套 Skill

插件内置了 6 个 Skill，Agent 协作时会自动调用：

| Skill | 用途 | 触发场景 |
|-------|------|---------|
| A2A 群内协作规则速查手册 | 协作规范 | 被 @ 时自动加载 |
| A2A 协作中断与取消处理指南 | 停止任务 | 用户说"停止"、"取消" |
| A2A 协作模式切换指南 | 切换策略 | 用户说"只跟你聊"等 |
| A2A 多 bot 协作结果汇总指南 | 整合结果 | 多个 Bot 完成后汇总 |
| A2A 协作状态查询与进度汇报指南 | 查看进度 | 用户问"进展如何" |
| A2A 任务分解与分配指南 | 拆解任务 | 复杂任务需要分工 |

---

## 六、使用示例

### 1. 基础协作（推荐）

在群里发消息，**带上"群内协作"等关键词**：

```
@产品经理 群内协作，做一个 GitHub 热榜分析的网页应用
```

Agent 会自动：
- 检测到群内其他 Agent（前端、后端、测试）
- @ 它们分配任务
- 收集方案 → 汇总 → 出报告

### 2. 监控进度

让产品 Agent 定时汇报进度：

```
@产品经理 每 5 分钟检查一下大家的开发进度
```

### 3. 中断协作

如果 Agent 跑偏了：

```
@产品经理 停止，前端方案有问题，重新评估
```

### 4. 切换独立模式

想单独和一个 Agent 聊：

```
@前端 切换独立模式，不要 @ 其他机器人
```

### 5. 查看进度

```
@产品经理 汇总一下目前的进展
```

---

## 七、进阶玩法

### 完全自主运行（无人值守）

让产品 Agent 充当监控角色：

```
@产品经理 你作为协调者，每 5 分钟检查其他 Agent 状态，如果某个超过 10 分钟没相应就中断它的任务重新分配。整个过程不需要找我确认。
```

### 多人多角色协作

在群里部署更多 Agent：

| 角色 | 职责 |
|------|------|
| 产品 | 需求分析、项目管理 |
| 前端 | UI 开发 |
| 后端 | API 开发 |
| 测试 | 测试策略、回归验证 |
| 运维（可选） | 部署、监控 |

---

## 八、故障排查

| 问题 | 解决方案 |
|------|---------|
| @ 其他 Bot 没反应 | 检查权限是否开通 `im:message.group_at_msg.include_bot:readonly` |
| 艾特失效/消息发不出 | 关闭流式输出 |
| 不知道群里有哪些 Agent | 说"群内协作"让它自动发现 |
| Agent 回复混乱 | 引用它的消息再 @，明确任务 |
| 安装失败 | 用网盘链接下载压缩包手动安装 |

---

## 九、资源链接

| 资源 | 链接 |
|------|------|
| GitHub | https://github.com/Leochens/feishu-bot-chat-plugin |
| 详细文档 | https://guantou.site/archives/quGqKN1G |
| B站视频 | https://www.bilibili.com/video/BV11QdmBEESq |
| 网盘下载 | https://pan.quark.cn/s/f5cb5a70e801 |
| ClawHub | `openclaw plugins install clawhub:feishu-bot-chat` |

---

## 十、相关项目

- [[OpenClaw Agent-to-Agent 配置实践指南]]
- [[OpenClaw飞书官方插件使用指南]]