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
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/wsl-chrome-cdp/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How wsl-chrome-cdp - WSL2 访问 Windows Chrome 浏览器 Compares
| Feature / Agent | wsl-chrome-cdp - WSL2 访问 Windows Chrome 浏览器 | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/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
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
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
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)
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
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
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
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
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
OpenClaw Gateway Self-Healing System for Windows
chrome-cdp-skill
> 让AI agent访问你已打开的Chrome标签页
windows-tts
在 Windows 11 上"直接发声"的 TTS(从 WSL2/TUI 调用 powershell.exe + System.Speech)。适用于用户说"说出来/读出来/语音播报/用TTS",或反馈"没声音/tts 生成的 mp3 是空的/播不出来",以及需要中文语音但 OpenClaw 内置 tts 不可用时。
chrome-cdp-live-browser
Give AI agents access to your live Chrome session via CDP — interact with open tabs, logged-in accounts, and current page state
---
name: article-factory-wechat
humanizer
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.