OpenClaw 浏览器能力调研（基于官方文档）

来源：https://docs.openclaw.ai/zh-CN/tools/browser （官方文档中文版）
调研时间：2026-08-01

核心结论（先看这个）

✅ 可以控制已有浏览器，但默认不这么做。

问题	答案
OpenClaw 有浏览器能力吗？	有，内置 `browser` 工具 + `browser-automation` Skill
默认控制什么浏览器？	独立的、隔离的 `openclaw` 配置文件（自动启动一个专用 Chrome/Brave/Edge）
能控制我正在用的浏览器吗？	能，两种方式：`user` 配置文件（DevTools MCP）或 `chrome` 配置文件（浏览器扩展）
会碰我的个人浏览器数据吗？	默认不会（专用用户数据目录，绝不访问个人配置文件）

一、三种浏览器配置文件模式

OpenClaw 的浏览器控制核心是**配置文件（profile）**概念，三种模式对应不同场景：

1. `openclaw`（默认，托管且隔离）

自动启动一个专用浏览器实例（橙色强调色区分）
专用用户数据目录，绝不接触个人浏览器配置文件
支持：标签页控制、点击/输入/拖动、快照、截图、PDF、下载管理
用途：智能体自动化、验证、跑脚本

2. `user`（Chrome DevTools MCP 连接真实浏览器）⭐ 你要的

通过 Chrome DevTools MCP 连接到你真实的、已登录的 Chrome 会话
⚠️ 限制：首次连接时 Chrome 会弹出阻塞式 “Allow remote debugging?” 提示，必须有人在电脑旁批准
优点：用你自己的登录态（Cookie 都在），不需要重新登录
配置：driver: "existing-session" + defaultProfile: "user"

3. `chrome`（Chrome 扩展连接真实浏览器）⭐ 无人值守首选

通过 OpenClaw Chrome 扩展驱动你真实的、已登录的 Chrome
✅ 无需人在电脑旁（不依赖远程调试端口，没有弹窗提示），可通过手机（Telegram/WhatsApp）远程调用
优点：保留登录会话 + 无人值守也能用
这是唯一能在电脑旁无人时工作的”已登录浏览器”模式

补充：attachOnly / 远程 CDP

attachOnly: true：绝不启动本地浏览器，只附加到已有浏览器
远程 CDP：设置 browser.profiles.<name>.cdpUrl 附加到远程 Chromium（如 Browserless 托管服务）
节点主机：浏览器在另一台电脑上，Gateway 代理调用

二、能不能控制”我正在使用的浏览器”？——详细回答

可以，但要知道代价和前提：

方式	用我的登录态？	需要人在电脑旁？	配置
默认 `openclaw`	❌ 全新隔离环境	❌ 不需要	无需配置
`user`（DevTools MCP）	✅ 用真实 Chrome 会话	✅ 首次要批准弹窗	`browser.defaultProfile: "user"`
`chrome`（扩展）	✅ 用真实 Chrome 会话	❌ 不需要（手机可远程）	安装 Chrome 扩展
macOS 专用	✅ 复制系统浏览器 Cookie 到隔离配置	❌ 不需要	`openclaw browser` CLI 导入命令

最佳实践（官方建议）：

需要现有登录会话 + 人在电脑旁 → 用 user（DevTools MCP）
需要现有登录会话 + 人不在电脑旁（Telegram/WhatsApp 远程）→ 用 chrome（扩展）
不需要登录态、纯自动化 → 用默认 openclaw

三、能力清单

智能体工具（一个 `browser` 工具）

子命令	功能
`browser doctor/status`	检查网关、插件、配置文件、浏览器就绪状态
`browser start/stop`	启动/停止浏览器（支持 headless 无头）
`browser tabs`	列出/打开/聚焦/关闭标签页（确定性 tabId）
`browser snapshot`	返回稳定 UI 树（AI 或 ARIA），用 ref ID 操作
`browser act`	点击/输入/拖动/选择/滚动/按键/填表
`browser screenshot`	截像素图（整页/元素/带标签引用）
`browser navigate/open`	导航到 URL
`browser dialog`	处理模态对话框（accept/dismiss）
`browser wait`	等待 URL 匹配等

特殊能力

PDF 导出（仅托管模式）
下载拦截与管理（托管下载目录，返回 {url, suggestedFilename, path} 元数据）
响应体读取（responsebody，仅托管模式）
快照视觉理解：主模型不支持视觉时，自动用图像模型把截图转成文本描述
SSRF 防护：导航前预检，拦截被策略拒绝的请求（安全默认）

自动化 Skill

内置 browser-automation Skill：状态检查 → 标签页加标签 → 操作前快照 → 变化后重快照 → 过期引用恢复 → 登录/验证码/摄像头阻塞报告为手动操作（不瞎猜）

四、关键配置项（~/.openclaw/openclaw.json）

{
  "browser": {
    "enabled": true,                    // 总开关
    "defaultProfile": "openclaw",       // 默认 openclaw；想用真实浏览器改 "user"
    "headless": false,                  // 是否无头模式
    "executablePath": "C:\\...\\chrome.exe",  // 覆盖浏览器路径
    "profiles": {
      "openclaw": { "color": "orange" },       // 隔离配置
      "user": { "driver": "existing-session" } // 连接真实 Chrome
      // "chrome": { "driver": "extension" }   // 扩展模式
    }
  }
}

注意

改配置后需重启 Gateway 网关
插件启用条件：plugins.entries.browser.enabled=true 且 browser.enabled=true
智能体要能用：agents.list[].tools.alsoAllow: ["browser"]

五、局限性（诚实说明）

限制	说明
默认隔离	不是你的日常浏览器，登录态要重新配（除非用 user/chrome 模式）
`user` 模式首次弹窗	DevTools MCP 连接必须有人批准一次
仅托管模式的功能	PDF、下载拦截、responsebody 需要托管浏览器路径
手机端	手机上能远程控制（扩展模式），但体验不如桌面
Linux 无界面	无 DISPLAY 时自动无头，需显式配置才有界面
性能	Raspberry Pi/低端 VPS 上 Chrome 启动慢，需调大超时

六、与 Hermes 浏览器能力对比（顺带）

对比项	OpenClaw	Hermes Agent（我）
默认浏览器	隔离的专用 Chrome	隔离的 agent-browser 会话
控制真实浏览器	✅ user/chrome 两种模式	⚠️ computer_use 可后台驱动桌面（含浏览器窗口）
登录态复用	user/chrome 模式可复用	computer_use 可操作已登录窗口
无人值守	✅ 扩展模式	桌面后台操作需要会话在跑
远程触发	✅ Telegram/WhatsApp	有 gateway 渠道