背景介紹

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

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

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

接入配置說明

配置文件位置

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

核心配置項詳解

基礎配置

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

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

瀏覽器路徑配置

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

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

  • 如果不設置，OpenClaw會自動檢測系統(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: 布爾值，是否以無頭模式運行瀏覽器。

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

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

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

配置文件詳解

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

• profiles: 對象，包含多個瀏覽器配置文件

  • 每個鍵是配置文件名稱，可以自由命名
  • 值是配置對象，定義該配置文件的行為

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

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

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

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

• driver: 字符串，指定瀏覽器驅(qū)動類型

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

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

  • true：不啟動新瀏覽器，只連接到已運行的實例
  • false：可以啟動新的瀏覽器實例

安全策略配置

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

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

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

• hostnameAllowlist: 數(shù)組，允許訪問的主機名白名單

  • 限制瀏覽器只能訪問指定域名
  • 支持通配符，如"*.example.com"匹配所有子域名

主要瀏覽器模式詳解

1. openclaw模式（默認）：

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

2. user模式：

   • 連接到現(xiàn)有的已登錄Chrome會話
   • 可以訪問用戶的登錄狀態(tài)、書簽、擴展等
   • 需要用戶手動批準連接請求

3. chrome-relay模式：

   • 通過Chrome擴展程序控制現(xiàn)有標簽頁
   • 需要安裝OpenClaw瀏覽器擴展
   • 用戶點擊擴展圖標來選擇要控制的標簽頁

4. 遠程模式：

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

完整配置示例

基礎配置

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

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

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

使用說明：

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

高級配置

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

{
  "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"]
    }
  }
}

配置說明：

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

遠程瀏覽器配置

連接云端瀏覽器服務（需要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
    }
  }
}

使用前準備：

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

平臺特定配置

macOS專用配置

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

Linux專用配置

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

Windows專用配置

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

配置驗證命令

配置完成后，使用以下命令驗證：

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

效果演示

案例：AI助手自動打開網(wǎng)頁并截圖

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

場景：AI助手需要打開百度首頁，搜索"OpenClaw"，然后截圖保存結果。

AI助手的操作流程：

1. 打開百度首頁：

   使用瀏覽器工具打開 https://www.baidu.com

2. 獲取頁面快照以了解結構：

   獲取頁面快照，了解搜索框位置

3. 在搜索框中輸入關鍵詞：

   在搜索框中輸入"OpenClaw"

4. 點擊搜索按鈕：

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

5. 等待搜索結果加載：

   等待頁面加載完成

6. 截圖保存搜索結果：

   對搜索結果頁面進行截圖

操作結果截圖：

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

技術實現(xiàn)細節(jié)：

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

注意事項

常見錯誤及解決方案

1. 瀏覽器未啟動：

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

2. 端口沖突：

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

3. Playwright缺失：

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

4. Chrome版本不兼容：

   • 錯誤：連接超時或協(xié)議錯誤
   • 原因：Chrome版本過低或遠程調(diào)試未啟用
   • 解決：
     • 升級Chrome到144+版本
     • 在Chrome中訪問chrome://inspect/#remote-debugging啟用遠程調(diào)試
     • 確保用戶手動批準連接請求

5. 權限問題：

   • 錯誤：“Unauthorized"或"Access denied”
   • 原因：Gateway認證配置阻止了瀏覽器訪問
   • 解決：檢查Gateway的認證設置，確保有正確的訪問令牌或密碼

安全注意事項

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

參考資料

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

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

最新評論