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