Wsl Chrome Cdp

# wsl-chrome-cdp - WSL2 访问 Windows Chrome 浏览器

**版本：** 1.0.0  
**作者：** 杏子  
**创建日期：** 2026-03-11  
**适用系统：** Windows + WSL2 + OpenClaw

---

## 📋 技能描述

解决 WSL2 环境中无法访问 Windows Chrome 浏览器的问题，实现 OpenClaw browser 工具对 Windows Chrome 的远程控制。

**核心功能：**
- ✅ 自动检测 Chrome 是否运行
- ✅ 自动启动 Chrome 调试模式
- ✅ 自动验证 CDP 连接
- ✅ 完全无需手动操作

---

## 🚀 使用方法

### **全自动模式（推荐）**

**安装技能后，无需任何配置！**

**在 OpenClaw 对话中直接说：**

```
打开百度
```

```
访问 GitHub
```

```
帮我截图
```

**杏子会自动：**
1. ✅ 检测 Chrome 是否运行
2. ✅ 如果没运行，自动启动 Chrome 调试模式
3. ✅ 验证 CDP 连接
4. ✅ 执行你的请求

**完全无需手动操作！**

---

### **手动运行（可选）**

```bash
# 一键启用浏览器
./skills/wsl-chrome-cdp/enable-browser.sh
```

---

## 📁 文件结构

```
wsl-chrome-cdp/
├── SKILL.md                          # 技能说明（本文件）
├── README.md                         # 快速入门
├── enable-browser.sh                 # 全自动启用脚本
├── scripts/
│   └── start-chrome-debug.bat        # Windows 备用启动脚本
└── docs/
    └── troubleshooting.md            # 故障排查指南
```

---

## 🔍 故障排查

### **问题 1：Chrome 启动失败**

**症状：** 脚本显示 "Chrome CDP 启动失败"

**解决：**
```bash
# 1. 检查 Chrome 是否安装
ls -la "/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"

# 2. 手动启动 Chrome 调试模式
/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe -Command \
  'Start-Process "C:\Program Files\Google\Chrome\Application\chrome.exe" \
   -ArgumentList "--remote-debugging-port=9222","--user-data-dir=C:\Users\$env:USERNAME\AppData\Local\Google\Chrome\Debug","--no-first-run"'
```

---

### **问题 2：CDP 连接超时**

**症状：** `curl http://127.0.0.1:9222/json/version` 超时

**解决：**
```bash
# 1. 取消代理
unset http_proxy https_proxy

# 2. 尝试 Windows IP
WINDOWS_IP=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
curl http://$WINDOWS_IP:9222/json...

# WSL Chrome CDP - 快速入门

**让 WSL2 无缝访问 Windows Chrome 浏览器**

**全自动模式：无需手动操作！**

---

## 🚀 30 秒开始

### **安装技能**

```bash
# 从 ClawHub 安装（待发布）
openclaw skills install wsl-chrome-cdp

# 或手动安装
git clone https://github.com/openclaw/wsl-chrome-cdp.git ~/.openclaw/workspace/skills/wsl-chrome-cdp
```

### **使用**

**在 OpenClaw 对话中直接说：**

```
打开百度
```

**就这么简单！**

---

## 🔧 手动启用（可选）

```bash
# 一键启用浏览器
./skills/wsl-chrome-cdp/enable-browser.sh
```

**输出示例：**

```
=========================================
WSL Chrome CDP - 全自动启用
作者：杏子 🍑
=========================================

[INFO] 检查 Chrome CDP 连接...
[✓] Chrome CDP 已就绪
[INFO] Chrome 版本：Chrome/145.0.7632.160

=========================================
[✓] 浏览器已就绪，可以使用！
=========================================
```

---

## 📚 文档

| 文档 | 说明 |
|------|------|
| [SKILL.md](SKILL.md) | 完整技能说明 |
| [故障排查](docs/troubleshooting.md) | 详细排查指南 |

---

## 💡 使用示例

**配置成功后，在 OpenClaw 中：**

```
打开 GitHub
截图
点击登录按钮
填写表单
提取页面内容
```

---

## 🍑 关于

**作者：** 杏子  
**版本：** 1.0.0  
**创建日期：** 2026-03-11

**使用问题？** 查看 [SKILL.md](SKILL.md) 或 [故障排查](docs/troubleshooting.md)

---

*快速入门版本：1.0.0 | 最后更新：2026-03-11*