OpenClaw Browser Relay for Windows

本地中继桥将 OpenClaw 连接到 Windows 上现有的 Chrome 选项卡。

--------------------------------适用于 Windows V 2.1.2 的 OpenClaw 浏览器中继--------------------------------------------------------
------------------------------------------------------------------------------------------------------------------------------------------------------------------
插件介绍

- [OpenClaw Browser Relay] 插件将 OpenClaw 连接到您当前打开的 Chrome 选项卡，允许 OpenClaw 像人类一样操作您的浏览器。

- 由于OpenClaw（macOS/Windows/Windows+WSL）的部署方式多种多样，市场上很多[OpenClaw Browser Relay]插件都存在兼容性问题。

- 这个“OpenClaw Browser Relay for Windows”是专门为原生 Windows 设计的（即不是使用 WSL 的 Windows 部署，而是基于 Windows 自己的 PowerShell 部署），提供了出色的兼容性以及比使用 Windows+WSL 部署的浏览器界面更丰富、更强大的浏览器界面。

- 通过提供本地中继路径，保护实际的浏览器会话，从而解决基于Windows + WSL/沙箱的浏览器控制中常见的稳定性问题。

主要优点：
• 本机Windows 路由：PowerShell + 本地网关+ 本地中继
• 无 WSL 依赖性
• 真实浏览器会话附加/分离
• 具有网关令牌控制的本地通信 (127.0.0.1)，以实现更安全的操作

范围：
- 此扩展适用于从 PowerShell 启动的本机 Windows OpenClaw。
- 它不适用于 WSL 部署。 WSL 用户应使用 WSL 构建。

主要特点：
- 在活动选项卡上一键附加/分离
- 用于浏览器自动化的本地 CDP 中继桥
- 中继端口和网关令牌的本地设置
- 自动重新连接和会话恢复以确保稳定性
- 交互式反馈卡：复制诊断并打开电子邮件反馈

港口指引：

- 常用默认中继端口：`18792`
- 如果网关端口是自定义的，则中继通常为“网关+3”
- 示例：`网关 19001 -> 中继 19004`

令牌指南（PowerShell）：

- 安全/编辑输出：`./openclaw-win.ps1 config get gateway.auth --json`
- 普通令牌（小心复制）：`(Get-Content -Raw ./open-claw/openclaw.json | ConvertFrom-Json).gateway.auth.token`

工作原理：

1. 在 Windows 上启动 OpenClaw Gateway/Browser Relay。
2. 打开扩展选项并设置中继端口和网关令牌。
3. 单击选项卡上的扩展图标。 “ON”徽章表示已附上。

权限说明：

- `debugger`/`tabs`/`activeTab`：附加到选项卡并转发 CDP 命令。
- `storage`：存储本地配置（中继端口和令牌）。
- `webNavigation`/`alarms`：重新连接和状态刷新。
- `host_permissions (127.0.0.1/localhost)`：仅连接到本地中继服务。

数据和隐私：

- 无广告、跟踪器或第三方分析 SDK。
- 仅与本地“127.0.0.1”/“localhost”中继端点通信。
- 扩展本身不会将数据上传到开发人员拥有的远程服务器。


--------------------------------适用于 Windows V 2.1.2 的 OpenClaw 浏览器中继--------------------------------------------------------
------------------------------------------------------------------------------------------------------------------------------------------------------------------
插件介绍

- 插件 [OpenClaw Browser Relay ] 作用相当于 OpenClaw 连接到你当前已打开的 Chrome 标签页，让 openclaw 可以像人类一样自由操作你的浏览器。

- 由于openclaw的部署有多种方式(MacOS/Windows/Windows+WSL)，其中的[OpenClaw Browser Relay]插件存在很多兼容性问题。

- 本“OpenClaw Browser Relay for Windows”专为原生Windows（即不是使用WSL的Windows配置，而是基于Windows本身的PowerShell配置）而设计，良好地具备了兼容性，也比使用Windows+WSL配置的浏览接口器更丰富，功能更强大。

- 它通过提供本地中继路径，为真实的浏览器会话提供安全保障，从而解决了基于Windows + WSL/沙箱的浏览器控制中常见的稳定性问题。

主要优势：
• 全新Windows方案：PowerShell + 本地网关 + 本地中继• 消耗依赖WSL
• 真实的浏览器会话连接/分离• 通过网关令牌进行本地通信(127.0.0.1)，确保操作安全

适用范围：
- 仅适用于原有的 PowerShell 的 Windows OpenClaw 配置。
- 不适用于 WSL 部署平台（WSL 请使用对应的 WSL 版本扩展）。

核心能力：
- 一键附加 / 取消附加当前标签页
- 通过本地Relay转发CDP调试命令
- 本地配置中继端口与网关令牌
- 自动重连与会话恢复
- 反馈工具：可复制诊断信息并拉起邮件反馈

端口说明：
- 常见默认中继端口为`18792`。
- 如果你自定义了网关端口，通常可以按 `relay = gateway + 3` 计算。
- 示例：`网关 19001 -> 中继 19004`。

Token说明（PowerShell）：
- 安全查看（脱敏）：`./openclaw-win.ps1 config get gateway.auth --json`
- 明文查看（字符串）：`(Get-Content -Raw ./open-claw/openclaw.json | ConvertFrom-Json).gateway.auth.token`

使用方式：
1. 在Windows中启动OpenClaw Gateway / Browser Relay。
2.打开扩展选项页，填写中继端口与网关令牌。
3. 在任意网页标签页点击扩展图标，看到“ON”表示附加成功。

权限说明：
- `debugger`/`tabs`/`activeTab`：用于附加当前标签页并转发调试命令。
- `storage`：仅保存本地配置（端口与Token）。
- `webNavigation`/`alarms`：用于重连和状态恢复。
- `host_permissions (127.0.0.1/localhost)`：仅访问本机中继服务。

数据与隐私：
- 不内置广告、追踪器或第三方分析SDK。
- 仅与本机 `127.0.0.1` / `localhost` 中继通信。
- 扩展本身不向开发者远程服务器自动上传数据。