OpenClaw 多 Agent 协作研发：5 个 AI 员工，从需求到代码自动流转

{
  agents: {
    list: [
      { id: "home", workspace: "~/.openclaw/workspace-home" },
      { id: "work", workspace: "~/.openclaw/workspace-work" }
    ]
  },
  bindings: [
    { agentId: "home", match: { channel: "feishu", accountId: "personal" } },
    { agentId: "work", match: { channel: "feishu", accountId: "company" } }
  ]
}

{
  "task": "分析这个需求并生成技术方案",
  "agentId": "analyst",
  "mode": "run",
  "runTimeoutSeconds": 600
}

用户提出需求
  ↓
Director 接收并分析
  ↓
调用 Requirement Analyst → 生成需求文档
  ↓
调用 Developer → 生成代码
  ↓
调用 Code Reviewer → 审查代码
  ↓
调用 Tester → 执行测试
  ↓
Director 汇总结果 → 返回给用户

~/.openclaw/
├── openclaw.json              # 主配置文件
├── skills/                    # 共享 Skills
│   ├── code-analyzer/
│   │   ├── SKILL.md
│   │   └── scripts/
│   └── test-runner/
│       ├── SKILL.md
│       └── scripts/
└── agents/                    # 各 Agent 的状态目录
    ├── director/
    │   └── agent/
    │       └── auth-profiles.json
    ├── analyst/
    │   └── agent/
    ├── developer/
    │   └── agent/
    ├── reviewer/
    │   └── agent/
    └── tester/
        └── agent/

~/.openclaw/workspace-director/  # Director 的工作空间
├── SOUL.md
├── AGENTS.md
├── memory/
└── skills/

~/.openclaw/workspace-analyst/   # Analyst 的工作空间
├── SOUL.md
└── memory/

...（其他 Agent 类似）

# 使用 OpenClaw 命令创建 5 个 Agent
openclaw agents add director
openclaw agents add analyst
openclaw agents add developer
openclaw agents add reviewer
openclaw agents add tester

// ~/.openclaw/openclaw.json
{
  agents: {
    list: [
      {
        id: "director",
        name: "项目调度",
        default: true,
        workspace: "~/.openclaw/workspace-director",
        agentDir: "~/.openclaw/agents/director/agent"
      },
      {
        id: "analyst",
        name: "需求分析师",
        workspace: "~/.openclaw/workspace-analyst",
        agentDir: "~/.openclaw/agents/analyst/agent"
      },
      {
        id: "developer",
        name: "开发者",
        workspace: "~/.openclaw/workspace-developer",
        agentDir: "~/.openclaw/agents/developer/agent"
      },
      {
        id: "reviewer",
        name: "代码审查员",
        workspace: "~/.openclaw/workspace-reviewer",
        agentDir: "~/.openclaw/agents/reviewer/agent"
      },
      {
        id: "tester",
        name: "测试工程师",
        workspace: "~/.openclaw/workspace-tester",
        agentDir: "~/.openclaw/agents/tester/agent"
      }
    ],
    defaults: {
      subagents: {
        maxSpawnDepth: 2,              // 允许嵌套调用（编排器模式）
        maxChildrenPerAgent: 5,        // 每个 Agent 最多 5 个子任务
        maxConcurrent: 8,              // 全局并发上限
        model: "anthropic/claude-sonnet-4-5",  // sub-agents 使用更便宜的模型
        runTimeoutSeconds: 900         // 单个任务最多 15 分钟
      }
    }
  },

  bindings: [
    {
      agentId: "director",
      match: { channel: "feishu", accountId: "dev-team" }
    }
  ],

  channels: {
    feishu: {
      enabled: true,
      dmPolicy: "pairing",  // 私聊需要配对
      accounts: {
        dev-team: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "AI 研发助手"
        }
      }
    }
  }
}

openclaw plugins install @openclaw/feishu

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot"
    ]
  }
}

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

openclaw logs --follow

# Director - 项目调度

你是项目调度专家，负责协调 Analyst、Developer、Reviewer、Tester 完成研发任务。

## 核心职责

1. **接收需求**：理解用户的自然语言需求
2. **任务拆解**：将需求分解为可执行的子任务
3. **资源调度**：调用合适的 Agent 完成子任务
4. **进度追踪**：监控任务执行状态
5. **结果汇总**：整合所有子任务结果，向用户汇报

## 可调用的 Agent

### Analyst（需求分析师）
- **ID**: `analyst`
- **能力**: 分析需求、生成 PRD、设计 API 接口
- **输出**: Markdown 格式的需求文档

### Developer（开发者）
- **ID**: `developer`
- **能力**: 根据需求文档编写代码
- **输出**: 完整的代码文件

### Reviewer（代码审查员）
- **ID**: `reviewer`
- **能力**: 审查代码质量、发现潜在问题
- **输出**: 审查报告和改进建议

### Tester（测试工程师）
- **ID**: `tester`
- **能力**: 编写测试用例、执行测试
- **输出**: 测试报告

## 标准工作流程

### 流程 1：新功能开发
用户："开发一个用户登录功能"

1. 调用 Analyst：
   {
     "task": "分析用户登录功能的需求，生成 PRD 和 API 设计",
     "agentId": "analyst",
     "mode": "run"
   }

2. 调用 Developer：
   {
     "task": "根据 Analyst 的输出，实现用户登录功能代码",
     "agentId": "developer",
     "mode": "run"
   }

