背景介紹

OpenClaw接入瀏覽器功能讓AI助手能夠直接控制和操作瀏覽器，實(shí)現(xiàn)網(wǎng)頁(yè)自動(dòng)化、信息抓取、頁(yè)面分析等能力。通過(guò)瀏覽器接入，OpenClaw可以：

• 網(wǎng)頁(yè)自動(dòng)化操作：自動(dòng)點(diǎn)擊、填寫(xiě)表單、導(dǎo)航頁(yè)面
• 信息提取：抓取網(wǎng)頁(yè)內(nèi)容、截圖、生成PDF
• 實(shí)時(shí)交互：與網(wǎng)頁(yè)元素進(jìn)行交互，模擬用戶(hù)操作
• 多場(chǎng)景應(yīng)用：支持獨(dú)立瀏覽器、現(xiàn)有瀏覽器會(huì)話(huà)、遠(yuǎn)程瀏覽器等多種模式

這在需要網(wǎng)頁(yè)自動(dòng)化、數(shù)據(jù)采集、測(cè)試驗(yàn)證等場(chǎng)景中非常有用。

接入配置說(shuō)明

配置文件位置

所有瀏覽器配置都在 ~/.openclaw/openclaw.json 文件中進(jìn)行設(shè)置。如果文件不存在，OpenClaw會(huì)在首次啟動(dòng)時(shí)自動(dòng)創(chuàng)建。

核心配置項(xiàng)詳解

基礎(chǔ)配置

{
  "browser": {
    "enabled": true,
    "defaultProfile": "openclaw"
  }
}

• enabled: 布爾值，控制是否啟用瀏覽器功能。設(shè)為false時(shí)完全禁用瀏覽器訪(fǎng)問(wèn)。
• defaultProfile: 字符串，指定默認(rèn)使用的瀏覽器配置文件名稱(chēng)。當(dāng)不指定--browser-profile參數(shù)時(shí)使用此配置。

瀏覽器路徑配置

{
  "browser": {
    "executablePath": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
    "headless": false,
    "noSandbox": false
  }
}

• executablePath: 字符串，指定瀏覽器可執(zhí)行文件的完整路徑。

  • 如果不設(shè)置，OpenClaw會(huì)自動(dòng)檢測(cè)系統(tǒng)中的Chrome、Brave、Edge等瀏覽器
  • macOS示例："/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
  • Linux示例："/usr/bin/google-chrome"
  • Windows示例："C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"

• headless: 布爾值，是否以無(wú)頭模式運(yùn)行瀏覽器。

  • 無(wú)頭模式：瀏覽器在后臺(tái)運(yùn)行，不顯示圖形界面，適合服務(wù)器環(huán)境
  • true：后臺(tái)運(yùn)行，節(jié)省資源但無(wú)法看到瀏覽器界面
  • false：顯示瀏覽器窗口，可以看到操作過(guò)程

• noSandbox: 布爾值，是否禁用瀏覽器沙箱。

  • 沙箱：瀏覽器安全機(jī)制，隔離網(wǎng)頁(yè)進(jìn)程，防止惡意代碼影響系統(tǒng)
  • true：禁用沙箱，在某些Linux環(huán)境下可能需要
  • false：?jiǎn)⒂蒙诚?，推薦用于安全環(huán)境

配置文件詳解

"profiles": {
  "openclaw": { 
    "cdpPort": 18800, 
    "color": "#FF4500" 
  },
  "work": { 
    "cdpPort": 18801, 
    "color": "#0066CC" 
  },
  "user": {
    "driver": "existing-session",
    "attachOnly": true,
    "color": "#00AA00"
  }
}

• profiles: 對(duì)象，包含多個(gè)瀏覽器配置文件

  • 每個(gè)鍵是配置文件名稱(chēng)，可以自由命名
  • 值是配置對(duì)象，定義該配置文件的行為

• cdpPort: 數(shù)字，Chrome DevTools Protocol端口。

  • CDP：Chrome DevTools Protocol，瀏覽器遠(yuǎn)程控制協(xié)議
  • 默認(rèn)范圍18800-18899，每個(gè)配置文件應(yīng)使用不同端口
  • 本地配置文件通常需要設(shè)置此端口

• color: 字符串，瀏覽器窗口的邊框顏色（十六進(jìn)制顏色碼）

  • 用于區(qū)分不同的瀏覽器配置文件
  • 例如："#FF4500"（橙色）、"#0066CC"（藍(lán)色）、"#00AA00"（綠色）

