OpenClaw 浏览器配置：多 Profile、远程 CDP 与安全策略

启用浏览器

在 openclaw.json 中配置浏览器：

{
  browser: {
    enabled: true,
    evaluateEnabled: true,
    defaultProfile: "user"
  }
}

enabled：启用浏览器工具
evaluateEnabled：允许 act:evaluate 和 wait 函数
defaultProfile：默认使用的浏览器 Profile

多 Profile 配置

可以定义多个浏览器 Profile，用于不同场景：

{
  browser: {
    profiles: {
      openclaw: {
        cdpPort: 18800,
        color: "#FF4500"
      },
      remote: {
        cdpUrl: "http://10.0.0.42:9222"
      },
      brave: {
        driver: "existing-session",
        userDataDir: "~/Library/Application Support/BraveSoftware/Brave-Browser"
      }
    }
  }
}

Profile 类型

类型	配置方式	适用场景
本地 CDP	`cdpPort`	OpenClaw 自动启动的浏览器实例
远程 CDP	`cdpUrl`	连接远程服务器上的浏览器
已有会话	`driver: "existing-session"`	附加到已运行的浏览器（使用 Chrome MCP）

SSRF 安全策略

控制浏览器是否可以访问私有网络：

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

dangerouslyAllowPrivateNetwork：默认 true（信任模式），设为 false 限制只访问公网
hostnameAllowlist：允许访问的域名列表，支持通配符
远程 CDP 端点同样受此策略约束