🦞OpenClaw Guide
Browser

Browser Not Working — Extension Relay Setup

Browser automation fails with relay errors. Setup guide for local and remote gateways.

⚠️ The Problem

Browser automation fails with errors like: `` Relay not reachable at http://127.0.0.1:18792/ Chrome extension relay not connected Browser control service not listening `` Or the Chrome extension Options page shows "not connected".

🔍 Why This Happens

The browser relay is a local service that bridges between OpenClaw and Chrome. Common issues: 1. Remote gateway setup — The relay needs to run locally but gateway is remote 2. Browser mode disabledgateway.nodes.browser.mode set to off 3. Extension not installed — Chrome extension missing or outdated 4. Port conflict — Something else using port 18792

The Fix

For local gateway (gateway on same machine as Chrome):

bash
openclaw browser startopenclaw browser tabs

For remote gateway (gateway on VPS, Chrome on your Mac/PC):

1. Ensure browser routing is enabled on the gateway:

bash
openclaw config set gateway.nodes.browser.mode autoopenclaw gateway restart

2. Run the node host on your local machine:

bash
openclaw node

3. The relay starts automatically when the gateway routes a browser request to your node.

Install the Chrome extension if missing:

bash
openclaw browser extension install

Verify the extension is running:

- Open Chrome Extensions page - Find OpenClaw extension - Click on "Details" and ensure it's enabled - Check the Options page shows "Connected"

🔥 Your AI should run your business, not just answer questions.

We'll show you how.$97/mo (going to $197 soon)

Join Vibe Combinator →

📋 Quick Commands

CommandDescription
openclaw browser startStart local browser relay
openclaw browser tabsList open browser tabs
openclaw browser extension installInstall Chrome extension
openclaw config set gateway.nodes.browser.mode autoEnable browser for remote

Related Issues

🐙 Your AI should run your business.

Weekly live builds + template vault. We'll show you how to make AI actually work.$97/mo (going to $197 soon)

Join Vibe Combinator →

Still stuck?

Join our Discord community for real-time help.

Join Discord