OpenClaw 是一款开源的本地 AI 智能体框架,其浏览器控制功能让 AI 能够真正"看见"并"操作"网页——点击、输入、截图、抓取内容,一气呵成。本文将介绍 Windows 环境下控制浏览器的主要方式及详细操作流程。

🗺️ 总览:OpenClaw 支持的浏览器控制方式

方式适用场景是否需要扩展浏览器是否隔离
方式一:托管浏览器(openclaw profile)自动化任务、完全隔离环境❌ 不需要✅ 独立实例
方式二:扩展中继(Extension Relay)操作已登录页面、现有标签页✅ 需要❌ 共用现有 Chrome
方式三:远程 CDP 接入远程服务器/云端浏览器❌ 不需要视情况而定
方式四:Browserless 云端托管无本地浏览器、轻量服务器❌ 不需要✅ 云端隔离

前置准备

在开始前,请确保已完成 OpenClaw 的基础安装:

npm install -g openclaw
openclaw init
openclaw gateway start
Windows 用户注意事项:
· 推荐使用 PowerShell 或 Windows Terminal
· Node.js 版本需 ≥ v18(推荐 v20+)
· 若遇到权限问题,以管理员身份运行终端

方式一:托管浏览器(openclaw profile)

💡 原理
OpenClaw 启动一个与你日常浏览器完全隔离的独立 Chrome/Edge 实例,有专属用户数据目录和 CDP 端口,互不干扰。
📋 适用场景
· 全自动网页任务(填表、爬取数据、批量操作)
· 不需要已登录状态
· 不想让 AI 操作到你个人的浏览器数据
🔧 配置步骤

第一步:启用浏览器功能

