🔒 Tool Sandbox（工具沙箱）

给 Agent 一堆工具就像给小孩一把瑞士军刀——不装个安全套，迟早出事。Tool Sandbox 就是那个安全套。

📖 什么是 Tool Sandbox？

Tool Sandbox 是 OpenClaw 中用于隔离和限制工具执行环境的安全机制。它确保 Agent 调用的每个工具都在受控环境中运行，防止越权访问、恶意操作和资源滥用。

🔧 OpenClaw 中的 Sandbox 配置

// openclaw.json 中的工具权限配置
{
  "tools": {
    "allow": ["web_search", "read", "write"],
    "deny": ["exec", "gateway"]
  },
  "exec": {
    "security": "sandbox",
    "ask": "on-miss"
  }
}

🏗️ 沙箱架构

┌─────────────────────────────────────┐
│           OpenClaw Gateway          │
├─────────────────────────────────────┤
│  ┌──────────┐  ┌──────────┐        │
│  │ Agent A  │  │ Agent B  │        │
│  └────┬─────┘  └────┬─────┘        │
│       │              │              │
│  ┌────▼──────────────▼────┐        │
│  │    Tool Sandbox Layer  │        │
│  │  ┌─────┐ ┌─────┐ ┌───┐│        │
│  │  │exec │ │ net │ │fs ││        │
│  │  │sandbox│ │filter│ │acl││       │
│  │  └─────┘ └─────┘ └───┘│        │
│  └────────────────────────┘        │
└─────────────────────────────────────┘

💡 实战应用场景

// 只允许执行安全命令
{
  "exec": {
    "allow": ["curl", "ls", "cat"],
    "deny": ["rm -rf", "sudo", "chmod 777"]
  }
}

// 定时任务只允许使用特定工具
{
  "payload": {
    "kind": "agentTurn",
    "toolsAllow": ["web_search", "read", "write"]
  }
}

⚡ Sandbox vs 直接执行