• driver: 字符串，指定瀏覽器驅(qū)動(dòng)類(lèi)型

  • "managed"：默認(rèn)值，OpenClaw管理的獨(dú)立瀏覽器
  • "existing-session"：連接到現(xiàn)有的Chrome會(huì)話(huà)
  • "extension"：通過(guò)Chrome擴(kuò)展程序控制

• attachOnly: 布爾值，是否只附加到現(xiàn)有瀏覽器

  • true：不啟動(dòng)新瀏覽器，只連接到已運(yùn)行的實(shí)例
  • false：可以啟動(dòng)新的瀏覽器實(shí)例

安全策略配置

"ssrfPolicy": {
  "dangerouslyAllowPrivateNetwork": true,
  "hostnameAllowlist": ["*.example.com", "example.com"]
}

• dangerouslyAllowPrivateNetwork: 布爾值，是否允許訪(fǎng)問(wèn)私有網(wǎng)絡(luò)。

  • SSRF：Server-Side Request Forgery，服務(wù)器端請(qǐng)求偽造
  • true：允許訪(fǎng)問(wèn)內(nèi)網(wǎng)地址（如192.168.x.x、10.x.x.x），有安全風(fēng)險(xiǎn)
  • false：只允許訪(fǎng)問(wèn)公網(wǎng)地址，更安全

• hostnameAllowlist: 數(shù)組，允許訪(fǎng)問(wèn)的主機(jī)名白名單

  • 限制瀏覽器只能訪(fǎng)問(wèn)指定域名
  • 支持通配符，如"*.example.com"匹配所有子域名

主要瀏覽器模式詳解

1. openclaw模式（默認(rèn)）：

   • 創(chuàng)建獨(dú)立的瀏覽器實(shí)例，完全隔離用戶(hù)數(shù)據(jù)
   • 適合自動(dòng)化測(cè)試、數(shù)據(jù)采集等場(chǎng)景
   • 不會(huì)影響用戶(hù)的正常瀏覽器使用

2. user模式：

   • 連接到現(xiàn)有的已登錄Chrome會(huì)話(huà)
   • 可以訪(fǎng)問(wèn)用戶(hù)的登錄狀態(tài)、書(shū)簽、擴(kuò)展等
   • 需要用戶(hù)手動(dòng)批準(zhǔn)連接請(qǐng)求

3. chrome-relay模式：

   • 通過(guò)Chrome擴(kuò)展程序控制現(xiàn)有標(biāo)簽頁(yè)
   • 需要安裝OpenClaw瀏覽器擴(kuò)展
   • 用戶(hù)點(diǎn)擊擴(kuò)展圖標(biāo)來(lái)選擇要控制的標(biāo)簽頁(yè)

4. 遠(yuǎn)程模式：

   • 連接遠(yuǎn)程CDP服務(wù)，如Browserless、Browserbase等
   • 適合云端自動(dòng)化、大規(guī)模數(shù)據(jù)采集
   • 需要配置cdpUrl指向遠(yuǎn)程服務(wù)地址

完整配置示例

基礎(chǔ)配置

這是最基本且安全的配置，適合大多數(shù)用戶(hù)：

配置文件位置：~/.openclaw/openclaw.json

{
  "browser": {
    "enabled": true,
    "defaultProfile": "openclaw",
    "headless": false,
    "noSandbox": false,
    "executablePath": "",
    "profiles": {
      "openclaw": {
        "cdpPort": 18800,
        "color": "#FF4500"
      }
    },
    "ssrfPolicy": {
      "dangerouslyAllowPrivateNetwork": false,
      "hostnameAllowlist": []
    }
  }
}

使用說(shuō)明：

1. 將上述配置復(fù)制到 ~/.openclaw/openclaw.json 文件中
2. 如果文件不存在，會(huì)自動(dòng)創(chuàng)建
3. 重啟OpenClaw Gateway使配置生效
4. 使用默認(rèn)命令：openclaw browser status 驗(yàn)證配置

高級(jí)配置

適合需要多種瀏覽器環(huán)境的進(jìn)階用戶(hù)：

{
  "browser": {
    "enabled": true,
    "defaultProfile": "openclaw",
    "headless": false,
    "noSandbox": false,
    "executablePath": "",
    "profiles": {
      "openclaw": {
        "cdpPort": 18800,
        "color": "#FF4500"
      },
      "work": {
        "cdpPort": 18801,
        "color": "#0066CC"
      },
      "user": {
        "driver": "existing-session",
        "attachOnly": true,
        "color": "#00AA00"
      },
      "chrome-relay": {
        "driver": "extension",
        "cdpUrl": "http://127.0.0.1:18792",
        "color": "#00AA00"
      }
    },
    "ssrfPolicy": {
      "dangerouslyAllowPrivateNetwork": false,
      "hostnameAllowlist": ["*.baidu.com", "*.google.com", "*.github.com"]
    }
  }
}

