Molili遠(yuǎn)程瀏覽器使用指南，怎么讓Molili遠(yuǎn)程控制瀏覽器

想個(gè)什么名 · 發(fā)表于 2026-3-4 14:26

本帖最后由八云紅于 2026-3-4 14:31 編輯

這幾天晚上經(jīng)常用Molili幫我操作點(diǎn)東西，結(jié)果發(fā)現(xiàn)瀏覽器又連不上了。每次重啟Gateway后，我又得重新打開(kāi)Chrome瀏覽器，手動(dòng)點(diǎn)擊那個(gè)BrowserRelay插件的圖標(biāo)。本來(lái)都躺在床上了，真的很不想再起來(lái)打開(kāi)電腦，這讓我苦惱不已。為了解決這個(gè)痛點(diǎn)，我徹底研究了一下Molili遠(yuǎn)程控制瀏覽器的底層邏輯。今天整理出這篇Molili遠(yuǎn)程瀏覽器使用指南，希望能幫到同樣在折騰Molili自動(dòng)化的小伙伴。

Molili遠(yuǎn)程瀏覽器使用指南，怎么讓Molili遠(yuǎn)程控制瀏覽器

一、什么是BrowserRelay？

Molili目前提供了兩種瀏覽器控制模式，滿足不同場(chǎng)景的Molili遠(yuǎn)程控制瀏覽器需求：

ManagedBrowser(托管瀏覽器)：Molili會(huì)啟動(dòng)一個(gè)獨(dú)立的Chrome實(shí)例，完全隔離于你的日常瀏覽器環(huán)境，適合跑一些干凈的后臺(tái)自動(dòng)化測(cè)試。

ExtensionRelay(擴(kuò)展中繼)：通過(guò)Chrome擴(kuò)展控制你現(xiàn)有的Chrome標(biāo)簽頁(yè)。

ExtensionRelay的核心價(jià)值在于：你可以直接讓AI操作你已經(jīng)登錄的網(wǎng)頁(yè)、正在瀏覽的內(nèi)容，而不需要重新在Molili的隔離環(huán)境中掃碼或者輸入密碼登錄，極大提升了日常使用的便利性。

二、安裝與配置Molili擴(kuò)展插件

1.安裝Chrome擴(kuò)展

首先在終端執(zhí)行以下命令將插件安裝到穩(wěn)定路徑，并查看輸出路徑：

Openclaw browser extension install
Openclaw browser extension path

獲取到目錄路徑后，將這個(gè)文件夾下載到你實(shí)際使用的電腦上。打開(kāi)其他電腦上的Chrome瀏覽器，地址欄輸入chrome://extensions進(jìn)入擴(kuò)展程序頁(yè)面。

開(kāi)啟頁(yè)面右上角的“開(kāi)發(fā)者模式”，點(diǎn)擊左上角的“加載已解壓的擴(kuò)展程序”，選擇剛才下載的目錄。最后記得將擴(kuò)展圖標(biāo)固定到瀏覽器工具欄，方便隨時(shí)查看狀態(tài)。

2.修改配置文件

在你的~/.OpenClaw/OpenClaw.json中進(jìn)行核心配置。因?yàn)槲疫@塊用的是SSH隧道的方案，所以直接采用的默認(rèn)配置，只設(shè)置了幾個(gè)基礎(chǔ)參數(shù)就可以跑通Molili遠(yuǎn)程控制瀏覽器。

3.設(shè)置SSH隧道映射

這一步是外網(wǎng)訪問(wèn)的關(guān)鍵！因?yàn)榘惭bMolili時(shí)用的默認(rèn)配置，系統(tǒng)監(jiān)聽(tīng)的都是127.0.0.1本地端口，外網(wǎng)是絕對(duì)無(wú)法直接訪問(wèn)這些端口的。必須在你的本地電腦CMD中運(yùn)行以下命令建立SSH隧道：

ssh -L 18792:127.0.0.1:18792 root@你的服務(wù)器IP

注意：這個(gè)命令需要一直保持CMD窗口開(kāi)啟才能維持隧道暢通。如果你嫌麻煩，可以完全讓AI給你寫(xiě)一個(gè)后臺(tái)靜默啟動(dòng)的VBS或者bat方案，做到開(kāi)機(jī)自啟一勞永逸。

插件徽章?tīng)顟B(tài)說(shuō)明

觀察插件圖標(biāo)上的字符，可以快速判斷Molili瀏覽器中繼的工作狀態(tài)：

ON：已附加，Molili現(xiàn)在可以完美控制該標(biāo)簽頁(yè)。

...：正在連接到本地中繼，請(qǐng)稍等片刻。

!：中繼不可達(dá)(最常見(jiàn)原因就是本地未運(yùn)行瀏覽器中繼服務(wù)，或者你的SSH隧道斷開(kāi)了)。

三、Molili常見(jiàn)問(wèn)題排查與修復(fù)方案

