A Chrome extension that automatically attaches OpenClaw to all browser tabs via a local CDP (Chrome DevTools Protocol) relay server. No manual toggle needed — every tab is always under OpenClaw control.

• Auto-attach all tabs — every open tab is automatically attached when the relay connects
• New tabs auto-attach — tabs opened after startup are attached as they finish loading
• Resilient reconnection — exponential backoff reconnect with automatic re-attach on relay recovery
• Navigation survival — debugger sessions re-attach seamlessly after in-page navigations
• MV3 service worker — state persisted across Chrome service worker restarts
• Periodic keepalive — alarm-based health checks ensure tabs stay attached

1. Build/run OpenClaw Gateway with browser control enabled.

2. Ensure the relay server is reachable at http://127.0.0.1:18792/ (default).

3. Install the extension to a stable path:

   openclaw browser extension install
   openclaw browser extension path

4. Open Chrome and navigate to chrome://extensions.

5. Enable Developer mode (toggle in the top-right).

6. Click Load unpacked and select the extension directory path printed above.

7. Pin the extension icon in the toolbar.

Right-click the extension icon → Options, or go to chrome://extensions → OpenClaw Browser Relay → Details → Extension options.

1. On startup (or reconnect), the extension connects to the local relay WebSocket server.
2. It queries all open tabs and attaches the Chrome debugger to each eligible tab (skipping chrome://, chrome-extension://, and devtools:// URLs).
3. New tabs are automatically attached via chrome.tabs.onUpdated when they finish loading.
4. CDP commands from the relay are forwarded to the correct tab's debugger session; CDP events from tabs are forwarded back to the relay.
5. If the relay disconnects, the extension retries with exponential backoff and re-attaches all tabs on reconnect.
6. Clicking the extension icon manually triggers a reconnect + attach-all (useful for recovery).

MIT