agent-team

// 管理和调用具有不同"灵魂"的子 Agent 团队，每个 Agent 拥有独特的身份定义和专用模型。

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

agent-team - 多 Agent 团队管理系统

管理和调用具有不同"灵魂"的子 Agent 团队，每个 Agent 拥有独特的身份定义和专用模型。

使用方法

基础命令

agent-team list                      # 列出所有 Agent
agent-team show <name>              # 查看 Agent 详情
agent-team spawn <name> [task]      # 启动 Agent 执行任务
agent-team chat <name>              # 与 Agent 交互对话

示例

# 查看团队所有成员
agent-team list

# 查看 Coder 的详细信息
agent-team show coder

# 让 Coder 帮你写代码
agent-team spawn coder "写一个快速排序算法"

# 与 Writer 对话讨论写作
agent-team chat writer

内置 Agent 团队

Agent	角色	主模型	专长
🧑‍💻 coder	代码专家	qwen3-coder-next	编程、重构、测试
✍️ writer	写作专家	qwen3.5-plus	文档、博客、创意写作
📊 analyst	数据专家	qwen3.5-plus	数据分析、可视化
🔍 researcher	调研专家	gemini-3.1-pro	文献调研、竞品分析
👀 reviewer	审查专家	qwen3-max	代码审查、质量把关

创建新 Agent

1. 创建目录

mkdir -p ~/.openclaw/workspace/agents/<agent-name>

2. 定义 SOUL.md

# SOUL.md - <Agent Name>

## 身份
你是...

## 性格特质
- ...

## 专业领域
- ...

## 沟通风格
- ...

3. 创建 config.json

{
  "name": "AgentName",
  "role": "角色描述",
  "emoji": "🤖",
  "model": {
    "primary": "dashscope/qwen3.5-plus",
    "fallback": "google/gemini-3-flash-preview"
  },
  "capabilities": ["能力 1", "能力 2"]
}

模型配置说明

每个 Agent 可以配置不同的模型：

dashscope/qwen3-coder-next: 编码专用
dashscope/qwen3.5-plus: 通用中文优化
dashscope/qwen3-max: 最强推理
google/gemini-3.1-pro: 深度研究
google/gemini-3-flash-preview: 快速响应

工作模式

1. 任务模式 (spawn)

agent-team spawn coder "优化这个函数"

创建独立子代理会话
执行指定任务
完成后返回结果

2. 对话模式 (chat)

agent-team chat analyst

进入交互式对话
保持角色一致性
适合复杂协作

高级用法

并行多 Agent

# 同时启动多个 Agent
agent-team spawn coder "写代码" &
agent-team spawn writer "写文档" &
agent-team spawn reviewer "审查代码" &
wait

链式调用

# Coder 写代码 → Reviewer 审查 → Writer 写文档
agent-team spawn coder "实现功能"
agent-team spawn reviewer "审查代码"
agent-team spawn writer "编写文档"

文件结构

~/.openclaw/workspace/
├── agents/
│   ├── coder/
│   │   ├── SOUL.md       # 身份定义
│   │   └── config.json   # 模型配置
│   ├── writer/
│   └── ...
└── skills/
    └── agent-team/
        ├── agent-team.py  # 管理脚本
        └── SKILL.md       # 本文档

故障排除

Agent 未找到: 检查 ~/.openclaw/workspace/agents/ 目录
模型不可用: 确认模型配置正确且 API Key 有效
会话无法创建: 检查 OpenClaw 网关状态