Files
openclaw/assets/chrome-extension
Kriz Poon 0a53a77dd6 Chrome extension: validate relay endpoint response format
Options page now validates that /json/version returns valid CDP JSON (with Browser/Protocol-Version fields) rather than accepting any HTTP 200 response. This prevents false success when users mistakenly configure the gateway port instead of the relay port (gateway + 3).

Helpful error messages now guide users to use "gateway port + 3" when they configure the wrong port.
2026-02-24 04:16:08 +00:00
..
2026-01-15 05:11:03 +00:00

OpenClaw Chrome Extension (Browser Relay)

Purpose: attach OpenClaw to an existing Chrome tab so the Gateway can automate it (via the local CDP relay server).

Dev / load unpacked

  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. Chrome → chrome://extensions → enable “Developer mode”.

  5. “Load unpacked” → select the path printed above.

  6. Pin the extension. Click the icon on a tab to attach/detach.

Options

  • Relay port: defaults to 18792.
  • Gateway token: required. Set this to gateway.auth.token (or OPENCLAW_GATEWAY_TOKEN).