by 运行时依赖
安装命令
点击复制技能文档
Win11 可见浏览器自动化 使用此技能，当 OpenClaw 在 WSL2/Linux 中运行，但应在人类可以观看、使用和接管的可见 Windows 11 Edge/Chrome 浏览器中工作。它用于合法的辅助浏览，在正常的可见浏览器会话中进行。不要使用它来绕过网站保护、自动化禁止的活动或向用户隐藏自动化。
安全门 在状态更改操作之前，说明状态/位置/风险/回滚，并等待明确的确认。状态更改操作包括编辑 OpenClaw 配置、创建计划任务、更改 Windows 防火墙/端口代理、启动/停止浏览器进程、在工作区外写入脚本、发送表单/消息、购买或账户操作。
定位 更倾向于可见浏览器自动化，当任务受益于：
- 用户浏览器中已经打开的现有标签页；
- Cookies、登录、扩展和正常浏览器状态；
- 可见的步骤式人工监督；
- 人工帮助用于登录、验证码、2FA、同意屏幕、账户选择器、文件对话框或敏感批准；
- 不能通过 web_fetch 或新/无头浏览器正常工作的网站。
使用安全的措辞：此技能允许代理访问正常的可见浏览器，同时保持人工干预。它不会尝试绕过反 bot 系统。
推荐架构 默认使用专用 Windows 浏览器配置文件。仅当用户明确希望使用现有的个人 cookies/登录/标签页时，才使用用户的个人浏览器配置文件。 OpenClaw 网关在 WSL2 → OpenClaw 浏览器配置文件（例如 win-edge）→ http://WINDOWS_WSL_GATEWAY_IP:9223 → Windows 端口代理/防火墙中继 → 127.0.0.1:9222 → 可见 Windows 11 Edge/Chrome 配置文件
推荐默认值：
- OpenClaw 浏览器配置文件：win-edge 或 win-chrome
- Windows CDP 本地端口：9222
- WSL 可见中继端口：9223
- 专用浏览器配置文件：C:\ProgramData\OpenClaw\browser-profile
- 启动/修复任务：OpenClaw-Start-Windows-Browser-CDP
有关实现细节，请阅读 {baseDir}/references/setup.md。
诊断 首先运行只读检查，然后进行修复：
- openclaw 浏览器配置文件
- openclaw 浏览器 -- 浏览器配置文件 win-edge doctor
- WIN_IP=$(ip route | awk '/default/ {print $3; exit}')
- curl -sS --max-time 5 "http://$WIN_IP:9223/json/version"
- 或使用捆绑的帮助程序：{baseDir}/scripts/check-win11-visible-browser.sh win-edge
如果 CDP 工作，请进行真实浏览器控制的冒烟测试：
- openclaw 浏览器 -- 浏览器配置文件 win-edge open https://example.com
- openclaw 浏览器 -- 浏览器配置文件 win-edge snapshot --format aria
修复顺序 分层修复，并在层工作时停止：
- 确认 Windows Edge/Chrome 已安装并可以可见运行。
- 在 Windows localhost 上启动浏览器，通常为 127.0.0.1:9222。
- 使用 Windows 中继/端口代理将其暴露给 WSL，通常为 0.0.0.0:9223 → 127.0.0.1:9222。
- 限制 Windows 防火墙仅限当前 WSL/Hyper-V CIDR，而不是整个 LAN 或 Internet。
- 配置 OpenClaw 浏览器配置文件，cdpUrl 指向 WSL 可见的 Windows 端点，并将 attachOnly 设置为 true。
- 如果配置文件不可见，请重新加载/重新启动网关。
- 运行 doctor 和页面/快照冒烟测试。
捆绑的 Windows 修复脚本为 {baseDir}/scripts/start-win11-browser-cdp-for-openclaw.ps1。将其视为模板：在安装或运行之前，请查看路径、配置文件名称、浏览器路径、端口和防火墙规则名称。
常见阻塞点
- 未找到支持的浏览器：WSL 不能将 Windows Edge/Chrome 作为本地 Linux 浏览器启动；使用远程 CDP。
- Windows CDP 工作，但 WSL curl 超时：修复端口代理/防火墙/WSL 子网。
- 未找到浏览器配置文件：OpenClaw 配置未加载；重新加载/重新启动网关。
- WSL 网关 IP 已更改：更新 browser.profiles..cdpUrl 或重新运行记录的修复流程。
- 缺少现有的标签页/登录：您可能正在使用专用配置文件，而不是用户的真实配置文件。切换配置文件前请先询问。
报告证据 完成后，请报告：
- 测试的浏览器配置文件名称和 CDP URL；
- openclaw 浏览器 -- 浏览器配置文件 <配置文件> doctor 结果；
- WSL 中的 /json/version 结果；
- 如果相关，请报告 Windows 任务/日志状态；
- 打开的冒烟测试 URL 和快照结果；
- 需要的任何剩余手动人工步骤。