Browser Playwright Bridge

Run a Playwright script (recommended)

./scripts/browser-lock.sh run scripts/my-task.js [args...]
./scripts/browser-lock.sh run --timeout 120 scripts/my-task.js  # custom timeout

Default timeout: 300s. If the script exceeds it, the watchdog kills it and releases the lock.

This automatically: checks lock → stops OpenClaw browser → starts Chrome with CDP → runs script → cleans up → releases lock.

Manual acquire/release

./scripts/browser-lock.sh acquire    # stop OpenClaw browser, start Chrome
node scripts/my-task.js              # run script(s)
./scripts/browser-lock.sh release    # kill Chrome, release lock

Check status

./scripts/browser-lock.sh status

1. Install Playwright in the workspace (once):

cd  && npm install playwright

> Note: npx playwright install is NOT needed. Playwright connects to the existing Chrome via CDP — no local browser download required.

2. Copy scripts/browser-lock.sh to your workspace scripts/ directory:

chmod +x scripts/browser-lock.sh

| Problem | Fix | |---------|-----| | Lock held by PID xxx | ./scripts/browser-lock.sh release to force-release | | Playwright connectOverCDP timeout | Ensure OpenClaw browser is stopped first (acquire does this) | | CDP port not found | Chrome isn't running; call browser-lock.sh acquire first | | openclaw browser stop doesn't kill Chrome | Known issue; browser-lock.sh kills the process directly | | Script hangs after completion | Add process.exit(0) at the end | | Login expired | Use OpenClaw browser tool to re-login, then run scripts again |