modbender OpenClaw Browser
Browser automation for OpenClaw via Chrome DevTools Protocol.
Prerequisites
Chrome must be installed and running with remote debugging enabled:
# Start Chrome with CDP (port 9222)
chrome --remote-debugging-port=9222 --remote-debugging-address=0.0.0.0
Quick Start
Screenshot a Website
# Using the provided script
node ~/.openclaw/workspace/skills/openclaw-browser/scripts/screenshot.js https://example.com /tmp/output.png
# With custom viewport
node ~/.openclaw/workspace/skills/openclaw-browser/scripts/screenshot.js https://example.com /tmp/output.png --width=1920 --height=1080
Full Page Screenshot
The script automatically captures full page content, not just viewport.
How It Works
- Connects to running Chrome via CDP (http://127.0.0.1:9222)
- Creates new tab or uses existing one
- Navigates to target URL
- Waits for page load
- Takes screenshot
- Saves to specified path
Common Issues
Chrome not running:
- Start Chrome with CDP flags first
- Verify with:
curl http://127.0.0.1:9222/json/version
Headless detection:
- Some sites (Xiaohongshu, Taobao) detect headless browsers
- Solution: Use non-headless Chrome (visible window)
- This skill connects to existing Chrome, avoiding detection
Permission errors:
- Use
--no-sandboxwhen starting Chrome if needed
Script Reference
See scripts/screenshot.js for the main automation script.
Advanced Usage
For custom automation beyond screenshots, modify the script or use Puppeteer directly:
const puppeteer = require('puppeteer');
const browser = await puppeteer.connect({ browserURL: 'http://127.0.0.1:9222' });
// ... custom actions