配置說(shuō)明：

• openclaw：默認(rèn)的獨(dú)立瀏覽器，橙色邊框
• work：工作環(huán)境瀏覽器，藍(lán)色邊框，端口18801
• user：連接到現(xiàn)有Chrome會(huì)話(huà)，綠色邊框
• chrome-relay：通過(guò)擴(kuò)展控制現(xiàn)有標(biāo)簽頁(yè)
• 白名單限制了只能訪(fǎng)問(wèn)常用網(wǎng)站，提高安全性

遠(yuǎn)程瀏覽器配置

連接云端瀏覽器服務(wù)（需要API密鑰）：

{
  "browser": {
    "enabled": true,
    "defaultProfile": "browserless",
    "remoteCdpTimeoutMs": 2000,
    "remoteCdpHandshakeTimeoutMs": 4000,
    "profiles": {
      "browserless": {
        "cdpUrl": "https://production-sfo.browserless.io?token=YOUR_API_KEY",
        "color": "#00AA00"
      },
      "browserbase": {
        "cdpUrl": "wss://connect.browserbase.com?apiKey=YOUR_API_KEY",
        "color": "#F97316"
      }
    },
    "ssrfPolicy": {
      "dangerouslyAllowPrivateNetwork": false
    }
  }
}

使用前準(zhǔn)備：

1. 注冊(cè)Browserless或Browserbase賬戶(hù)
2. 獲取API密鑰
3. 替換配置中的YOUR_API_KEY為實(shí)際密鑰
4. 建議將密鑰存儲(chǔ)在環(huán)境變量中，避免硬編碼

平臺(tái)特定配置

macOS專(zhuān)用配置

{
  "browser": {
    "enabled": true,
    "executablePath": "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
    "profiles": {
      "openclaw": {
        "cdpPort": 18800,
        "color": "#FF4500"
      }
    }
  }
}

Linux專(zhuān)用配置

{
  "browser": {
    "enabled": true,
    "executablePath": "/usr/bin/google-chrome",
    "noSandbox": true,
    "profiles": {
      "openclaw": {
        "cdpPort": 18800,
        "color": "#FF4500"
      }
    }
  }
}

Windows專(zhuān)用配置

{
  "browser": {
    "enabled": true,
    "executablePath": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe",
    "profiles": {
      "openclaw": {
        "cdpPort": 18800,
        "color": "#FF4500"
      }
    }
  }
}

配置驗(yàn)證命令

配置完成后，使用以下命令驗(yàn)證：

# 檢查瀏覽器狀態(tài)
openclaw browser status
# 啟動(dòng)瀏覽器
openclaw browser start
# 列出所有標(biāo)簽頁(yè)
openclaw browser tabs
# 打開(kāi)測(cè)試網(wǎng)頁(yè)
openclaw browser open https://example.com
# 獲取截圖驗(yàn)證
openclaw browser screenshot

效果演示

案例：AI助手自動(dòng)打開(kāi)網(wǎng)頁(yè)并截圖

以下演示展示AI助手如何使用OpenClaw瀏覽器工具自動(dòng)操作網(wǎng)頁(yè)：

場(chǎng)景：AI助手需要打開(kāi)百度首頁(yè)，搜索"OpenClaw"，然后截圖保存結(jié)果。

AI助手的操作流程：

1. 打開(kāi)百度首頁(yè)：

   使用瀏覽器工具打開(kāi) https://www.baidu.com

2. 獲取頁(yè)面快照以了解結(jié)構(gòu)：

   獲取頁(yè)面快照，了解搜索框位置

3. 在搜索框中輸入關(guān)鍵詞：

   在搜索框中輸入"OpenClaw"

4. 點(diǎn)擊搜索按鈕：

   點(diǎn)擊搜索按鈕執(zhí)行搜索

5. 等待搜索結(jié)果加載：

   等待頁(yè)面加載完成

6. 截圖保存搜索結(jié)果：

   對(duì)搜索結(jié)果頁(yè)面進(jìn)行截圖

操作結(jié)果截圖：

