核心用法
wsl-chrome-cdp 是一套专为 WSL2 + Windows 混合环境设计的浏览器自动化桥接方案。安装后完全零配置，用户只需在 OpenClaw 对话中说出"打开百度""帮我截图"等自然语言指令，技能即自动完成：Chrome 运行检测 → 调试模式启动 → CDP 端口验证 → 执行用户请求的全流程。
技术原理上，技能通过 /mnt/c/ 挂载点调用 Windows PowerShell，在 Chrome 启动参数中注入 --remote-debugging-port=9222 与独立用户数据目录，避免污染日常浏览环境；同时自动处理 WSL2 与 Windows 主机的网络互通（127.0.0.1 回环或 resolv.conf 动态 IP）。
显著优点
1. 真正零配置：无需手动修改 Windows 注册表、无需配置环境变量、无需理解 CDP 协议细节。
2. 故障排查体系化：提供 Chrome 启动失败、CDP 连接超时、端口占用三类高频问题的精准诊断命令。
3. 隔离安全设计：独立 --user-data-dir 防止调试会话污染主浏览器配置。
4. 社区驱动维护：由 OpenClaw 活跃贡献者维护，文档详尽且附带备用启动脚本。
潜在缺点与局限性
- 平台锁定：仅适用于 Windows 11/10 + WSL2 组合，纯 Linux/macOS 环境无法使用。
- Chrome 路径硬编码：默认指向
C:\Program Files\Google\Chrome\Application\chrome.exe，非标准安装路径需手动修改脚本。 - 端口冲突风险：9222 端口被占用时需用户手动介入（虽提供了排查命令，但仍中断自动化流程）。
- 安全报告缺失：当前安全认证为占位符，未经过 S+/S 级代码审计。
适合人群
- 在 WSL2 开发环境中使用 OpenClaw 的开发者
- 需要 AI 代理自动化操作 Windows 浏览器进行测试、截图、数据抓取的技术用户
- 不愿折腾 CDP 手动配置、追求"开箱即用"体验的效率优先者
常规风险
1. 调试端口暴露：9222 端口在本地网络可见，若在公共/多用户 Windows 环境运行，存在未授权访问风险（建议仅个人开发机使用）。
2. 进程权限继承：WSL2 通过 PowerShell 启动的 Chrome 继承 WSL 分发版的权限上下文，跨系统调用可能引入意外的 UAC 弹窗或权限降级。
3. 数据目录残留：调试用户数据目录长期累积可能占用磁盘空间，需定期清理 C:\Users\<用户名>\AppData\Local\Google\Chrome\Debug。