`openclaw browser`

管理 OpenClaw 的瀏覽器控制伺服器，並執行瀏覽器操作（分頁、快照、螢幕截圖、導覽、點擊、打字）。

相關資源：

瀏覽器工具 + API：Browser tool
Chrome 擴充功能中繼：Chrome extension

常用旗標

--url <gatewayWsUrl>：Gateway WebSocket URL（預設使用設定值）。
--token <token>：Gateway token（若需要）。
--timeout <ms>：請求逾時（毫秒）。
--browser-profile <name>：選擇瀏覽器設定檔（預設使用設定值）。
--json：機器可讀輸出（部分指令支援）。

快速開始（本地）

openclaw browser --browser-profile chrome tabs
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

設定檔

設定檔是已命名的瀏覽器路由設定。實際上：

openclaw：啟動/附接至專用的 OpenClaw 管理 Chrome 實例（獨立的使用者資料目錄）。
chrome：透過 Chrome 擴充功能中繼控制你現有的 Chrome 分頁。

openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser delete-profile --name work

使用特定設定檔：

openclaw browser --browser-profile work tabs

分頁

openclaw browser tabs
openclaw browser open https://docs.openclaw.ai
openclaw browser focus <targetId>
openclaw browser close <targetId>

快照 / 螢幕截圖 / 操作

快照：

openclaw browser snapshot

螢幕截圖：

openclaw browser screenshot

導覽/點擊/打字（基於 ref 的 UI 自動化）：

openclaw browser navigate https://example.com
openclaw browser click <ref>
openclaw browser type <ref> "hello"

Chrome 擴充功能中繼（透過工具列按鈕附接）

此模式讓 agent 控制你手動附接的現有 Chrome 分頁（不會自動附接）。

將未封裝擴充功能安裝到穩定路徑：

openclaw browser extension install
openclaw browser extension path

然後前往 Chrome -> chrome://extensions -> 啟用「開發人員模式」-> 「載入未封裝項目」-> 選擇列出的資料夾。

完整指南：Chrome extension

遠端瀏覽器控制（節點主機代理）

如果 Gateway 和瀏覽器在不同機器上，在擁有 Chrome/Brave/Edge/Chromium 的機器上執行節點主機。Gateway 會將瀏覽器操作代理到該節點（不需要額外的瀏覽器控制伺服器）。

使用 gateway.nodes.browser.mode 控制自動路由，使用 gateway.nodes.browser.node 在多個節點連線時釘選特定節點。

安全性與遠端設定：Browser tool、Remote access、Tailscale、Security