3. 调用 Reviewer：
   {
     "task": "审查 Developer 的代码，检查安全性和代码质量",
     "agentId": "reviewer",
     "mode": "run"
   }

4. 调用 Tester：
   {
     "task": "为登录功能编写测试用例并执行测试",
     "agentId": "tester",
     "mode": "run"
   }

5. 汇总结果并汇报


### 流程 2：Bug 修复
用户："修复登录页面的报错"

1. 调用 Analyst：
   {
     "task": "分析登录页面报错的原因，定位问题",
     "agentId": "analyst",
     "mode": "run"
   }

2. 调用 Developer：
   {
     "task": "根据 Analyst 的问题定位，修复代码",
     "agentId": "developer",
     "mode": "run"
   }

3. 调用 Tester：
   {
     "task": "验证修复是否有效，执行回归测试",
     "agentId": "tester",
     "mode": "run"
   }

4. 汇总结果并汇报

## 调用方式

使用 `sessions_spawn` 工具调用子 Agent：

```json
{
  "task": "任务描述",
  "agentId": "analyst",
  "mode": "run",
  "runTimeoutSeconds": 600
}

## 汇报格式
✅ 任务完成

📋 需求分析：
- PRD 文档：已生成
- API 设计：已完成

💻 代码开发：
- 文件数：3 个
- 代码行数：150 行

🔍 代码审查：
- 审查结果：通过
- 改进建议：2 条

✅ 测试验证：
- 测试用例：10 个
- 通过率：100%

⏱️ 总耗时：8 分钟
💰 成本：$0.15

## 注意事项

1. **并发控制**：最多同时运行 5 个子任务
2. **超时管理**：单个任务最多 15 分钟
3. **错误处理**：如果某个子任务失败，继续执行其他任务，最后汇总错误信息
4. **结果验证**：检查子任务的输出是否完整，必要时重新执行

~/.openclaw/skills/code-analyzer/
├── SKILL.md
└── scripts/
    └── analyze.py

---
name: code-analyzer
description: Analyze code quality and complexity
metadata:
  {
    "openclaw":
      {
        "requires": { "bins": ["python3"], "env": [] }
      }
  }
---

# 代码分析工具

## 功能
- 分析代码复杂度
- 检查代码规范
- 生成质量报告

## 使用方法

```bash
python3 scripts/analyze.py <file_path>
```

## 输出示例
代码复杂度：中等
- 圈复杂度：8（建议 < 10）
- 代码行数：150
- 函数数量：5

代码规范：
- ✅ 命名规范符合 PEP 8
- ✅ 注释覆盖率 60%
- ⚠️ 存在过长函数（>50 行）

建议：
1. 拆分 process_user_data 函数
2. 增加单元测试

// ~/.openclaw/workspace-reviewer/.openclaw/skills.json
{
  "skills": [
    {
      "path": "~/.openclaw/skills/code-analyzer",
      "enabled": true
    }
  ]
}

# 启动 OpenClaw Gateway
openclaw start

# 查看日志
openclaw logs --follow

# 检查状态
openclaw status

用户 @AI 研发助手：
开发一个用户登录功能，支持邮箱密码登录和 GitHub OAuth

{
  "task": "分析用户登录功能需求（邮箱密码 + GitHub OAuth），生成 PRD 和 API 设计",
  "agentId": "analyst",
  "mode": "run",
  "runTimeoutSeconds": 600
}

{
  "task": "根据 PRD 实现用户登录功能（邮箱密码 + GitHub OAuth）",
  "agentId": "developer",
  "mode": "run",
  "runTimeoutSeconds": 900
}

{
  "task": "审查登录功能的代码质量和安全性",
  "agentId": "reviewer",
  "mode": "run",
  "runTimeoutSeconds": 600
}

{
  "task": "为登录功能编写测试用例并执行测试",
  "agentId": "tester",
  "mode": "run",
  "runTimeoutSeconds": 600
}

✅ 任务完成

📋 需求分析：
- PRD 文档：已生成（3 个 API 接口）
- OAuth 流程：已设计

💻 代码开发：
- 文件数：5 个
  - src/api/auth.py（认证接口）
  - src/models/user.py（用户模型）
  - src/services/oauth.py（OAuth 服务）
  - src/utils/jwt.py（JWT 工具）
  - src/config.py（配置文件）

🔍 代码审查：
- 审查结果：需要修改
- 🔴 严重问题：2 个
  1. SQL 注入风险（auth.py:25）
  2. 密码明文存储（user.py:30）
- 改进建议：3 条

✅ 测试验证：
- 测试用例：12 个
- 通过：11 个
- 失败：1 个
- 通过率：92%

⚠️ 需要修复的问题：
1. 修复 SQL 注入风险（使用参数化查询）
2. 密码加密存储（使用 bcrypt）
3. 修复失败的测试用例

⏱️ 总耗时：12 分钟
💰 成本：$0.22

{
  tools: {
    subagents: {
      tools: {
        deny: ["gateway", "cron", "write"]
      }
    }
  }
}

{
  agents: {
    defaults: {
      subagents: {
        model: "anthropic/claude-sonnet-4-5"  // 比 Opus 便宜 5 倍
      }
    }
  }
}

# 列出当前会话的 sub-agent 运行
openclaw subagents list

# 查看日志
openclaw subagents log <id>

# 停止 sub-agent
openclaw subagents kill <id>

{
  tools: {
    subagents: {
      tools: {
        deny: ["write", "exec", "gateway"]
      }
    }
  }
}