OpenClaw给每个Agent单独指定workspace

OpenClaw中为每个Agent配置独立工作区的最佳实践

在大模型智能体协作平台上，实现多个Agent之间的文件隔离是确保项目管理井然有序的关键需求。如果您正在使用OpenClaw平台，为不同角色的智能体分配专属工作空间可以有效避免文件冲突、权限混乱等问题。本指南将详细介绍在OpenClaw中为每个Agent独立配置Workspace的完整方案，涵盖从基础配置到高级隔离策略的各个环节。

一、配置文件核心配置方法（openclaw.json）

实现Agent工作区隔离的核心操作位于OpenClaw的配置文件~/.openclaw/openclaw.json中。通过合理的JSON结构设计，您可以轻松定义全局默认路径和每个智能体的独立工作目录。

{
  "agents": {
    // 全局默认设置（可选配置项）
    "defaults": {
      "workspace": "~/.openclaw/workspace-default"
    },
    // 每个 Agent 的个性化配置
    "list": [
      {
        "id": "main",
        "model": "gpt-4o",
        // 为主Agent指定专属工作区
        "workspace": "~/.openclaw/workspaces/main"
      },
      {
        "id": "write",
        "model": "claude-sonnet",
        // 为写作Agent配置独立目录
        "workspace": "~/.openclaw/workspaces/write"
      },
      {
        "id": "design",
        "model": "qwen-vl",
        // 为设计Agent设定工作空间
        "workspace": "~/.openclaw/workspaces/design"
      },
      {
        "id": "dev",
        "model": "deepseek-coder",
        // 开发者Agent独立工作区
        "workspace": "~/.openclaw/workspaces/dev"
      },
      {
        "id": "ops",
        "model": "gpt-4o-mini",
        // 运维Agent专用目录
        "workspace": "~/.openclaw/workspaces/ops"
      }
    ]
  }
}

配置规则详解

在配置过程中需要掌握以下几个关键原则：

• 优先级规则：Agent列表中的workspace配置项具有最高优先级，它将完全覆盖全局默认设置中的路径定义。
• 路径格式支持：您可以使用~符号表示用户主目录，也可以采用绝对路径或相对于~/.openclaw目录的相对路径进行配置。
• 自动目录创建：根据OpenClaw官方文档（docs.openclaw.ai）说明，当指定目录不存在时，系统通常会自动创建相应的工作目录，无需手动创建。

二、手动创建工作目录（推荐步骤）

虽然OpenClaw支持自动创建目录，但预先建立所有工作区目录是一种良好的运维习惯。这种方法可以有效避免潜在的权限问题，确保配置过程更加稳定可靠。

# 创建工作区父目录
mkdir -p ~/.openclaw/workspaces
# 为每个Agent创建独立的工作区目录
mkdir -p ~/.openclaw/workspaces/main
mkdir -p ~/.openclaw/workspaces/write
mkdir -p ~/.openclaw/workspaces/design
mkdir -p ~/.openclaw/workspaces/dev
mkdir -p ~/.openclaw/workspaces/ops

三、配置生效验证方法

完成配置后，您可以通过以下三个步骤验证独立工作区是否已成功生效，确保每个Agent的文件操作都限制在指定目录内。

1. 重启服务加载配置：首先重启OpenClaw服务以确保新的配置文件被正确加载。

   openclaw restart

2. 检查工作区路径：通过命令行工具验证每个Agent当前使用的工作目录路径。

   # 查看主Agent的工作区配置
   openclaw config get --agent main agents.list[0].workspace
   # 验证写作Agent的工作区路径
   openclaw config get --agent write agents.list[1].workspace

3. 测试目录隔离效果：进行实际的跨Agent文件操作测试，这能最直接地验证隔离机制是否正常工作。

   # 切换到写作Agent并创建测试文件
   openclaw use write
   session_send write "write test.txt 'hello write'"
   # 切换到开发Agent尝试读取文件（应该无法访问，证明隔离生效）
   openclaw use dev
   session_send dev "read test.txt"

四、命令行快速配置方法

对于偏好命令行操作的用户，OpenClaw提供了更为便捷的配置方式。您无需直接编辑JSON文件，通过以下命令即可快速创建已配置独立工作区的Agent。

openclaw agents add \
  --id write \
  --model claude-sonnet \
  --workspace ~/.openclaw/workspaces/write

五、结合沙箱实现完全隔离

在安全性要求较高的应用场景中，仅配置不同的工作目录可能无法满足隔离需求。此时您可以结合沙箱（sandbox）配置，为每个Agent创建彻底隔离的运行时环境，确保智能体无法越权访问主机文件系统。

{
  "id": "write",
  "model": "claude-sonnet",
  "workspace": "~/.openclaw/workspaces/write",
  "sandbox": {
    "mode": "all", // 启用完全沙箱模式
    "scope": "agent", // 每个Agent获得独立沙箱环境
    "workspaceAccess": "none" // 沙箱内无法访问主机其他目录
  }
}