本文介绍 OpenClaw 如何构建安全沙箱浏览器环境。在多 Agent 并发时让浏览器也支持并发。通过容器化 Sandbox,可以实现浏览器隔离、并发任务支持以及资源回收等能力。同时分析沙箱工具权限配置的关键细节,并介绍 OpenClaw 源码调试方法。
前言: OpenClaw 到底是真正有产能性价比的 AI 助手,还是只是个 皇帝的新衣 被一众相关利益者吹嘘炒作?虽然我已经研究了两个多月,还不知道答案。不过,作为一个失业码农,我只想研究一下相关的技术和应用。所以本文没有 “功能炸裂、不学就被淘汰、震惊、天花板、刷新了我xyz、省下多少 $$ ” 这类的故事。
引
以 OpenClaw 为代表的这类个人 AI Agent,如果要真实完成任务,就必须给予其一定的权限和工具。但由于 LLM 的不稳定性以及 Prompt 注入漏洞,这些能力又必须被严格约束。无论是 Guardrail 还是其它防御手段,都无法保证绝对安全。
在这种情况下,容器化 Sandbox 就成为最后一道入侵防线和风险防火墙。
OpenClaw 提供两类 tools 的 sandbox:
- 运行时 sandbox container
- 浏览器 sandbox container
使用容器化 Sandbox,除了作为 入侵防线和风险防火墙 外,还能带来一些额外好处:
- 支持浏览器并发操作
每个 Session 使用独立容器,资源完全隔离。例如,每个 session 使用自己的 browser sandbox 实例,从而避免并发任务之间的浏览器操作互相干扰。
- Session 资源使用限制
- Session 资源统一回收
沙箱浏览器的部署
1. 创建 Agent
openclaw agents add worker --workspace ~/.openclaw/workspace/workeropenclaw agents set-identity --agent worker --name "worker"
2. 配置沙箱
每个 Agent 都可以拥有独立的沙箱配置,其配置位于 ~/.openclaw/openclaw.json 中的 agents.list[].sandbox。
agents:list:{"id":"worker","name":"worker","workspace":"~/.openclaw/workspace/worker","agentDir":"~/.openclaw/agents/worker/agent","identity":{"name":"worker"},"subagents":{"allowAgents":["main","worker"]},"sandbox":{"mode":"all","workspaceAccess":"rw","scope":"session","docker":{"image":"openclaw-sandbox-common:bookworm-slim","containerPrefix":"oc-sbx-worker","workdir":"/workspace","readOnlyRoot":true,"tmpfs":["/tmp","/var/tmp","/run"],"network":"bridge","user":"1000:1000","capDrop":["ALL"],"env":{"LANG":"C.UTF-8"},"memory":"8g","cpus":2},"browser":{"enabled":true,"image":"openclaw-sandbox-browser:bookworm-slim","containerPrefix":"oc-sbx-browser-worker","network":"openclaw-sandbox-browser","headless":false,"enableNoVnc":true,"allowHostControl":false,"autoStart":true,"autoStartTimeoutMs":12000},"prune":{"idleHours":1,"maxAgeDays":1}},"tools":{"profile":"full","allow":["group:messaging","group:runtime","group:fs","group:sessions","group:web","group:ui","group:automation","group:…