Chrome 中继浏览器控制

通过 OpenClaw Browser Relay 扩展控制用户本地的 Chrome 浏览器。该功能可访问用户真实登录状态下的浏览器会话。

初始化设置（首次使用）

若用户尚未安装 Browser Relay 扩展：

1. 获取扩展路径：

   ~/.openclaw/browser/chrome-extension
   

   或运行：open ~/.openclaw/browser/chrome-extension（macOS）

2. 在 Chrome 中安装扩展：

   • 打开 chrome://extensions
   • 启用右上角的“开发者模式”
   • 点击“加载已解压的扩展程序”
   • 选择该扩展所在文件夹

3. 获取网关令牌（Gateway token）：

   openclaw config get gateway.auth.token
   

4. 配置扩展：

   • 点击扩展图标 → 进入 Settings（设置）
   • 输入网关令牌
   • 保存

5. 建立连接：

   • 打开你希望被控制的 Chrome 标签页
   • 点击扩展图标进行绑定（图标徽章显示为 ON）

使用方法

查看已连接的标签页

openclaw browser tabs --profile chrome-relay

或使用工具命令：

browser(action=tabs, profile=chrome-relay)

读取页面内容

browser(action=snapshot, profile=chrome-relay, targetId=)

导航跳转

browser(action=navigate, profile=chrome-relay, targetId=, url="https://...")

与页面交互

注意： 在 chrome-relay 模式下，基于 aria-ref 的选择器可能存在可靠性问题。对于复杂交互，请优先使用 JavaScript 执行方式：

// 点击元素
browser(action=act, kind=evaluate, profile=chrome-relay, 
  fn="document.querySelector('selector').click()")

// 向输入框中输入文本
browser(action=act, kind=evaluate, profile=chrome-relay, 
  fn="document.querySelector('input').value = 'text'")

// 获取元素文本内容
browser(action=act, kind=evaluate, profile=chrome-relay, 
  fn="document.querySelector('selector').innerText")

限制条件

• aria-ref 选择器可能超时；请改用 JavaScript evaluate 方式
• 每个标签页均需手动绑定扩展（图标徽章显示为 ON）
• 仅支持 Chrome 浏览器
• 连接端口：18792

故障排查

扩展图标显示红色 ! 徽章：

• 网关未运行 → 使用 openclaw gateway start 启动
• 令牌不匹配 → 检查扩展设置中的令牌是否正确

无法定位元素：

• 页面可能已加载新的 DOM → 重新执行 snapshot
• 建议先使用浏览器开发者工具控制台验证选择器有效性