核心用法
OpenClaw Chrome Relay Helper 是专为 macOS 设计的浏览器自动化前置技能。它通过 Peekaboo 无障碍自动化 CLI 与 Chrome 的 accessibility tree 交互，自动完成扩展连接、窗口管理和状态验证，使 browser(profile="chrome") 工具可用。
执行流程极为严谨：先快速检测是否已连接，若无则强制关闭 Chrome、清理恢复页面弹窗、以极简网页启动、最大化窗口、扫描工具栏扩展图标（最多重试8次）、点击连接并验证状态。全程依赖无障碍元素描述（如 "OpenClaw Browser Relay: attached"），零硬编码坐标，因此适配任意屏幕分辨率。
显著优点
1. 鲁棒性极强：通过 accessibility tree 而非视觉识别定位元素，避免了坐标漂移、分辨率变化、DPI 缩放等问题；8次重试机制应对 Chrome 启动延迟
2. 反检测友好：启动页选用零 JavaScript、零 Cookie 的 info.cern.ch，避免触发 Cloudflare 等反爬机制
3. 状态透明：输出 ALREADY_ATTACHED/ATTACHED/FAILED 三种明确状态，失败时保留调试截图
4. Token 经济：配合 snapshot 模式读取页面，比截图+视觉识别节省 10-50 倍 token
潜在缺点与局限
- macOS 独占：Windows/Linux 用户无法使用
- 依赖链较长：需同时安装 Peekaboo、配置 node 无障碍权限、修改 openclaw.json、手动加载并固定扩展
- 冷启动耗时：约29秒完成全流程，不适合高频短时任务
- Chrome 专属：不支持 Safari/Firefox 等其他浏览器
适合人群
- 需在 macOS 上进行高可靠性浏览器自动化的开发者
- 使用 OpenClaw 生态且已配置
browser(profile="chrome")的用户 - 对反检测有要求、希望避免像素坐标维护成本的场景
常规风险
| 风险点 | 说明 |
|--------|------|
| 权限配置遗漏 | node 未加入系统 Accessibility 白名单将导致点击事件失败 |
| 扩展未固定 | 未 pin 到工具栏的扩展在 accessibility tree 中不可见 |
| 配置端口错误 | openclaw.json 中端口非 18792 将导致连接失败 |
| 窗口尺寸问题 | 跳过后台最大化步骤会使工具栏元素无法扫描 |