# 浏览器工具配置

## 一、结论先行

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

```json
{
  "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. 插件安装
   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`，安装插件
2. 配置 openclaw 浏览器工具
   1. 打开 openclaw 浏览器工具配置文件 `openclaw browser.json`
   2. 配置 `cdpPort` 为 `18792`
   3. 配置 `gatewayToken` 为 `token`
   4. 保存配置文件

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