在使用Molili遠(yuǎn)程瀏覽器過(guò)程中我遇到了下面幾個(gè)坑?？赡?026.1.29版本的瀏覽器插件已經(jīng)更新修復(fù)了，若官方還沒(méi)修復(fù)徹底，你可以用我自己優(yōu)化編譯后的插件(提示：用我的優(yōu)化版需要在你工作區(qū)的tools.md中向AI強(qiáng)調(diào)一下配置)。

問(wèn)題1：“tab not found”報(bào)錯(cuò)

現(xiàn)象：tabs命令能正確列出標(biāo)簽頁(yè)，但執(zhí)行screenshot或snapshot時(shí)直接報(bào)錯(cuò)Error:tab not found。環(huán)境是Gateway運(yùn)行在Linux云服務(wù)器，Chrome擴(kuò)展運(yùn)行在Windows主機(jī)，且中繼狀態(tài)可達(dá)。

根本原因：當(dāng)多個(gè)標(biāo)簽頁(yè)同時(shí)附加時(shí)，它們共享同一個(gè)WebSocket連接，Playwright在解析目標(biāo)時(shí)無(wú)法確定應(yīng)該操作哪個(gè)具體標(biāo)簽頁(yè)。
臨時(shí)解決方案：一次只附加一個(gè)標(biāo)簽頁(yè)。在標(biāo)簽頁(yè)1上點(diǎn)擊擴(kuò)展圖標(biāo)關(guān)閉(OFF)，在標(biāo)簽頁(yè)2上開(kāi)啟(ON)，然后再執(zhí)行截圖或快照操作，按需手動(dòng)切換。

官方修復(fù)：在2026.1.29版本中，開(kāi)發(fā)團(tuán)隊(duì)添加了URL匹配回退機(jī)制。當(dāng)CDP連接失敗時(shí)，系統(tǒng)會(huì)嘗試通過(guò)URL匹配來(lái)精準(zhǔn)定位頁(yè)面。

問(wèn)題2：cdpReady狀態(tài)為false

現(xiàn)象：狀態(tài)面板顯示cdpReady:false，無(wú)法執(zhí)行任何快照或點(diǎn)擊操作。
解決方案：這個(gè)問(wèn)題在官方的Issue#1160中已經(jīng)修復(fù)。如果你使用的是2026.1.23-1或更早的舊版本，強(qiáng)烈建議直接執(zhí)行npm install -g Molili@latest升級(jí)到最新版本，或者直接從GitHub主分支克隆安裝。

問(wèn)題3：擴(kuò)展模式恢復(fù)失敗

現(xiàn)象：擴(kuò)展成功附加后，放置一段時(shí)間再次操作就會(huì)提示失敗。
修復(fù)：在2026.1.15版本中已修復(fù)后臺(tái)掉線問(wèn)題，系統(tǒng)優(yōu)化了目標(biāo)回調(diào)機(jī)制，確保Playwright阻塞新連接時(shí)依然能使用當(dāng)前活躍頁(yè)面。

問(wèn)題4：Sandbox沙盒模式無(wú)法控制主機(jī)瀏覽器

現(xiàn)象：在sandbox會(huì)話模式下無(wú)法使用擴(kuò)展中繼控制本地瀏覽器。
原因：Sandbox會(huì)話默認(rèn)安全策略為target="sandbox"，而擴(kuò)展中繼必須要求控制host主機(jī)瀏覽器權(quán)限。
解決方案：修改Molili配置文件，在配置中顯式允許host瀏覽器控制：

{
  "agents": {
"defaults": {
   "sandbox": {
      "browser": {
      "allowHostControl": true
      }
   }
}
  }
}

配置完成后，在調(diào)用browser工具時(shí)務(wù)必指定參數(shù)target="host"即可完美解決權(quán)限攔截問(wèn)題。

如果大家在配置SSH隧道或者編寫(xiě)后臺(tái)靜默運(yùn)行腳本時(shí)遇到了困難，需要我為你生成一份可以直接復(fù)制使用的Windows一鍵啟動(dòng)bat腳本嗎？

huanzhu格格 · 發(fā)表于 2026-3-4 19:19

感謝分享，感覺(jué)不明白但是我懂了

Mehr · 發(fā)表于 2026-3-4 19:20

sdhi是不是能用來(lái)?yè)屬?gòu)之類的？

Liebe、 · 發(fā)表于 2026-3-4 19:20

官方文檔里寫(xiě)了，這個(gè)擴(kuò)展底層用的是Chrome的chrome.debugger接口。這意味著AI可以讀取你當(dāng)前登錄賬號(hào)的所有狀態(tài)，大家給權(quán)限的時(shí)候一定要注意隱私安全，別讓它亂動(dòng)重要賬號(hào)

渡DUDU · 發(fā)表于 2026-3-4 19:21

為什么我點(diǎn)擊加載已解壓的擴(kuò)展程序，Chrome提示無(wú)法加載文件

在選材發(fā)王師傅 · 發(fā)表于 2026-3-4 19:21

不要把18792端口直接暴露在公網(wǎng)上！如果是云服務(wù)器，必須像樓主那樣用SSH隧道映射本地127.0.0.1，不然別人掃到你的端口就能直接控制你的瀏覽器

› 綜合交流 / 資源分享區(qū) › AI技術(shù)討論