上圖展示了AI助手成功完成整個(gè)自動(dòng)化流程：打開(kāi)百度首頁(yè)、在搜索框中輸入"OpenClaw"關(guān)鍵詞、點(diǎn)擊搜索按鈕執(zhí)行搜索，并成功獲取搜索結(jié)果頁(yè)面的完整過(guò)程。頁(yè)面顯示了與OpenClaw相關(guān)的搜索結(jié)果，證明了瀏覽器自動(dòng)化功能的有效性。

技術(shù)實(shí)現(xiàn)細(xì)節(jié)：

• 瀏覽器配置：使用獨(dú)立的openclaw配置文件運(yùn)行，端口18800，橙色標(biāo)識(shí)
• 自動(dòng)化流程：
  1. 打開(kāi)百度首頁(yè)（https://www.baidu.com）
  2. 通過(guò)頁(yè)面快照分析DOM結(jié)構(gòu)，定位搜索框（ref=e36）
  3. 使用type動(dòng)作在搜索框中輸入"OpenClaw"
  4. 設(shè)置submit=true自動(dòng)提交搜索表單
  5. 等待頁(yè)面跳轉(zhuǎn)并加載搜索結(jié)果
  6. 截取完整的搜索結(jié)果頁(yè)面
• 環(huán)境隔離：所有操作都在OpenClaw管理的獨(dú)立瀏覽器實(shí)例中進(jìn)行，與用戶(hù)日常瀏覽器完全隔離
• 結(jié)果驗(yàn)證：截圖清晰顯示了搜索成功執(zhí)行，頁(yè)面包含多個(gè)OpenClaw相關(guān)的搜索結(jié)果，證明了瀏覽器控制功能的完整性和可靠性

注意事項(xiàng)

常見(jiàn)錯(cuò)誤及解決方案

1. 瀏覽器未啟動(dòng)：

   • 錯(cuò)誤：“Browser disabled”
   • 原因：配置文件中的browser.enabled設(shè)置為false
   • 解決：編輯~/.openclaw/openclaw.json，將enabled改為true，然后重啟Gateway

2. 端口沖突：

   • 錯(cuò)誤："Port already in use"或連接失敗
   • 原因：cdpPort被其他程序占用
   • 解決：修改配置文件中的cdpPort為其他值（如18801、18802等）

3. Playwright缺失：

   • 錯(cuò)誤：“Playwright is not available in this gateway build”
   • 原因：未安裝完整版Playwright，只安裝了playwright-core
   • 解決：運(yùn)行npm install playwright安裝完整版本，然后重啟Gateway

4. Chrome版本不兼容：

   • 錯(cuò)誤：連接超時(shí)或協(xié)議錯(cuò)誤
   • 原因：Chrome版本過(guò)低或遠(yuǎn)程調(diào)試未啟用
   • 解決：
     • 升級(jí)Chrome到144+版本
     • 在Chrome中訪(fǎng)問(wèn)chrome://inspect/#remote-debugging啟用遠(yuǎn)程調(diào)試
     • 確保用戶(hù)手動(dòng)批準(zhǔn)連接請(qǐng)求

5. 權(quán)限問(wèn)題：

   • 錯(cuò)誤：“Unauthorized"或"Access denied”
   • 原因：Gateway認(rèn)證配置阻止了瀏覽器訪(fǎng)問(wèn)
   • 解決：檢查Gateway的認(rèn)證設(shè)置，確保有正確的訪(fǎng)問(wèn)令牌或密碼

安全注意事項(xiàng)

1. 網(wǎng)絡(luò)隔離：將Gateway和節(jié)點(diǎn)主機(jī)保持在私有網(wǎng)絡(luò)內(nèi)，避免公網(wǎng)暴露
2. 令牌管理：遠(yuǎn)程CDP URL和API令牌視為機(jī)密，使用環(huán)境變量或密鑰管理器
3. 配置文件保護(hù)：避免在openclaw.json中直接存儲(chǔ)敏感信息
4. 最小權(quán)限原則：只授予必要的網(wǎng)絡(luò)訪(fǎng)問(wèn)權(quán)限，使用hostnameAllowlist限制域名

參考資料

1. OpenClaw瀏覽器工具官方文檔
2. Chrome DevTools MCP官方指南
3. Browserless云端瀏覽器服務(wù)
4. Browserbase云端瀏覽器平臺(tái)
5. OpenClaw安裝與配置指南

到此這篇關(guān)于OpenClaw接入Chrome瀏覽器的文章就介紹到這了,更多相關(guān)OpenClaw接入Chrome瀏覽器內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論