OpenClaw 不仅可以启动一个独立浏览器（openclaw 模式），还支持通过 Chrome 扩展直接控制你当前正在使用的浏览器标签页。这种方式被称为浏览器中继（Chrome Extension Relay），核心优势是不需要启动额外浏览器，可以直接操作现有 Chrome 页面，且支持 AI 自动化控制真实用户环境。那么如何控制你正在使用的Chrome浏览器，站长百科将在下文详细分享。
一、OpenClaw Chrome扩展工作原理
Chrome 扩展模式由三个核心组件组成：
- 浏览器控制服务（Gateway / Node）
- 负责接收 AI 或 CLI 的操作指令
- 本地中继服务器（CDP Relay）
默认地址：
http://127.0.0.1:18792
作用：在扩展和 OpenClaw 之间转发 Chrome DevTools 协议（CDP）消息
Chrome 扩展（MV3）
使用 chrome.debugger API：
- 连接当前标签页
- 转发控制指令
- 接收浏览器数据
总结一句话：扩展 = 把你的 Chrome 标签页“接入”OpenClaw 控制系统
二、安装Chrome扩展
第一步：安装扩展文件
openclaw browser extension install
第二步：获取扩展路径
openclaw browser extension path
第三步：在 Chrome 中加载
打开：
chrome://extensions
- 开启【开发者模式】
- 点击【加载已解压的扩展程序】
- 选择上一步输出的目录
- 将扩展固定到工具栏
三、首次使用配置（非常关键）
打开扩展的设置页面，配置以下内容：
必填项
- Port（端口）：默认 18792
- Gateway Token：必须填写
- Token 来源：gateway.auth.token
- 或环境变量 OPENCLAW_GATEWAY_TOKEN
四、如何使用（连接 / 断开）
连接步骤：
- 打开一个网页（你想控制的页面）
- 点击 Chrome 工具栏中的扩展图标
图标显示：ON = 已连接
断开：再次点击扩展图标即可。
五、控制哪个标签页？
非常重要：OpenClaw 不会自动控制当前标签页
它只控制：你点击扩展按钮连接的那个标签页
切换控制页面：
- 打开新标签页
- 点击扩展图标
- 新页面被接管
六、如何在CLI/Agent中使用？
使用 chrome 配置文件：
openclaw browser –browser-profile chrome tabs
或在智能体中：
browser(profile=”chrome”)
七、自定义配置文件（可选）
如果你想自定义名称或端口：
openclaw browser create-profile \
–name my-chrome \
–driver extension \
–cdp-url http://127.0.0.1:18792 \
–color “#00AA00”
八、自定义Gateway端口
如果你修改了 Gateway 端口：
gateway.port: 19001
那么：
扩展中继端口 = Gateway + 3 = 19004
你需要在扩展中同步修改端口。
九、状态图标说明（常见问题）
| 图标 | 含义 |
| ON | 已连接 |
| … | 正在连接 |
| ! | 出错 |
如果出现 !：
常见原因：
- Gateway 未运行
- Token 错误或未填写
- 中继服务不可达
解决方法：
- 确保 Gateway 正常运行
- 检查 Token 是否正确
- 打开扩展设置重新验证
十、本地vs远程使用
1、本地模式（推荐）
- Gateway 与 Chrome 在同一台机器
- 自动启动中继
- 无需额外配置
2、远程 Gateway（进阶）
- 如果 Gateway 在远程服务器：
- 需要在本机运行 Node Host
作用：
将浏览器控制代理回本地
十一、沙箱模式注意事项
如果你使用的是沙箱代理：
默认行为：浏览器工具可能无法控制本机 Chrome
解决方案：
方案一（推荐）
使用非沙箱模式
方案二（允许控制宿主浏览器）
{
“agents”: {
“defaults”: {
“sandbox”: {
“browser”: {
“allowHostControl”: true
}
}
}
}
}
并在调用时使用：
target=”host”
十二、安全说明（必须了解）
Chrome 扩展模式 ≠ 隔离环境
当扩展连接后，OpenClaw 可以：
- 点击页面
- 输入内容
- 读取页面数据
- 访问已登录状态
这意味着：它拥有该标签页的完整权限
风险点
- 可访问你的账号登录状态
- 可操作敏感页面
- 不同于 openclaw 隔离浏览器
十三、安全建议（强烈推荐）
- 使用独立 Chrome 用户配置（Profile）
- 不要使用日常浏览器登录重要账号
- Gateway 不要暴露公网
- 使用 Token 认证
- 不要开放中继端口（127.0.0.1 限制）
十四、远程访问建议
- 使用私有网络（如 Tailscale）
- 禁止公网访问 CDP 端口
- 控制节点授权
十五、扩展更新方法
升级 OpenClaw 后：
openclaw browser extension install
然后在 Chrome 扩展页面点击【重新加载】。
十六、extension path 原理
openclaw browser extension path
返回：扩展的实际安装目录（非 node_modules）
说明：
- OpenClaw 会复制扩展到稳定目录
- 如果删除该目录，扩展会失效