编辑配置文件 C:\Users\你的用户名.openclaw\openclaw.json:
{
“browser”: {
“enabled”: true,
“defaultProfile”: “openclaw”,
“headless”: false,
“profiles”: {
“openclaw”: { “cdpPort”: 18800, “color”: “#FF4500” }
}
}
}
第二步:指定浏览器路径(可选)

OpenClaw 会自动检测 Chrome/Edge,也可手动指定:
{
“browser”: {
“executablePath”: “C:\Program Files\Google\Chrome\Application\chrome.exe”
}
}
常见 Windows 路径参考:
· Chrome:C:\Program Files\Google\Chrome\Application\chrome.exe
· Edge:C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe
· Brave:C:\Program Files\BraveSoftware\Brave-Browser\Application\brave.exe
第三步:启动托管浏览器

查看状态
openclaw browser --browser-profile openclaw status

启动托管浏览器
openclaw browser --browser-profile openclaw start

打开网页
openclaw browser --browser-profile openclaw open https://www.baidu.com

截图查看当前状态
openclaw browser --browser-profile openclaw snapshot
第四步:通过对话控制

启动 Gateway 后,直接用自然语言指挥 AI:

打开百度,搜索"OpenClaw 教程",截图给我看看

方式二:扩展中继(Extension Relay / Chrome 扩展模式)

💡 原理
通过安装一个 Chrome 扩展,将你现有的 Chrome 标签页接入 OpenClaw 控制。AI 可以直接操作你已经登录的页面,无需重新登录。
📋 适用场景
· 操作需要登录的网站(微信读书、知乎、企业内网等)
· AI 辅助你正在浏览的页面
· 不想再开一个新浏览器实例

🔧 配置步骤

第一步:安装 OpenClaw 浏览器扩展
安装扩展(生成扩展文件)
openclaw browser extension install

查看扩展路径
openclaw browser extension path
记下输出的路径,例如:
C:\Users\你的用户名.openclaw\browser-extension
第二步:在 Chrome 中加载扩展

  1. 打开 Chrome,地址栏输入 chrome://extensions
  2. 右上角开启 “开发者模式”
  3. 点击 “加载已解压的扩展程序”
  4. 选择上一步输出的目录
  5. 将扩展图标 固定到工具栏(右键扩展图标 → 固定)

第三步:配置 OpenClaw 使用扩展中继模式
在 openclaw.json 中设置:

{
“browser”: {
“enabled”: true,
“defaultProfile”: “chrome”
}
}
重启 Gateway:

openclaw gateway restart
第四步:附加标签页

  1. 在 Chrome 中打开你想让 AI 操作的网页
  2. 点击工具栏中的 OpenClaw Browser Relay 图标
  3. 图标徽章变为 “ON” 即代表已成功附加
徽章状态含义
ON✅ 已附加,AI 可以控制该标签页
…⏳ 正在连接到本地中继
!❌ 中继不可达,检查 Gateway 是否运行

第五步:开始控制
帮我截图当前页面
滚动到页面底部
点击"登录"按钮

⚠️ 常见问题

问题:连接失败(徽章一直显示"!")
· 检查 Gateway 是否正在运行:openclaw gateway status
· 确认端口未被防火墙屏蔽(默认端口:18792)
问题:截图报错 “tab not found”

多个标签页同时附加会冲突,解决方案:
· 一次只附加一个标签页——在旧标签页点击扩展图标关闭 OFF,再在目标标签页开启 ON
问题:Gateway 在远程服务器上,浏览器在本地 Windows

需要建立 SSH 隧道:
在 Windows 中执行(PowerShell 或 cmd)
ssh -L 18792:127.0.0.1:18792 root@服务器IP
保持该窗口不关闭,即可正常使用扩展中继。

方式三:远程 CDP 接入

💡 原理
通过 Chrome DevTools Protocol(CDP),让 OpenClaw 接管一个已经用 --remote-debugging-port 参数启动的浏览器实例,适合远程服务器或局域网浏览器的控制。
📋 适用场景
· Gateway 在服务器,浏览器在另一台机器
· 需要控制局域网中某台电脑的浏览器
· 精细化的多浏览器配置

🔧 配置步骤

第一步:以调试模式启动浏览器

在 Windows 中创建 Chrome 快捷方式,或在命令行运行:
“C:\Program Files\Google\Chrome\Application\chrome.exe” --remote-debugging-port=9222 --user-data-dir=“C:\chrome-debug-profile”
第二步:配置 OpenClaw 连接远程 CDP

在 openclaw.json 中添加远程配置文件:
{
“browser”: {
“enabled”: true,
“defaultProfile”: “remote”,
“profiles”: {
“remote”: {
“cdpUrl”: “http://127.0.0.1:9222”,
“color”: “#00AA00”
}
}
}
}
如果是局域网中的另一台机器:

{
“browser”: {
“profiles”: {
“remote”: {
“cdpUrl”: “http://192.168.1.100:9222”,
“color”: “#00AA00”
}
}
}
}
第三步:验证连接

openclaw browser --browser-profile remote status
返回 cdpReady: true 即连接成功。

方式四:Browserless 云端托管
💡 原理
通过 Browserless.io 等云端 Chromium 服务,无需本地安装浏览器,适合服务器资源有限的场景。
📋 适用场景
· 低配置 Windows 服务器
· 需要多个并发浏览器实例
· 完全云端自动化流水线
🔧 配置步骤

第一步:注册 Browserless 账号

前往 browserless.io 注册,获取 API Key。
第二步:配置 OpenClaw

{
“browser”: {
“enabled”: true,
“defaultProfile”: “browserless”,
“remoteCdpTimeoutMs”: 2000,
“remoteCdpHandshakeTimeoutMs”: 4000,
“profiles”: {
“browserless”: {
“cdpUrl”: “https://production-sfo.browserless.io?token=你的API_KEY”,
“color”: “#00AA00”
}
}
}
}
第三步:重启并验证

openclaw gateway restart
openclaw browser --browser-profile browserless status

🔀 多配置文件并行使用

OpenClaw 支持同时定义多个浏览器配置文件,按需切换:
{
“browser”: {
“defaultProfile”: “openclaw”,
“profiles”: {
“openclaw”: { “cdpPort”: 18800, “color”: “#FF4500” },
“work”: { “cdpPort”: 18801, “color”: “#0066CC” },
“remote”: { “cdpUrl”: “http://192.168.1.100:9222”, “color”: “#00AA00” }
}
}
}
在使用时通过 --browser-profile 参数指定:

openclaw browser --browser-profile work open https://内网系统.example.com
openclaw browser --browser-profile openclaw open https://baidu.com

📊 方式对比与选择建议

需求推荐方式
全自动批量任务,无需登录方式一:托管浏览器
操作我已登录的页面方式二:扩展中继
控制另一台电脑的浏览器方式三:远程 CDP
服务器性能不足、需要云端浏览器方式四:Browserless

🛡️ 安全建议

  1. 浏览器控制服务默认只监听 loopback(127.0.0.1),不会暴露到公网
  2. 远程 CDP URL 中的 Token 建议通过环境变量保存,而不是直接写在配置文件中
  3. 如需远程访问,使用 SSH 隧道 或 Tailscale 等私有网络方案,避免直接暴露端口
  4. 定期更新 OpenClaw 到最新版本:npm install -g openclaw@latest

🎉 总结

OpenClaw 在 Windows 上提供了灵活多样的浏览器控制方案:从本地隔离的托管浏览器,到接管现有页面的扩展中继,再到远程 CDP 和云端托管,基本覆盖了所有使用场景。根据你的实际需求选择合适的方式,就能让 AI 真正帮你"动手"操作浏览器,解放双手!🦾

Logo

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。

更多推荐