OpenClaw 浏览器沙盒

可通过 Chrome DevTools Protocol (CDP) 控制的无头 Chromium 浏览器。

使用场景

搭配 OpenClaw 进行浏览器自动化
网页爬虫
自动化测试
截图服务

连接方式

同一个 Zeabur 项目中的其他服务可通过以下方式连接：

http://openclaw-sandbox-browser:9222

CDP 端点

GET /json/version - 浏览器版本信息
GET /json/list - 列出已打开的标签页
GET /json/new?url=<url> - 打开新标签页
WebSocket 连接用于 DevTools 协议

OpenClaw 配置

方式一：将配置贴给 OpenClaw 复制以下配置并贴到 OpenClaw 对话中，请它帮您更新配置文件：

"browser": {
  "enabled": true,
  "attachOnly": true,
  "defaultProfile": "remote",
  "profiles": {
    "remote": {
      "cdpUrl": "http://openclaw-sandbox-browser:9222",
      "color": "#FF4500"
    }
  }
}

示例提示词："请将这个浏览器配置添加到我的 openclaw.json 文件中"

方式二：OpenClaw Web UI

打开 OpenClaw Web UI（点击 Zeabur 控制台中的域名链接）
前往 Settings 页面
找到 Browser 区块并启用 Browser Tool
启用 Attach Only 模式
将 Default Profile 设为 remote
展开 Profiles 区块并点击 + Add Entry
填入配置文件信息：
- 配置文件名称：remote
- Cdp Url：http://openclaw-sandbox-browser:9222
- Color：#FF4500（选填）
保存设置 - 变更会自动应用

详细配置选项请参考官方文档。

资源需求

建议配置：1 vCPU、1 GB RAM
大量使用：2 vCPU、2 GB RAM

测试连线

部署完成后，从 OpenClaw 终端使用 curl 测试连线：

curl http://openclaw-sandbox-browser:9222/json/version

成功的话，您会看到类似以下的 JSON 响应：

{"Browser":"Chrome/...","Protocol-Version":"1.3",...}

可忽略的错误

以下日志中的错误信息是正常的，可以安全忽略：

Failed to connect to the bus - 容器内没有 D-Bus（正常现象）
Failed to adjust OOM score - 权限限制（不影响功能）
DEPRECATED_ENDPOINT - 无头模式不需要 Google Cloud Messaging

文档

OpenClaw 模板：https://zeabur.com/templates/VTZ4FX
OpenClaw 浏览器工具：https://docs.openclaw.ai/tools/browser
GitHub：https://github.com/canyugs/openclaw-sandbox-browser

OpenClaw Browser Sandbox

模版内的服务

openclaw-sandbox-browser