多Agent配置实战：OpenClaw零基础搭建AI团队指南

在AI落地高阶场景时，单一全能型Bot往往难以应对复杂任务链——你不可能让一个角色同时承担项目经理、UI设计师和代码开发的工作。更高效的方案是借助OpenClaw配置多Agent架构，将“单人”拆解为一支分工清晰的AI团队。本文将从架构选型到实战配置，完整拆解多Agent部署的关键步骤。

架构选型：单网关与双网关

动手前先明确部署模式。OpenClaw提供两种主流方案，差异显著。

结论清晰：新手和多数协作场景，单Gateway模式已足够支撑。

核心配置流程

以下以单Gateway模式为例，搭建一个包含“博客写作”和“代码开发”的AI团队。按步骤操作即可。

1. 创建 Agent

通过命令行创建独立工作空间的Agent，注册信息会自动写入配置文件。

# 创建博客助手 Agent，指定独立的工作目录
openclaw agents add blog --workspace ~/.openclaw/workspace-blog
# 创建开发助手 Agent
openclaw agents add coding --workspace ~/.openclaw/workspace-coding
# 验证创建结果
openclaw agents list

2. 配置模型与角色

设置模型：不同Agent承担不同职责，需分配对应模型。务必使用模型别名而非含日期版本的完整ID——否则版本更新后需手动修改，效率低下。

# 为 blog Agent 配置高性能模型
openclaw config patch agents.list.1.model "anthropic/claude-sonnet-4-5"

定义角色（SOUL.md）：进入Agent工作空间，创建SOUL.md文件，明确其身份与边界。

~/.openclaw/workspace-blog/SOUL.md

# SOUL.md - 博客助手
## 角色定位
- 专注于技术博客写作，风格专业且通俗易懂。
- 熟悉 Markdown 格式与博客发布流程。
- 不得执行系统命令或访问非授权目录。

~/.openclaw/workspace-coding/SOUL.md

# SOUL.md - 开发助手
## 角色定位
- 专注于代码生成、调试与优化。
- 熟悉主流编程语言与 Git 工作流。
- 可以在指定项目目录下执行代码操作。

3. 踩坑避雷

禁止手动创建 BOOTSTRAP.md：该文件由系统自动生成并销毁，用于Agent初始化任务清单。若手动创建且内容不完整，Agent启动后将卡死在初始化阶段，无法进入工作状态。解决方式：找到该文件删除并重启网关即可。

务必开启会话可见性：此设置是Agent协同的基础。若不开启，各Agent间互不可见，协作失效。需在openclaw.json中配置：

{
  "tools": {
    "sessions": {
      "visibility": "all"
    }
  }
}

Agent 协同工作流

多Agent配置完成后，进入实战阶段。通常通过“主Agent”调度多个“子Agent”完成任务。

1. 配置通信白名单

先设置白名单，仅允许指定Agent间跨会话通信，保障安全。

{
  "tools": {
    "agentToAgent": {
      "enabled": true,
      "allow": ["main", "blog", "coding"], // 允许这些 Agent 相互通信
      "historyLimit": 50
    }
  }
}

2. 协同实战示例

用户指令：“写一篇关于 Kubernetes 的技术博客，并附带演示代码。” 流程如下：

1.主Agent（main） 解析指令，拆解为内容创作与代码生成两个子任务。

2.调度写作：主Agent调用 sessions_send 指令，将写作任务发送至 blog Agent。

指令：sessions_send --agent blog --message "撰写一篇关于 Kubernetes 核心概念的文章，要求通俗易懂..."

3.调度开发：主Agent同步将代码需求发送至 coding Agent。

指令：sessions_send --agent coding --message "生成一个简单的 Kubernetes Deployment YAML 示例..."

4.结果汇总：blog 与 coding 各自完成任务后，返回结果至主Agent，主Agent整合后回复用户。

核心逻辑：将复杂任务拆解为原子步骤，由专业Agent各司其职。相当于拥有一个7×24小时在线的AI团队，分工明确，效率自然提升。

配置完成后，如需一步到位，可编写自动化Shell脚本实现一键部署。

来源：互联网