OpenClaw Browser 指令操作指南：自動化控制瀏覽器

寫程式最煩的就是要自動化瀏覽器操作時，得在各種工具和設定之間切換。如果你也覺得設定 headless 瀏覽器或是處理複雜的網頁互動很痛苦，OpenClaw 的 browser 指令會是你的救星。

openclaw browser

管理 OpenClaw 的 browser 控制伺服器，並執行 browser 動作（分頁、快照、截圖、導航、點擊、輸入）。

相關資源：

• Browser 工具 + API：Browser tool

通用 flags

• --url <gatewayWsUrl>：Gateway WebSocket URL（預設使用設定檔內容）。
• --token <token>：Gateway token（如果需要的話）。
• --timeout <ms>：請求超時時間 (ms)。
• --browser-profile <name>：選擇一個 browser 設定檔（預設使用設定檔中的設定）。
• --json：輸出機器可讀的格式（在支援的部分）。

快速開始 (在地端)

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

如果找不到指令

如果 openclaw browser 顯示為未知指令，請檢查 ~/.openclaw/openclaw.json 中的 plugins.allow。

當 plugins.allow 存在時，必須明確列出內建的 browser 插件：

{
  plugins: {
    allow: ["telegram", "browser"],
  },
}

即使 browser.enabled=true，如果插件白名單排除了 browser，CLI 子指令也不會出現。

相關資源：Browser tool

設定檔 (Profiles)

Profiles 是具名的 browser 路由設定。實際使用上：

• openclaw：啟動或連接到 OpenClaw 管理的專用 Chrome 實例（獨立的使用者資料目錄）。
• user 與自定義 CDP：控制你現有的 Chrome 登入工作階段（透過 Chrome DevTools MCP），或指向在地/遠端的 CDP 端點。

openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser create-profile --name chrome-live --driver existing-session
openclaw browser delete-profile --name work

使用特定設定檔：

openclaw browser --browser-profile work tabs

分頁 (Tabs)

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

快照 / 截圖 / 動作

快照 (Snapshot)：

openclaw browser snapshot

截圖 (Screenshot)：

openclaw browser screenshot

導航、點擊與輸入（基於 ref 的 UI 自動化）：

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

透過 MCP 使用現有的 Chrome

使用內建的 user 設定檔，或建立你自己的 existing-session 設定檔：

openclaw browser --browser-profile user tabs
openclaw browser create-profile --name chrome-live --driver existing-session
openclaw browser create-profile --name brave-live --driver existing-session --user-data-dir "~/Library/Application Support/BraveSoftware/Brave-Browser"
openclaw browser --browser-profile chrome-live tabs

這個路徑僅限於主機端。如果是 Docker、headless 伺服器、Browserless 或其他遠端環境，請改用 CDP profile。

遠端 browser 控制 (node host proxy)

如果 Gateway 與 browser 執行在不同的機器上，請在裝有 Chrome/Brave/Edge/Chromium 的機器上執行 node host。Gateway 會將 browser 動作代理到該節點（不需要額外的 browser 控制伺服器）。

使用 gateway.nodes.browser.mode 來控制自動路由，若連接了多個節點，可使用 gateway.nodes.browser.node 來指定特定節點。

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

---

下一步：

• Browser 工具詳細說明
• 設定遠端存取

有任何設定上的問題嗎？試試我們的 AI Setup Assistant！