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

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

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

资源需求

• 建议配置：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