OpenClaw 允许你的代理控制一个 专用的 Chrome/Brave/Edge/Chromium 配置文件。这为 浏览器自动化 和 网页抓取 提供了一个安全、隔离的环境，与你的个人浏览会话区分开来。

• 隔离：保持代理活动与你的个人工作分离。
• 安全：防止代理意外关闭你的标签页或泄露你的会话数据。
• 能力：启用完全自动化（快照、PDF 生成、截图、复杂交互）。
• 多配置文件：支持多个隔离的配置文件（例如，work、research、testing）。

1. 检查状态 验证浏览器服务是否就绪。

   openclaw browser --browser-profile openclaw status

2. 启动浏览器 启动托管浏览器实例。

   openclaw browser --browser-profile openclaw start

3. 打开页面 将代理指向一个 URL。

   openclaw browser --browser-profile openclaw open https://example.com

4. 拍摄快照 查看代理看到了什么。

   openclaw browser --browser-profile openclaw snapshot

要默认使用托管浏览器，在你的配置中设置 browser.defaultProfile: "openclaw"。

浏览器设置位于 ~/.openclaw/openclaw.json。

{
  browser: {
    enabled: true,                    // 总开关
    // cdpUrl: "http://127.0.0.1:18792", // 旧版覆盖
    remoteCdpTimeoutMs: 1500,         // 远程 CDP 检查超时
    remoteCdpHandshakeTimeoutMs: 3000,
    defaultProfile: "chrome",         // 更改为 "openclaw" 以隔离
    color: "#FF4500",                 // UI 色调颜色
    headless: false,                  // 对于后台操作设置为 true
    noSandbox: false,
    attachOnly: false,                // "true" = 从不启动，仅附加
    executablePath: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
    profiles: {
      openclaw: { cdpPort: 18800, color: "#FF4500" },
      work: { cdpPort: 18801, color: "#0066CC" },
      remote: { cdpUrl: "http://10.0.0.42:9222", color: "#00AA00" }
    }
  }
}

如果你的 系统默认 浏览器是基于 Chromium 的，OpenClaw 会自动使用它。如果需要，你可以强制使用特定的浏览器可执行文件。

openclaw config set browser.executablePath "/usr/bin/google-chrome"

{
  browser: {
    executablePath: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
  }
}

{
  browser: {
    executablePath: "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
  }
}

{
  browser: {
    executablePath: "/usr/bin/brave-browser"
  }
}

OpenClaw 支持灵活的部署模型：

1. 本地控制（默认）：网关本地运行，本地启动浏览器。
2. 远程控制（节点主机）：网关在其他地方运行，但使用你机器上的“节点主机”来控制浏览器。
3. 远程 CDP：网关直接连接到远程调试器（例如，Docker 容器中的浏览器或其他服务器）。

你可以使用 CDP URL 连接到远程浏览器实例。

• 查询令牌：https://provider.example?token=<token>
• 基本认证：https://user:pass@provider.example

Browserless 提供托管的 Chromium 服务，非常适合无服务器部署或不想管理本地浏览器资源的情况。

{
  browser: {
    enabled: true,
    defaultProfile: "browserless",
    profiles: {
      browserless: {
        cdpUrl: "https://production-sfo.browserless.io?token=<BROWSERLESS_API_KEY>",
        color: "#00AA00"
      }
    }
  }
}

使用 Chrome 扩展驱动你的 现有 Chrome 标签页（带有你的登录会话）。

1. 安装扩展 在“开发者模式”下加载扩展。

   openclaw browser extension install

   导航到 chrome://extensions，启用开发者模式，并从提供的路径“加载已解压的扩展程序”。

2. 附加到标签页 点击你要控制的标签页上的 OpenClaw 图标。徽章将显示 ON。

3. 通过代理控制 代理现在可以使用 chrome 配置文件与该标签页交互。

   openclaw browser --browser-profile chrome tabs

有关完整指南，请参阅 Chrome 扩展。

常见问题及其解决方法。

有关完整的命令列表，请参阅 浏览器 CLI 参考。