English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Tools

Chrome 擴充功能

Chrome 擴充功能

OpenClaw Chrome 擴充功能可讓代理控制你的已登入 Chrome 分頁，不必啟動另一個受管理瀏覽器，也不會出現 Chrome 會阻擋流程的「允許遠端偵錯？」提示。

當你從手機（Telegram、WhatsApp 等）驅動 OpenClaw 時，這一點很重要： user 設定檔會透過 Chrome 的遠端偵錯連接埠連上，這會跳出桌面同意對話框；當你不在電腦前時沒有人能點選。 此擴充功能改用 chrome.debugger API，因此頁面內唯一的提示是 Chrome 可關閉的 「OpenClaw 已開始偵錯此瀏覽器」橫幅。

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

運作方式

三個部分：

  • 瀏覽器控制服務（閘道或節點主機）：browser 工具呼叫的 API。
  • 擴充功能轉送（loopback 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，啟用開發人員模式，點擊載入未封裝項目， 並選取印出的目錄。

  3. 印出配對字串：

    bash
    openclaw browser extension pair

  4. 點擊 OpenClaw 工具列圖示，並將配對字串貼到彈出視窗中。 擴充功能連上轉送後，徽章會變成開啟。

配對權杖是首次使用時建立的主機本機密鑰，並儲存在狀態目錄下的 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 是在閘道主機上執行，還是在另一台 瀏覽器節點主機上執行，此擴充功能都能運作。 轉送一律只限 loopback，且執行在裝有瀏覽器的機器上：

  • 同一主機（閘道 + Chrome 在同一台機器上）：在該機器上配對。
  • 遠端節點（Chrome 在節點上，閘道在其他地方）：在該節點上執行 openclaw browser extension path / pair，並在那裡載入及配對擴充功能。 閘道會透過既有已驗證的節點連線，將瀏覽器操作代理到該節點；該節點的本機轉送會驅動擴充功能。 節點上不會開啟新的傳入連接埠。

配對權杖是逐主機設定，因此每個節點都會印出自己的字串。

診斷

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

在擴充功能彈出視窗顯示已連線之前，doctor 會回報 Chrome 擴充功能轉送檢查失敗。

安全模型

  • 轉送只綁定 loopback；兩個 WebSocket 端都使用衍生權杖驗證， 且擴充功能端會檢查來源是否為 chrome-extension://。
  • 代理只能看見並驅動 OpenClaw 分頁群組中的分頁。你的其他分頁會保持私密。
  • 相較於 user（Chrome MCP）設定檔在你核准遠端偵錯提示後會暴露整個已登入瀏覽器， 此擴充功能會將分享範圍限制在你一眼就能控管的分頁群組中。

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

Was this useful?
On this page

On this page