从零搭建 AI Agent 团队：OpenClaw 多 Agent 配置完整教程 2026年 3月 5日
前程往事
0 条评论

## 什么是多 Agent 系统

OpenClaw 支持在同一系统中运行多个 Agent，每个 Agent 拥有独立的配置和资源：
- 独立的名字、角色、workspace
- 不同的模型配置
- 绑定不同的飞书/Discord Bot 账号
- 由主 Agent 统筹协调

这种架构让你可以组建一支 AI 团队，每个成员专注特定领域，通过协作完成复杂任务。

## 核心配置步骤

### 1. 配置 agents.list

在配置文件中定义所有 Agent：

```json
{
"agents": {
"defaults": {
"model": {"primary": "bailian/qwen3.5-plus"}
},
"list": [
{
"id": "main",
"default": true,
"name": "总指挥",
"workspace": "/Users/mac/.openclaw/workspace",
"subagents": {"allowAgents": ["copywriter", "designer"]}
},
{
"id": "copywriter",
"name": "文案专家",
"workspace": "/Users/mac/.openclaw/workspace-copywriter"
}
]
}
}
```

**关键点**：
- `default: true` 标识主 Agent
- `subagents.allowAgents` 定义可派发的子 Agent
- 每个 Agent 有独立 workspace

### 2. 配置 bindings

绑定 Agent 到飞书账号：

```json
{
"bindings": [
{"agentId": "main", "match": {"channel": "feishu", "accountId": "default"}},
{"agentId": "copywriter", "match": {"channel": "feishu", "accountId": "copywriter"}}
]
}
```

**关键点**：
- 每个 Agent 绑定独立的飞书 Bot
- accountId 对应 channels.feishu.accounts 中的配置

### 3. 配置 channels.feishu.accounts

配置飞书多 Bot 认证信息：

```json
{
"channels": {
"feishu": {
"accounts": {
"default": {"appId": "cli_xxx", "appSecret": "xxx"},
"copywriter": {"appId": "cli_yyy", "appSecret": "yyy"}
}
}
}
}
```

**关键点**：
- 每个 Bot 需要在飞书开放平台创建
- appId 和 appSecret 妥善保管

### 4. 为每个 Agent 创建 SOUL.md

SOUL.md 是 Agent 的人设和职责定义，包含：
- **核心身份**：角色、模型、风格
- **职责范围**：做什么/不做什么
- **工作原则**：行为准则
- **会话重启流程**：新会话如何开始
- **质量标准**：验收标准

示例 SOUL.md 结构：
```markdown
# 文案专家 - SOUL.md

## 核心身份
- 角色：文案创作专家
- 模型：MiniMax-M2.5
- 风格：简洁有力

## 职责范围
### 做这些
- 创作文案内容
- 优化标题和结构

### 不做这些
- 不生成设计图
- 不发布内容
```

### 5. 创建 AGENTS.md

AGENTS.md 是 Agent 的工作手册，包含：
- 工作空间目录
- 技能工具
- 工作流程
- 常用模板

## 三种协作方式

### sessions_spawn（一次性任务）

```python
sessions_spawn(
task="写一篇关于 AI 的文章，800 字",
agentId="copywriter",
mode="run"
)
```

**特点**：创建新 session，任务完成后自动返回结果

### sessions_send（持续对话）

```python
sessions_send(
sessionKey="agent:copywriter:main",
message="标题改为 AI 未来趋势"
)
```

**特点**：向已有 session 发送消息，保持上下文

### 共享文件（异步协作）

```python
write("/workspace/TASK_BOARD.md", "今日待办：...")
```

**特点**：通过文件传递信息，松耦合协作

## 最佳实践

1. **渐进式扩展**：先跑通 2 个 Agent 再加更多
2. **职责边界清晰**：每个 Agent 的 SOUL.md 写清楚职责边界
3. **派发规则明确**：主 Agent 的 AGENTS.md 写清楚派发规则
4. **上下文完整**：子 Agent spawn 时给完整上下文
5. **定期巡检**：建立 Heartbeat 机制，定期巡检子 Agent

## 自我进化引擎

实现持续改进的四个关键文件：
- **errors.md**：记录错误和解决方案
- **corrections.md**：记录用户纠正
- **best-practices.md**：记录最佳实践
- **knowledge-updates.md**：记录知识更新

## 常见问题

**Q: 子 Agent 不读取 SOUL.md 怎么办？**
A: 在任务描述中明确要求"请先读取 SOUL.md"

**Q: 如何检查子 Agent 是否偷懒？**
A: 通过 Heartbeat 定期巡检任务板

**Q: 多个 Agent 如何共享信息？**
A: 使用共享文件目录（如 TASK_BOARD.md）

---

**总结**：多 Agent 系统的核心在于清晰的职责划分和高效的协作机制。从简单配置开始，逐步完善 SOUL.md 和 AGENTS.md，建立适合你团队的协作流程。