Browser Relay & Node Pairing

The Browser Relay lets your Moe’s AI agent control a tab in your local Chrome browser — navigating, clicking, reading content, and filling forms — while preserving your existing login sessions. No credentials are ever shared with the agent.

This is especially useful for:

Internal tools protected by Google SSO or other corporate auth
Dashboards that don’t have APIs
Any web workflow you want to automate without re-authenticating

How it works

Three pieces work together:

Component	What it does
Moe’s AI agent (cloud)	Receives your instructions, decides what to do
Node (your machine)	Bridges the cloud agent to your local environment
Chrome extension	Attaches to your browser tab and executes actions

The agent talks to the node over a secure WebSocket. The node talks to the Chrome extension over a local loopback connection. Your browser session — including any SSO cookies — stays entirely on your machine.

Step 1 — Install the Node

The node is a lightweight background process that runs on your machine and connects it to your Moe’s AI gateway.

macOS:

brew install openclaw/tap/openclaw

Windows (PowerShell as Administrator):

winget install openclaw
# or via npm:
npm install -g openclaw

Linux:

# Via Homebrew (recommended)
brew install openclaw/tap/openclaw

# or via npm
npm install -g openclaw

Step 2 — Connect your machine to your gateway

Run this once to pair your machine as a node. Find your gateway URL and token in your Moe’s AI dashboard under Settings → Gateway.

macOS / Linux:

openclaw node connect \
  --gateway https://YOUR_SUBDOMAIN.moes.ai \
  --token YOUR_GATEWAY_TOKEN

Windows (PowerShell):

openclaw node connect `
  --gateway https://YOUR_SUBDOMAIN.moes.ai `
  --token YOUR_GATEWAY_TOKEN

Your agent will receive a pairing request. Approve it by telling Moe: “approve the node pairing request” — or approve it directly in your dashboard under Devices.

Once paired, your machine stays connected in the background automatically.

Step 3 — Install the Chrome Extension

Install the OpenClaw Browser Relay extension from the Chrome Web Store:

👉 OpenClaw Browser Relay — Chrome Web Store

Click Add to Chrome
Pin the extension to your toolbar (puzzle icon → pin)
Click the extension icon → Options
Enter your Gateway Token (same token from Step 2)
Leave the port as 18792 (default)
Save

Step 4 — Attach a tab and start

Open Chrome and navigate to the tool or site you want the agent to control
Log in normally — your existing Google (or other) session is used as-is, no credentials are shared
Click the OpenClaw toolbar icon on that tab — the badge turns ON
Tell your agent what to do, for example:

“Go to the listings report and summarize this week’s activity”

The agent takes control of the attached tab. You can watch it work in real time and detach anytime by clicking the icon again.

Troubleshooting

Extension badge won’t turn on

Make sure the node is running and connected: openclaw nodes status
Verify the gateway token in extension Options matches your dashboard token

Agent says it can’t see the browser

Only one tab can be attached at a time — detach and re-attach if needed
Try refreshing the tab before attaching

Node disconnects after sleep

The node reconnects automatically on wake. If it doesn’t, re-run the openclaw node connect command from Step 2.

Windows: openclaw command not found after install

Restart PowerShell or your terminal after installing so the PATH updates take effect