OpenClaw 中所有浏览器控制方法总览

OpenClaw 当前支持的浏览器控制方式本质可以分为 3种架构路径Remote CDP直接协议控制Managed Browser托管浏览器Existing-session via Chrome DevTools MCP会话接管它们的核心区别在于控制的是“新浏览器”还是“已有浏览器”以及“是否通过 CDP 直连”。 一、Remote CDP直接控制浏览器✅ 本质通过 Chrome DevTools ProtocolCDP直接连接浏览器实例进行控制。 控制方式OpenClaw → CDP WebSocket → Chrome 特点直接连接浏览器调试端口可控制 tab、DOM、网络、JS 执行等底层能力支持 attach 已有 tab 或创建新 tab不依赖 MCP 或扩展 使用方式需要启动浏览器时开启 remote debuggingC:\Program Files\Google\Chrome\Application\chrome.exe --remote-debugging-port9222 --user-data-dirC:\openclaw-profilemac 电脑/Applications/Google Chrome.app/Contents/MacOS/Google Chrome --remote-debugging-port9223 --user-data-dir$HOME/openclaw-profile运行下面命令去验证http://localhost:9222/json然后 OpenClaw 连接browser: { defaultProfile: remote, profiles: { remote: { cdpUrl: http://localhost:9223, attachOnly: true, color: #0066CC } } }✅ 适用场景自动化测试爬虫AI Agent 控制浏览器需要最高控制粒度的场景⚙️ 二、Managed Browser托管浏览器✅ 本质由 OpenClaw 自动启动并管理一个 Chromium 浏览器实例。 控制方式OpenClaw → 启动 Chromium → CDP → 控制浏览器 特点自动启动浏览器自动管理 userDataDir自动建立 CDP 连接完全不依赖用户已有浏览器 使用方式openclaw browser --browser-profile openclaw start或openclaw browser --browser-profile openclaw open https://example.com修改~/.openclaw/openclaw.jsonbrowser: { defaultProfile: openclaw, profiles: { openclaw: { cdpPort: 18800, color: #FF4500 } } }✅ 适用场景本地开发自动化任务执行不需要登录态的 Agent快速测试环境 三、Existing-session via Chrome DevTools MCP会话接管✅ 本质通过 Chrome DevTools MCP server 接管一个已经打开的浏览器实例。属于 CDP 的一层工具化封装Model Context Protocol。 控制方式OpenClaw → MCP Server → CDP → Existing Chrome Session 特点不启动新浏览器复用已有 tabs保留登录态需要用户确认 attach通过 MCP 将 CDP 转换为 tool 接口Common inspect pages:Chrome:chrome://inspect/#remote-debuggingBrave:brave://inspect/#remote-debuggingEdge:edge://inspect/#remote-debuggingbrowser: { defaultProfile: user, profiles: { user: { driver: existing-session, attachOnly: true, color: #00AA00 } } },示例检查命令openclaw browser --browser-profile user status openclaw browser --browser-profile user tabs运行openclaw browser status 会发现下面提示C:\Users\Harryopenclaw browser status OpenClaw 2026.3.24 (cff6dc9) — Im not saying your workflow is chaotic... Im just bringing a linter and a helmet. | o profile: user enabled: true running: true transport: chrome-mcp browser: unknown detectedBrowser: chrome detectedPath: C:\Program Files\Google\Chrome\Application\chrome.exe profileColor: #00AA00⚠️ 限制必须开启 remote debuggingChromium 版本需较新144必须手动授权 attach依赖 MCP server✅ 适用场景AI Agent 工具调用系统复用真实用户环境需要登录态的自动化多 tab 协同操作⚖️ 五、四种方式本质对比统一视角维度Remote CDPManaged BrowserMCP Existing-session控制协议CDPCDPCDPvia MCP是否新建浏览器否✅ 是否是否复用已有浏览器⚠️ 可 attach❌✅是否需要扩展❌❌❌是否需要 MCP❌❌✅是否需要用户确认❌❌✅控制粒度⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐登录态支持⚠️❌✅ 六、如何统一理解 OpenClaw 的控制体系可以从三个“控制层级”来理解 1. 协议层CDPRemote CDPManaged BrowserMCP底层仍是 CDP 这是最核心、能力最强的一层 2. 会话层SessionManaged Browser新 sessionMCP Existing-session复用 sessionRemote CDP attach半复用 决定是否复用浏览器状态 3. 交互层UI / DOMExtension Relay 更偏“页面操作”不是浏览器内核控制 七、选型总结一句话版要最强控制能力 Remote CDP要自动化环境 Managed Browser要 AI Agent 工具化接管真实浏览器 MCP Existing-session✅ 最终总结OpenClaw 并不是提供单一“浏览器控制方式”而是提供了一整套覆盖不同场景的控制体系CDP 是底层能力MCP 是工具封装Managed 是环境托管。这三种方式分别解决“控制谁”新浏览器 or 已有浏览器“怎么控制”CDP / 扩展 / MCP“在哪控制”本地 / 用户浏览器 / 托管环境参考资料https://docs.openclaw.ai/tools/browser其它完整的browser 的配置browser: { defaultProfile: chrome, profiles: { remote: { cdpUrl: http://localhost:9223, attachOnly: true, color: #0066CC }, openclaw: { cdpPort: 18800, color: #FF4500 }, user: { driver: existing-session, attachOnly: true, userDataDir: ~/Library/Application Support/BraveSoftware/Brave-Browser, color: #00AA00 } } },可访问的浏览器的白名单browser: { ssrfPolicy: { dangerouslyAllowPrivateNetwork: true, hostnameAllowlist: [www.google.com] } },