Appearance
OpenClaw 浏览器控制完全指南：让 AI 真正"看见"网页
你有没有遇到过这种情况：给 AI 助手一个网页，让它帮你填写信息，结果 AI 说"我看不见网页内容，无法操作"？这是 AI 工具的经典痛点——它们能处理文字，但看不见你屏幕上的网页。OpenClaw 最新版本彻底解决了这个问题。
OpenClaw GitHub: https://github.com/OpenClawAI/openclaw
OpenClaw 可以像真人一样控制你的浏览器：打开网页、点击按钮、填写表单、截取截图。而且完全隔离，不影响你正在用的 Chrome。
一、它是怎么工作的？
OpenClaw 会在你的电脑上启动一个独立的浏览器实例——这个浏览器归 AI 使用，和你日常刷网页的 Chrome 完全分开。
工作原理：
AI 指令 → OpenClaw Gateway → 控制服务 → Chrome/Brave/Edge（独立 Profile）底层依赖 Chrome DevTools Protocol（CDP）协议，配合 Playwright 实现高级操作（点击、填表、截图、PDF 导出等）。
关键点：你的个人浏览器数据完全隔离，AI 用的不是你平时登录的那个 Chrome。
二、快速上手（5 分钟搞定）
第一步：确认浏览器功能已开启
bash
openclaw browser --browser-profile openclaw status如果看到 "running": false，启动它：
bash
openclaw browser --browser-profile openclaw start打开一个网页试试：
bash
openclaw browser --browser-profile openclaw open https://www.baidu.com截个图：
bash
openclaw browser screenshot能执行这些命令，说明基础配置已经完成。
第二步：让 AI 帮你操控
在 OpenClaw 对话中，AI 可以直接使用 browser 工具：
| 命令 | 说明 |
|---|---|
browser snapshot | 拍下当前页面结构（带可点击区域编号） |
browser click 12 | 点击编号为 12 的区域 |
browser type 23 "你好" | 在编号 23 的输入框里打字 |
browser screenshot | 截当前页面图 |
AI 会先"快照"页面，然后告诉你它看到了什么、接下来要做什么，整个过程透明可控。
三、Profiles：同时管理多个浏览器
OpenClaw 支持多 profiles，等于同时管理多个独立浏览器实例。
默认内置 Profiles
| Profile | 类型 | 说明 |
|---|---|---|
| openclaw | 独立管理 | AI 专用，完全隔离 |
| user | 现有会话 | 复用你已登录的 Chrome（通过 Chrome DevTools MCP） |
配置多个 Profiles
在 ~/.openclaw/openclaw.json 中配置：
json
{
"browser": {
"enabled": true,
"defaultProfile": "openclaw",
"profiles": {
"openclaw": {
"cdpPort": 18800,
"color": "#FF4500"
},
"work": {
"cdpPort": 18801,
"color": "#0066CC"
},
"brave": {
"driver": "existing-session",
"attachOnly": true,
"userDataDir": "~/Library/Application Support/BraveSoftware/Brave-Browser",
"color": "#FB542B"
},
"remote": {
"cdpUrl": "http://10.0.0.42:9222",
"color": "#00AA00"
}
}
}
}每个 profile 有自己的：
| 配置项 | 说明 |
|---|---|
| CDP 端口 | 本地独立端口 |
| 颜色标识 | 方便识别是哪个浏览器 |
| 启动方式 | 本地启动 / 附加现有 / 远程 CDP |
切换浏览器 profile：
bash
openclaw browser --browser-profile work open https://gmail.com四、使用 Brave、Edge 或其他浏览器
OpenClaw 会按以下顺序自动检测系统默认浏览器：
| 优先级 | 浏览器 |
|---|---|
| 1 | Chrome |
| 2 | Brave |
| 3 | Edge |
| 4 | Chromium |
| 5 | Chrome Canary |
如果你的默认浏览器不是 Chromium 系列，可以通过 executablePath 强制指定：
macOS 指定 Brave：
json
{
"browser": {
"executablePath": "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser"
}
}Linux 指定 Chrome：
json
{
"browser": {
"executablePath": "/usr/bin/google-chrome"
}
}Windows 指定 Edge：
json
{
"browser": {
"executablePath": "C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe"
}
}五、复用你已登录的浏览器（user profile）
这是最实用的功能之一：AI 可以直接使用你已经登录了账号的 Chrome，操作你正在用的网页。
设置方法
第一步：打开 Chrome，在地址栏输入 chrome://inspect/#remote-debugging，勾选"启用远程调试"。
第二步：在配置文件中添加 existing-session profile：
json
{
"browser": {
"profiles": {
"mychrome": {
"driver": "existing-session",
"attachOnly": true,
"userDataDir": "~/Library/Application Support/Google/Chrome",
"color": "#4285F4"
}
}
}
}第三步：启动并验证
bash
openclaw browser --browser-profile mychrome status
openclaw browser --browser-profile mychrome tabstabs 命令能列出你 Chrome 里已打开的所有页面，说明连接成功。
注意事项
| 注意项 | 说明 |
|---|---|
| attachOnly: true | AI 不会启动新浏览器，只附加到已有浏览器 |
| 首次确认 | 首次附加时，Chrome 会弹出确认对话框，需要你在电脑前点击同意 |
| 权限更大 | 这个模式比独立 profile 权限更大（可以操作你的登录状态），建议仅在需要时开启 |
六、远程 CDP：控制其他机器上的浏览器
如果你想让 AI 控制另一台电脑上的浏览器，或者在服务器上运行浏览器，远程 CDP 是解决方案。
基本配置
json
{
"browser": {
"profiles": {
"remote": {
"cdpUrl": "http://10.0.0.42:9222",
"color": "#00AA00"
}
}
}
}带认证的远程 CDP
支持 Query Token 和 HTTP Basic Auth 两种方式：
json
{
"browser": {
"profiles": {
"browserless": {
"cdpUrl": "wss://production-sfo.browserless.io?token=你的TOKEN",
"color": "#00AA00"
}
}
}
}七、云端浏览器：Browserless 和 Browserbase
不想在本地跑浏览器？可以使用云端托管方案。
Browserless
Browserless 提供云端 Chromium，通过 WebSocket 直连：
json
{
"browser": {
"enabled": true,
"defaultProfile": "browserless",
"remoteCdpTimeoutMs": 2000,
"remoteCdpHandshakeTimeoutMs": 4000,
"profiles": {
"browserless": {
"cdpUrl": "wss://production-sfo.browserless.io?token=你的TOKEN",
"color": "#00AA00"
}
}
}
}Browserbase
Browserbase 是另一个云端浏览器平台，集成 CAPTCHA 解决、反检测、住宅代理：
json
{
"browser": {
"enabled": true,
"defaultProfile": "browserbase",
"remoteCdpTimeoutMs": 3000,
"remoteCdpHandshakeTimeoutMs": 6000,
"profiles": {
"browserbase": {
"cdpUrl": "wss://connect.browserbase.com?apiKey=你的APIKEY",
"color": "#6B46C1"
}
}
}
}八、高级命令速查表
浏览器生命周期
| 命令 | 说明 |
|---|---|
openclaw browser start | 启动浏览器 |
openclaw browser stop | 关闭浏览器 |
openclaw browser status | 查看运行状态 |
openclaw browser restart | 重启浏览器 |
页面操作
| 命令 | 说明 |
|---|---|
openclaw browser open <url> | 打开网页 |
openclaw browser tabs | 列出所有标签页 |
openclaw browser screenshot | 截图当前页面 |
openclaw browser pdf | 导出 PDF |
openclaw browser navigate_back | 后退 |
openclaw browser close | 关闭当前标签 |
高级操作
| 命令 | 说明 |
|---|---|
openclaw browser snapshot | 获取页面可交互元素列表 |
openclaw browser click <ref> | 点击指定元素 |
openclaw browser type <ref> "文本" | 输入文本 |
openclaw browser press_key Enter | 按键 |
openclaw browser evaluate "JS代码" | 执行 JavaScript |
openclaw browser console_messages | 获取控制台日志 |
openclaw browser network_requests | 获取网络请求 |
Profile 管理
| 命令 | 说明 |
|---|---|
openclaw browser --browser-profile <name> status | 查看指定 profile 状态 |
openclaw browser list_cdp_targets | 列出 CDP 目标 |
九、安全建议
| 建议 | 说明 |
|---|---|
| 默认使用 openclaw profile | 完全隔离，不会影响你的个人浏览器 |
| 谨慎使用 user profile | 涉及敏感账号时，优先用独立 profile |
| 限制远程 CDP 访问 | 远程 CDP 只在内网或 VPN 环境下开放 |
| 定期清理 cookies | AI 操作产生的登录状态，用完后建议清理 |
| 启用 headed 模式调试 | 开发阶段用 headed=true，能看到 AI 在干什么 |
十、常见问题
Q1：启动时报 "Chrome not found" 怎么办？
原因：系统没有安装 Chrome，或路径配置错误。
解决：安装 Chrome，或在配置文件中指定 executablePath。
Q2：远程 CDP 连接失败怎么办？
原因：目标机器的 Chrome 没有开启远程调试，或防火墙阻止了端口。
解决：
- 确认目标 Chrome 启动时带了
--remote-debugging-port=9222 - 检查防火墙是否开放 9222 端口
- 尝试用浏览器直接访问
http://目标IP:9222测试连通性
Q3：AI 操作太慢怎么办？
原因：可能是网络延迟，或云端浏览器响应慢。
解决：
- 优先使用本地浏览器
- 调整
remoteCdpTimeoutMs和remoteCdpHandshakeTimeoutMs参数 - 减少不必要的截图操作
Q4：如何让 AI 操作需要登录的网站？
方法一：使用 user profile（复用已登录的 Chrome）
方法二：在独立 profile 中手动登录一次，登录状态会保留
方法三：使用云端浏览器平台的持久化会话功能
总结
| 场景 | 推荐方案 |
|---|---|
| 独立任务（填问卷、爬数据） | openclaw profile |
| 已登录操作（查邮箱、处理订单） | user profile |
| 分布式/团队协作 | 远程 CDP 或云端浏览器 |
| 本地机器性能不足 | 云端浏览器（Browserless/Browserbase） |
选择 profile 的核心原则：隔离优先，便利次之。只有在必要时才复用已登录的浏览器。
