Feishu Agent Team - 多 Agent 团队协作系统
概念
将多个 AI Agent 组织成"团队"：
- 1 个 Coordinator - 调度中心，接收所有消息并分发
- N 个 Specialist - 专家 Agent，各司其职
┌─→ Specialist-A (商分)
│
User @Coordinator ──┼─→ Specialist-B (市场)
│ │
│ └─→ Specialist-C (开发)
│
└──→ [State] ←──┘
核心功能
- 智能路由：关键词匹配 → 自动分发到对应专家
- Feishu 集成：群 @mention 触发调度，支持多群配置
- 跨 Agent 通信：MQ 消息队列异步协作
- 状态持久化：LangGraph Checkpoint 支持断点恢复
- 可扩展：添加任意数量的专家 Agent
安装
# 进入 OpenClaw workspace
cd ~/.openclaw/workspace
# 克隆项目
git clone <repo-url> feishu-agent-team
# 安装依赖
pip install langgraph langchain-openai feishu-oapi
# 初始化
python team.py init
快速配置
1. 定义团队角色
编辑 config/team.yaml:
coordinator:
name: "Coordinator" # 调度中心名称
mention_name: "coordinator" # 群里的 @ 名称
specialists:
- name: "Analyst" # 专家1
specialty: "商业分析"
keywords: ["分析", "市场", "投资", "趋势", "商分"]
- name: "Developer" # 专家2
specialty: "技术开发"
keywords: ["代码", "开发", "bug", "技术", "架构"]
- name: "Marketer" # 专家3
specialty: "市场推广"
keywords: ["推广", "增长", "内容", "运营"]
2. 配置 OpenClaw 绑定
{
"bindings": [
{
"agentId": "coordinator",
"match": { "channel": "feishu", "accountId": "coordinator" }
},
{
"agentId": "analyst",
"match": { "channel": "feishu", "accountId": "analyst" }
},
{
"agentId": "developer",
"match": { "channel": "feishu", "accountId": "developer" }
},
{
"agentId": "marketer",
"match": { "channel": "feishu", "accountId": "marketer" }
}
]
}
3. 配置 Feishu App
{
"channels": {
"feishu": {
"accounts": {
"coordinator": {
"appId": "cli_xxx",
"appSecret": "xxx",
"groupPolicy": "open",
"groups": {
"YOUR_GROUP_ID": {
"enabled": true,
"requireMention": true,
"groupSessionScope": "group_sender"
}
}
},
"analyst": { "appId": "cli_yyy", "appSecret": "yyy" },
"developer": { "appId": "cli_zzz", "appSecret": "zzz" },
"marketer": { "appId": "cli_aaa", "appSecret": "aaa" }
}
}
}
}
4. 启动 Agent 监听
# 每个 Specialist Agent 运行一个监听进程
python listeners/specialist_listener.py --agent analyst &
python listeners/specialist_listener.py --agent developer &
python listeners/specialist_listener.py --agent marketer &
使用方式
群里 @ Coordinator 发任务
@Coordinator 分析一下当前AI市场的投资趋势
Coordinator 自动识别 → 分发给 Analyst → Analyst 在群里回复。
支持多类型任务
@Coordinator 开发一个用户登录模块
@Coordinator 推广我们的新产品
@Coordinator 分析竞品情况
CLI 方式
# 测试任务路由
python team.py route "我想推广新产品" # → Marketer
# 运行任务
python team.py run "分析竞争对手"
# 查看团队状态
python team.py info
Python API
from src.api import TeamGraphAPI
api = TeamGraphAPI()
# 执行任务
result = api.process("市场调研报告", team_config="config/team.yaml")
print(result["specialist"]) # 自动路由到对应专家
自定义指南
添加新的专家 Agent
- 在
config/team.yaml 添加:
specialists:
- name: "Designer"
specialty: "UI设计"
keywords: ["设计", "界面", "UI", "UX", "图标", "海报"]
- 创建监听器:
# listeners/designer_listener.py
from src.listeners.base import SpecialistListener
class DesignerListener(SpecialistListener):
name = "designer"
specialty = "UI设计"
if __name__ == "__main__":
DesignerListener().start()
-
添加 OpenClaw 绑定和 Feishu 账号
-
启动监听: python listeners/designer_listener.py &
修改路由逻辑
编辑 src/graph.py 中的路由函数:
def route_to_specialist(state: TeamState) -> str:
task = state["task"].lower()
# 自定义路由规则
if any(kw in task for kw in ["分析", "研究", "报告"]):
return "analyst"
elif any(kw in task for kw in ["开发", "代码", "bug"]):
return "developer"
# ... 更多规则
return "coordinator" # 默认保留给调度者处理
多群支持
配置多个群组 ID:
{
"channels": {
"feishu": {
"accounts": {
"coordinator": {
"groups": {
"GROUP_ID_1": { "enabled": true, "requireMention": true },
"GROUP_ID_2": { "enabled": true, "requireMention": true },
"GROUP_ID_3": { "enabled": true, "requireMention": true }
}
}
}
}
}
}
工作原理
1. 用户在 Feishu 群 @Coordinator 发送任务
↓
2. Coordinator 接收消息，提取任务内容
↓
3. 任务路由函数分析关键词，匹配专家
↓
4. 通过 MQ 消息队列分发任务给对应专家
↓
5. Specialist Agent 接收任务，在群里回复
技术栈
- 状态机: LangGraph
- 持久化: SQLite Checkpoint
- 消息队列: 轻量级 MQ 实现
- 飞书集成: feishu-oapi
项目结构
feishu-agent-team/
├── SKILL.md
├── README.md
├── config/
│ └── team.yaml # 团队配置（角色、关键词）
├── src/
│ ├── __init__.py
│ ├── api.py # Python API
│ ├── graph.py # LangGraph 图定义
│ ├── nodes.py # 节点逻辑
│ ├── state.py # 状态定义
│ ├── routing.py # 路由逻辑
│ ├── feishu_group.py # Feishu 群操作
│ └── persistence/ # Checkpoint 持久化
├── listeners/
│ ├── base.py # 监听器基类
│ ├── analyst_listener.py
│ ├── developer_listener.py
│ └── marketer_listener.py
├── team.py # CLI 入口
└── tests/
常见问题
Q: 需要多少个 Feishu App？
A: 最少 2 个（1 个 Coordinator + 1 个 Specialist），最多 N+1 个。
Q: 如何添加更多专家？
A: 见"自定义指南 - 添加新的专家 Agent"。
Q: 任务失败怎么办？
A: Coordinator 会保留任务状态，可通过 python team.py retry <task_id> 重试。
许可证
MIT License - 免费使用
支持
遇到问题提交 Issue
