Browser (OpenClaw-managed)

原文: https://docs.openclaw.ai/tools/browser.md 翻译日期: 2026-03-14

OpenClaw 可以运行一个专用的 Chrome/Brave/Edge/Chromium 配置文件，由代理控制。它与你的个人浏览器隔离，通过 Gateway 内的小型本地控制服务管理。

入门

把它想象成一个单独的、代理专用的浏览器。openclaw 配置文件不接触你的个人浏览器配置文件。代理可以打开标签页、读取页面、点击和输入在安全的车道上。

你得到的

一个名为 openclaw 的独立浏览器配置文件（默认橙色）
确定性标签控制（列表/打开/聚焦/关闭）
代理操作（点击/类型/拖动/选择）、快照、截图、PDF
可选的多配置文件支持

快速开始

openclaw browser --browser-profile openclaw status
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

配置文件：`openclaw` vs `user` vs `chrome-relay`

openclaw: 托管的、隔离的浏览器（不需要扩展）
user: 内置 Chrome MCP 附加配置文件，用于你的真实登录的 Chrome 会话
chrome-relay: 扩展中继到你的系统浏览器（需要 OpenClaw 扩展附加到标签页）

配置

浏览器设置在 ~/.openclaw/openclaw.json 中：

{
  browser: {
    enabled: true, // 默认: true
    ssrfPolicy: {
      dangerouslyAllowPrivateNetwork: true, // 默认信任网络模式
    },
    remoteCdpTimeoutMs: 1500,
    defaultProfile: "openclaw",
    color: "#FF4500",
    headless: false,
    noSandbox: false,
    profiles: {
      openclaw: { cdpPort: 18800, color: "#FF4500" },
      user: {
        driver: "existing-session",
        attachOnly: true,
        color: "#00AA00",
      },
      chrome-relay: {
        driver: "extension",
        cdpUrl: "http://127.0.0.1:18792",
        color: "#00AA00",
      },
    },
  },
}

本地 vs 远程控制

本地控制（默认）：Gateway 启动循环控制服务并可以启动本地浏览器
远程控制（节点主机）：在有浏览器的机器上运行节点主机；Gateway 将浏览器操作代理到它
远程 CDP：设置 browser.profiles.<name>.cdpUrl 附加到远程 Chromium 浏览器

Browserless

Browserless 是一个托管的 Chromium 服务，通过 HTTPS 暴露 CDP 端点。

示例：

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

Browserbase

Browserbase 是一个云平台，运行带有内置 CAPTCHA 解决、隐形模式和住宅代理的无头浏览器。

{
  browser: {
    enabled: true,
    defaultProfile: "browserbase",
    profiles: {
      browserbase: {
        cdpUrl: "wss://connect.browserbase.com?apiKey=<BROWSERBASE_API_KEY>",
        color: "#F97316",
      },
    },
  },
}

Chrome 扩展中继

OpenClaw 还可以通过本地 CDP 中继 + Chrome 扩展驱动你现有的 Chrome 标签页。

流程： 1. 安装扩展 2. 在要控制的标签页上点击 OpenClaw Browser Relay 扩展图标 3. 使用 browser 工具，指定 profile="chrome-relay"

安全

浏览器控制仅限循环访问；通过 Gateway 的认证或节点配对进行访问
如果未配置认证，OpenClaw 在启动时自动生成 gateway.auth.token
保持 Gateway 和任何节点主机在私有网络上（Tailscale）

多浏览器

OpenClaw 支持多个命名配置文件（路由配置）： - openclaw-managed: 专用 Chromium 实例，有自己的用户数据目录 + CDP 端口 - remote: 明确 CDP URL（在别处运行的 Chromium 浏览器） - extension relay: 通过本地中继 + Chrome 扩展的你现有 Chrome 标签页 - existing session: 通过 Chrome DevTools MCP 你现有的 Chrome 配置文件

入门