Cấu hình Sandbox & Công cụ đa tác tử

Tổng quan

Mỗi tác tử trong một thiết lập đa tác tử giờ đây có thể có riêng:

Cấu hình sandbox (agents.list[].sandbox ghi đè agents.defaults.sandbox)
Hạn chế công cụ (tools.allow / tools.deny, cùng với agents.list[].tools)

Điều này cho phép bạn chạy nhiều tác tử với các hồ sơ bảo mật khác nhau:

Trợ lý cá nhân với quyền truy cập đầy đủ
Tác tử gia đình/công việc với công cụ bị hạn chế
Tác tử hướng ra công chúng trong sandbox

setupCommand thuộc về sandbox.docker (toàn cục hoặc theo tác tử) và chỉ chạy một lần khi container được tạo. Xác thực là theo từng tác tử: mỗi tác tử đọc từ kho xác thực agentDir riêng của nó tại:

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

Credentials are not shared between agents. Never reuse agentDir across agents. If you want to share creds, copy auth-profiles.json into the other agent’s agentDir.

Để biết hành vi sandbox khi chạy, xem Sandboxing.
Để gỡ lỗi “vì sao bị chặn?”, xem Sandbox vs Tool Policy vs Elevated và openclaw sandbox explain.

Ví dụ cấu hình

Ví dụ 1: Tác tử cá nhân + tác tử gia đình bị hạn chế

{
  "agents": {
    "list": [
      {
        "id": "main",
        "default": true,
        "name": "Personal Assistant",
        "workspace": "~/.openclaw/workspace",
        "sandbox": { "mode": "off" }
      },
      {
        "id": "family",
        "name": "Family Bot",
        "workspace": "~/.openclaw/workspace-family",
        "sandbox": {
          "mode": "all",
          "scope": "agent"
        },
        "tools": {
          "allow": ["read"],
          "deny": ["exec", "write", "edit", "apply_patch", "process", "browser"]
        }
      }
    ]
  },
  "bindings": [
    {
      "agentId": "family",
      "match": {
        "provider": "whatsapp",
        "accountId": "*",
        "peer": {
          "kind": "group",
          "id": "[email protected]"
        }
      }
    }
  ]
}

Kết quả:

Tác tử main: Chạy trên host, truy cập đầy đủ công cụ
Tác tử family: Chạy trong Docker (mỗi tác tử một container), chỉ có công cụ read

Ví dụ 2: Tác tử công việc với sandbox dùng chung

{
  "agents": {
    "list": [
      {
        "id": "personal",
        "workspace": "~/.openclaw/workspace-personal",
        "sandbox": { "mode": "off" }
      },
      {
        "id": "work",
        "workspace": "~/.openclaw/workspace-work",
        "sandbox": {
          "mode": "all",
          "scope": "shared",
          "workspaceRoot": "/tmp/work-sandboxes"
        },
        "tools": {
          "allow": ["read", "write", "apply_patch", "exec"],
          "deny": ["browser", "gateway", "discord"]
        }
      }
    ]
  }
}

Ví dụ 2b: Hồ sơ coding toàn cục + tác tử chỉ nhắn tin

{
  "tools": { "profile": "coding" },
  "agents": {
    "list": [
      {
        "id": "support",
        "tools": { "profile": "messaging", "allow": ["slack"] }
      }
    ]
  }
}

Kết quả:

Các tác tử mặc định có công cụ coding
Tác tử support chỉ dành cho nhắn tin (+ công cụ Slack)

Ví dụ 3: Các chế độ sandbox khác nhau theo từng tác tử

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main", // Global default
        "scope": "session"
      }
    },
    "list": [
      {
        "id": "main",
        "workspace": "~/.openclaw/workspace",
        "sandbox": {
          "mode": "off" // Override: main never sandboxed
        }
      },
      {
        "id": "public",
        "workspace": "~/.openclaw/workspace-public",
        "sandbox": {
          "mode": "all", // Override: public always sandboxed
          "scope": "agent"
        },
        "tools": {
          "allow": ["read"],
          "deny": ["exec", "write", "edit", "apply_patch"]
        }
      }
    ]
  }
}

Thứ tự ưu tiên cấu hình

Khi tồn tại cả cấu hình toàn cục (agents.defaults.*) và cấu hình theo tác tử (agents.list[].*):