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

**版本:** 1.0.0

3,891 stars

Best use case

wsl-chrome-cdp - WSL2 访问 Windows Chrome 浏览器 is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

**版本:** 1.0.0

Teams using wsl-chrome-cdp - WSL2 访问 Windows Chrome 浏览器 should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/wsl-chrome-cdp/SKILL.md --create-dirs "https://raw.githubusercontent.com/openclaw/skills/main/skills/animaiontj/wsl-chrome-cdp/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/wsl-chrome-cdp/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

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

Feature / Agentwsl-chrome-cdp - WSL2 访问 Windows Chrome 浏览器Standard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

**版本:** 1.0.0

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 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/version
```

---

### **问题 3:端口被占用**

**症状:** 端口 9222 已被其他进程占用

**解决:**
```powershell
# Windows 上检查端口
netstat -ano | findstr 9222

# 结束占用进程
taskkill /F /PID <进程 ID>
```

---

### **更多问题**

**查看完整故障排查指南:** `docs/troubleshooting.md`

---

## 📚 参考资料

- [OpenClaw Browser 文档](https://docs.openclaw.ai/tools/browser)
- [Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/)

---

## 💕 关于作者

**杏子(Apricot)** - OpenClaw 社区贡献者

**创建背景:**
> 2026-03-11,为解决 WSL2 中 OpenClaw 无法访问 Windows Chrome 的问题,
> 杏子整理了完整的自动化配置流程。
> 希望这个技能能帮助更多人!

**技能理念:**
> "配置应该是全自动的,排查应该是清晰的。"
> "今天踩的坑,明天就不用再踩了。"

---

*技能版本:1.0.0 | 最后更新:2026-03-11*

Related Skills

enable-chrome-gemini

3891
from openclaw/skills

Set up or repair Gemini in Chrome (Glic) on Windows, macOS, or Linux when enabling it for the first time outside the US or when the sidebar, floating panel, Alt+G shortcut, or top-bar entry disappears. Back up and patch Chrome Local State, restore region/eligibility fields, and check the required Glic flags and Chrome language.

OpenClaw Install Guide (WSL2 Windows)

3891
from openclaw/skills

Complete step-by-step installation guide for OpenClaw on Windows 10/11 with WSL2, includes common pitfalls and solutions from real installation experience.

connect-chrome

3891
from openclaw/skills

Launch real Chrome controlled by the agent with a Side Panel extension. Watch every action in real time in a visible browser window. Use when: "connect chrome", "open chrome", "real browser", "launch chrome", "side panel", "control my browser", "watch it work".

chromecast-with-google-tv

3891
from openclaw/skills

Cast YouTube videos, Tubi TV show episodes, and TV show episodes from other video streaming apps via ADB to Chromecast with Android TV (Chromecast 4K supported, Google TV Streamer support is unknown)

chrome-devtools-mcp-manager

3891
from openclaw/skills

Manage chrome-devtools-mcp service and OpenClaw's built-in Chrome browser for MCP-based browser automation. Use when user needs to use chrome-devtools-mcp functionality, ensure the browser is ready for MCP operations, or manage the browser/MCP lifecycle.

chrome-devtools-mcp

3891
from openclaw/skills

Chrome DevTools MCP — Google's official browser automation and testing server. Control Chrome via Puppeteer through MCP protocol: click, fill forms, navigate, screenshot, performance traces, network inspection, console debugging. Use for browser testing, web automation, performance analysis, UI testing, form filling, and visual regression.

windows-healing-gateway

3891
from openclaw/skills

OpenClaw Gateway Self-Healing System for Windows

chrome-cdp-skill

3891
from openclaw/skills

> 让AI agent访问你已打开的Chrome标签页

windows-tts

3891
from openclaw/skills

在 Windows 11 上"直接发声"的 TTS(从 WSL2/TUI 调用 powershell.exe + System.Speech)。适用于用户说"说出来/读出来/语音播报/用TTS",或反馈"没声音/tts 生成的 mp3 是空的/播不出来",以及需要中文语音但 OpenClaw 内置 tts 不可用时。

chrome-cdp-live-browser

3817
from openclaw/skills

Give AI agents access to your live Chrome session via CDP — interact with open tabs, logged-in accounts, and current page state

---

3891
from openclaw/skills

name: article-factory-wechat

Content & Documentation

humanizer

3891
from openclaw/skills

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

Content & Documentation