OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Chrome 擴充功能

Chrome 擴充功能

OpenClaw Chrome 擴充功能可讓代理控制您已登入的 Chrome 分頁，無須啟動個別的受管理瀏覽器，也不會觸發 Chrome 阻擋操作的「Allow remote debugging?」提示。

當您從手機（Telegram、WhatsApp 等）操作 OpenClaw 時，這一點非常重要：「user 設定檔」會透過 Chrome 的遠端偵錯連接埠連線，並在桌面上彈出同意對話方塊；您不在電腦旁時，沒有人能按下確認。此擴充功能則改用 chrome.debugger API，因此頁面中唯一的提示是 Chrome 可關閉的「OpenClaw started debugging this browser」橫幅。

這與 Anthropic 的 Claude in Chrome 和 OpenAI 的 Codex Chrome 擴充功能採用相同的架構。

運作方式

由三個部分組成：

  • 瀏覽器控制服務（閘道或節點主機）：browser 工具呼叫的 API。
  • 擴充功能中繼服務（回送 WebSocket）：控制服務在 127.0.0.1 上啟動的小型伺服器。它向 OpenClaw 提供 Chrome DevTools Protocol 端點，並與擴充功能通訊。雙方都使用主機本機權杖進行驗證（請參閱下文）。
  • OpenClaw Chrome 擴充功能（MV3）：使用 chrome.debugger 附加至分頁、轉送 CDP 流量，並管理 OpenClaw 分頁群組。

OpenClaw 只能查看和控制 OpenClaw 分頁群組中的分頁。該群組就是同意存取的界線：將分頁拖入即可分享；將其拖出（或按一下工具列按鈕）即可立即撤銷存取權。

安裝與配對

  1. 顯示未封裝擴充功能的路徑：

    bash
    openclaw browser extension path

  2. 開啟 chrome://extensions、啟用 Developer mode、按一下 Load unpacked，然後選取所顯示的目錄。

  3. 顯示配對字串：

    bash
    openclaw browser extension pair

  4. 按一下 OpenClaw 工具列圖示，並將配對字串貼到彈出式視窗中。擴充功能連線至中繼服務後，徽章會顯示 ON。

配對權杖是首次使用時建立的主機本機密鑰，儲存在狀態目錄的 credentials/ 下（模式為 0600）。每台執行瀏覽器的機器（包括閘道主機及每台瀏覽器節點主機）都有自己的權杖，因此憑證不必在機器之間傳輸。若要輪替權杖，請刪除 browser-extension-relay.secret 檔案並重新配對。

使用方式

在 browser 工具呼叫中選取內建的 chrome 設定檔，或將其設為預設值：

bash
openclaw config set browser.defaultProfile chrome
json5
{  browser: {    profiles: {      chrome: { driver: "extension", color: "#FF4500" },    },  },}
  • 分享分頁：在該分頁上按一下 OpenClaw 工具列按鈕（該分頁會加入 OpenClaw 分頁群組），或將任何分頁拖入群組。
  • 代理也可以開啟新分頁；這些分頁會自動加入群組。
  • 撤銷存取權：再次按一下按鈕、將分頁拖出群組，或關閉 Chrome 的偵錯橫幅。代理會立即失去該分頁的存取權。

遠端／跨機器

Chrome 不一定要在閘道主機上執行。支援以下三種拓撲：

  • 同一主機（閘道與 Chrome 位於同一台機器）：在該機器上使用 openclaw browser extension pair 進行配對。中繼服務僅限回送連線。
  • 直接連線至遠端閘道（Chrome 在您的筆記型電腦上、閘道位於 VPS，且筆記型電腦上沒有其他元件）：在閘道上執行 openclaw browser extension pair --gateway-url wss://your-gateway.example.com。此命令會顯示 wss://…/browser/extension#<secret> 字串；請在筆記型電腦上載入擴充功能並進行配對。擴充功能會透過 wss:// 直接連線至閘道，筆記型電腦上不需要安裝 OpenClaw、節點、命令列介面，也不需要開放入站連接埠。這是受管理代管的使用方式。
  • 透過瀏覽器節點主機（Chrome 位於已執行 OpenClaw 節點的機器）：在該節點上執行 pair 並於本機配對；閘道會透過現有且經過驗證的節點連線，將瀏覽器操作代理轉送至該節點。

配對密鑰為每台主機各自擁有（直接連線時則使用閘道的密鑰），並由閘道的 /browser/extension 路由驗證。若使用直接連線方式，請透過 TLS（wss://）提供閘道服務，以加密配對密鑰與 CDP 流量。 密鑰會保留在配對字串的 URL 片段中，並在 WebSocket 交握期間作為子協定憑證提供，因此一般的 Proxy 存取記錄不會在請求 URL 中收到該密鑰。請確保任何反向 Proxy 都會保留標準的 Sec-WebSocket-Protocol 標頭。

診斷

bash
openclaw browser status --browser-profile chromeopenclaw browser doctor --browser-profile chrome

在擴充功能彈出式視窗顯示 Connected 之前，doctor 會將 Chrome 擴充功能中繼服務檢查報告為失敗。

安全性模型

  • 中繼服務僅繫結至回送介面；WebSocket 雙方都會使用衍生權杖進行驗證，且擴充功能端會檢查來源是否為 chrome-extension://。
  • 閘道直接配對不接受請求 URL 中的中繼權杖；隨附的擴充功能會改為透過 WebSocket 子協定清單攜帶該權杖。
  • 代理只能查看和操作 OpenClaw 分頁群組中的分頁。您的其他分頁會維持私密。
  • 相較於 user（Chrome MCP）設定檔在您核准遠端偵錯提示後會暴露整個已登入的瀏覽器，此擴充功能會將共享範圍限制在您可一目瞭然地控制的分頁群組中。

另請參閱：瀏覽器，以瞭解完整的設定檔模型，以及受管理的 openclaw 和 Chrome MCP user 設定檔。

Was this useful?
On this page

On this page