Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Set up reliable browser automation using Chrome DevTools Protocol (CDP) instead of the flaky browser extension relay. Use when browser relay keeps disconnect...
Set up reliable browser automation using Chrome DevTools Protocol (CDP) instead of the flaky browser extension relay. Use when browser relay keeps disconnect...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Replace the unreliable browser extension relay with a direct Chrome DevTools Protocol connection.
The OpenClaw browser extension relay (profile="chrome") frequently breaks: WebSocket 403 errors Port confusion (gateway port vs relay port) Dropped connections mid-automation "Can't reach browser control service" errors Badge/tab attachment confusion
Launch Chrome with a debug port and connect directly. No extension needed.
Run the setup script to configure everything: bash scripts/setup-cdp.sh This will: Create a dedicated Chrome profile at ~/.chrome-debug-profile Add browser.cdpUrl to your OpenClaw config Create a LaunchAgent (macOS) so Chrome starts on login Verify the connection works
If you prefer to set things up manually, see references/manual-setup.md.
After setup, always use profile="openclaw" (not profile="chrome"): browser(action="snapshot", profile="openclaw") browser(action="navigate", profile="openclaw", targetUrl="https://example.com") browser(action="screenshot", profile="openclaw")
FeatureExtension RelayCDP DirectStabilityFrequent disconnectsRock solidSetupInstall extension + attach tabOne-time scriptAuth/CookiesShares your main ChromeDedicated profileSpeedExtra hop through extensionDirect protocolHeadlessNoOptional (--headless=new)
The CDP browser uses ~/.chrome-debug-profile โ a separate Chrome profile. This means: Log into sites once, stays logged in Your main Chrome is untouched No extension conflicts Survives Chrome updates
First run: Log into any sites you need (Google, GitHub, X, LinkedIn, etc.) Multiple tabs: CDP manages all tabs โ use targetId to pin a specific tab Headless mode: Add --headless=new to the launch command for invisible operation Port conflict: If port 9222 is taken, change it in both the launch command and config Restart Chrome: pkill -f 'remote-debugging-port=9222' && sleep 1 && bash scripts/setup-cdp.sh
"Can't reach browser": Chrome isn't running with debug port. Run setup-cdp.sh or launch manually Port 9222 in use: Another Chrome or process grabbed it. Kill it: lsof -i :9222 Stale session: Chrome crashed. Kill and restart: pkill -f chrome-debug-profile Profile corruption: Delete ~/.chrome-debug-profile and re-run setup
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.