3.3 KiB

Raw Permalink Blame History

浏览器工具配置

一、结论先行

可以使用如下配置（仅供参考）：

{
  "browser": {
  
    // 是否启用 browser 工具模块
    // 关闭后 OpenClaw 将不会提供浏览器自动化能力
    "enabled": true,
  
    // 调用远程 CDP（Chrome DevTools Protocol）接口时
    // 单次请求的超时时间（毫秒）
    "remoteCdpTimeoutMs": 1500,
  
    // 与远程 CDP 建立 WebSocket 连接时的握手超时时间（毫秒）
    "remoteCdpHandshakeTimeoutMs": 3000,
  
    // 浏览器实例在 UI 或日志中的默认标识颜色
    // 用于区分不同浏览器实例
    "color": "#FF4500",
  
    // OpenClaw 启动浏览器时使用的可执行文件路径
    // 只有在 OpenClaw 托管浏览器（spawn browser）模式下才会使用
    "executablePath": "/usr/bin/chromium-browser",
  
    // 是否以无头模式启动浏览器
    // true = 不显示浏览器窗口
    // false = 显示浏览器 UI
    "headless": false,
  
    // 是否添加 --no-sandbox 启动参数
    // 在 Docker / WSL / CI 环境中通常需要开启
    "noSandbox": true,
  
    // 是否只允许“附加到已有浏览器”
    // true  = OpenClaw 不会启动新浏览器，只能连接已有 CDP
    // false = OpenClaw 可以自行启动浏览器
    "attachOnly": false,
  
    // 默认使用的浏览器 profile 名称
    // 如果没有指定 profile，则使用这个
    "defaultProfile": "chrome",
  
    // 浏览器 profile 列表
    // 每个 profile 代表一个可控制的浏览器实例
    "profiles": {
  
      // OpenClaw 默认自动化浏览器实例
      "openclaw": {
  
        // 该浏览器实例的 CDP 调试端口
        // OpenClaw 会通过这个端口连接浏览器
        "cdpPort": 18800,
  
        // 该浏览器实例在 UI 或日志中的颜色标识
        "color": "#FF4500"
      },
  
      // 第二个浏览器实例（例如工作环境浏览器）
      "work": {
  
        // 该实例的 CDP 调试端口
        "cdpPort": 18801,
  
        // UI / 日志中的颜色标识
        "color": "#0066CC"
      }
    }
  }
}

二、实用场景

1.1 让 openclaw 控制个人浏览器实现自动化（使用个人用户态、登录态）

实现方案：

插件安装
1. 使用 openclaw 官方 chrome 插件
  1. 下载 openclaw 官方 chrome 插件 openclaw browser extension install
  2. 查看插件安装路径 openclaw browser extension path
  3. 打开 chrome 浏览器，访问 chrome://extensions/，开启开发者模式
  4. 点击 加载未打包的扩展程序，选择 openclaw 插件安装路径
  5. 中继器链接，使用中继器端口 18792 和网关令牌 token，保存即可
2. 自行在 chrome 商店下载安装 OpenClaw Borwser Relay 插件
  1. 登录谷歌插件商店 https://chromewebstore.google.com/category/extensions
  2. 搜索 OpenClaw Browser Relay，选一个高分的就行，都不是官方的
  3. 点击 添加到 Chrome，安装插件
配置 openclaw 浏览器工具
1. 打开 openclaw 浏览器工具配置文件 openclaw browser.json
2. 配置 cdpPort 为 18792
3. 配置 gatewayToken 为 token
4. 保存配置文件

3.3 KiB Raw Permalink Blame History Unescape Escape

浏览器工具配置

一、结论先行

二、实用场景

1.1 让 openclaw 控制个人浏览器实现自动化（使用个人用户态、登录态）

1.2让 openclaw 控制浏览器自行实现自动化（使用 openclaw 同一环境如 linux 浏览器）

3.3 KiB

Raw Permalink Blame History