引言

在AI助理的进化之路上，单一Agent已经无法满足复杂的工作需求。OpenClaw的多Agent架构让我们可以打造一个分工明确、协同工作的AI助理团队——每个Agent都有独立的人格、技能、记忆空间和工作目录，就像一个高效的研发团队一样各司其职。

本文将带你从零开始掌握OpenClaw的核心能力：创建子Agent和配置独立工作空间，并通过实战案例展示如何构建一个多Agent协作系统。

一、基础概念：持久Agent vs 子Agent

在开始之前，我们需要先理解OpenClaw中的两种核心Agent模式：

1. 持久Agent（Persistent Agent）

• 长期运行的独立Agent实例
• 有自己的完整配置、记忆和工作空间
• 适用于需要长期维护的角色（如代码开发助理、日常管家）
• 通过配置文件手动创建和管理

2. 子Agent（Subagent）

• 由主Agent动态创建的临时或任务型Agent
• 继承主Agent的部分配置，但可以独立配置
• 适用于一次性任务或需要专业技能的场景（如文档翻译、数据分析）
• 通过sessions_spawn工具动态创建

二、创建子Agent：从入门到精通

创建子Agent是OpenClaw多Agent协作的核心能力。我们主要使用sessions_spawn工具来实现。

openclaw agents add coding

三、工作空间管理：为Agent打造独立的工作环境

工作空间是Agent的"办公室"，每个Agent都应该有自己独立的工作目录，避免文件混乱和权限问题。

1. 工作空间的核心概念

• 继承模式：子Agent默认继承主Agent的工作目录
• 独立模式：通过cwd参数指定完全独立的工作目录
• 挂载模式：将特定目录挂载到子Agent的工作空间（适用于共享资源）

OpenClaw 支持为不同的 agents 创建独立的工作空间，这样每个 agent 可以有自己独立的文件、记忆和配置。以下是详细的步骤：

步骤 1：创建新的工作空间目录

首先，创建一个新的工作空间目录：

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

例如，为 coding agent 创建目录：

mkdir -p ~/.openclaw/workspace-coding

步骤 2：初始化工作空间

使用 openclaw setup 命令初始化新的工作空间：

openclaw setup --workspace ~/.openclaw/workspace-<agent-name>

例如：

openclaw setup --workspace ~/.openclaw/workspace-coding

这个命令会：

• 创建必要的配置文件
• 生成默认的工作空间文件（AGENTS.md, SOUL.md, USER.md 等）
• 设置默认的工作空间路径

步骤 3：添加使用新工作空间的 agent

使用 openclaw agents add 命令添加新的 agent，并指定工作空间：

openclaw agents add <agent-name> --workspace ~/.openclaw/workspace-<agent-name>

例如：

openclaw agents add coding --workspace ~/.openclaw/workspace-coding

步骤 4：验证 agents 配置

检查 agents 列表，确认每个 agent 都使用了正确的工作空间：

openclaw agents list

完整示例

以下是为 coding agent 创建独立工作空间的完整示例：

# 1. 创建工作空间目录
mkdir -p ~/.openclaw/workspace-coding

# 2. 初始化工作空间
openclaw setup --workspace ~/.openclaw/workspace-coding

# 3. 添加使用新工作空间的 agent
openclaw agents add coding --workspace ~/.openclaw/workspace-coding

# 4. 验证配置
openclaw agents list

工作空间文件结构

每个工作空间包含以下核心文件：

• AGENTS.md - agent 的操作指南
• SOUL.md - agent 的人格和语气
• USER.md - 用户信息
• IDENTITY.md - agent 的身份信息
• TOOLS.md - 本地工具笔记
• HEARTBEAT.md - 心跳检查清单
• memory/ - 记忆文件目录

注意事项

1. 主工作空间：默认的 main agent 使用 ~/.openclaw/workspace
2. 配置文件：全局配置在 ~/.openclaw/openclaw.json
3. 独立配置：每个 agent 可以在自己的工作空间中拥有不同的：

• • 身份（IDENTITY.md）
  • 记忆文件
  • 技能配置
  • 行为规则

实际演示结果

我已经成功创建了两个使用不同工作空间的 agents：

1. main agent - 使用 ~/.openclaw/workspace
2. coding agent - 使用 ~/.openclaw/workspace-coding

这样，coding agent 可以有完全独立的工作环境，适合处理专门的编程任务，而 main agent 继续处理通用任务。