Wsl Chrome Cdp

What This Skill Does

The Wsl Chrome Cdp skill, developed by animaiontj, is a specialized bridge designed specifically for developers and power users operating within a WSL2 (Windows Subsystem for Linux) environment. Its primary purpose is to enable seamless communication between OpenClaw’s browser-based agents and the Google Chrome browser installed on the host Windows system. By leveraging the Chrome DevTools Protocol (CDP), this skill automates the complex task of initializing a remote-debugging-capable Chrome instance from a Linux shell. It handles process detection, port management, and connection verification, allowing your OpenClaw agent to execute web-based tasks like navigation, scraping, and automated screenshotting as if it were running natively on the Windows desktop.

Installation

To integrate this skill into your environment, ensure you have the OpenClaw CLI installed. Execute the following command in your terminal: clawhub install openclaw/skills/skills/animaiontj/wsl-chrome-cdp. Once installed, the skill automatically handles path detection for your local Chrome installation. No manual configuration of environment variables or registry keys is required for standard setups. If you encounter issues, the included enable-browser.sh script provides an easy way to verify connectivity, and the documentation in the /docs directory offers comprehensive troubleshooting steps to resolve common pathing or permission issues.

Use Cases

This skill is perfect for users who perform web automation tasks in a Linux environment but require the features, extensions, and profile data of their Windows-based Chrome browser. Common use cases include: 1) Performing automated web testing or scraping where specific browser cookies or login sessions are required. 2) Using AI agents to assist in research tasks by browsing websites that require Windows-only authentication. 3) Automating administrative tasks across web interfaces from your WSL2 command-line workflow.

Example Prompts

• "Open Google News and search for the latest tech trends."
• "Navigate to the OpenClaw documentation site and take a screenshot of the installation page."
• "Visit GitHub, log in with my saved credentials, and summarize my latest pull requests."

Tips & Limitations

To ensure optimal performance, keep Chrome updated, as version mismatches between the browser and CDP can occasionally cause connection instability. Always ensure that no other application is using port 9222, as this is the default debug port. If you find the connection is hanging, try disabling your local proxy settings within the WSL environment, as the proxy can sometimes intercept loopback connections intended for the Windows host. Remember that this skill requires the Chrome browser to be installed on the host Windows partition at the standard file path.