solution gateway high linux macos windows

Gateway: CLI/UI is probing the wrong machine (local vs remote mode mismatch)

Fix confusing 'gateway unreachable' states by aligning gateway.mode, gateway.remote.url, profiles/state dirs, and the URL you probe.

By CoClaw Team •

Symptoms

  • The gateway is running, but openclaw status --deep or the Control UI can’t connect.
  • You suspect you’re connecting to one machine, but the CLI is probing a different URL.

Cause

OpenClaw can run in local or remote mode. If you set gateway.mode=remote, your CLI defaults to using gateway.remote.url. Meanwhile your gateway service may still be running locally (or under a different profile/state dir), which creates “it’s running but unreachable” confusion.

Fix

1) Ask OpenClaw what it is actually probing

Run:

openclaw gateway status

Check the printed probe target / URL and confirm it matches where your gateway is running.

2) If you want to use the local gateway

Set the gateway mode back to local (in config), then restart the gateway.

3) If you want to use a remote gateway

Ensure gateway.remote.url is correct and reachable from your machine, and that the remote gateway auth token/password matches what your client uses.

4) Avoid profile/state-dir mismatch

If you run multiple profiles or moved your state directory, ensure both your service and your CLI are using the same profile/state dir. Rewriting the service can help:

openclaw gateway install --force

Verify

  • openclaw status --deep succeeds against the expected gateway.
  • Opening the Control UI reaches the intended gateway host.

Verification & references

  • Reviewed by:CoClaw Code Team
  • Last reviewed:March 14, 2026
  • Verified on: Linux · macOS · Windows
Want to explore more? Browse all solutions or ask in the Community Forum .
Report a problem

Related Resources

Gateway: service says running but the CLI/UI can't connect (probe fails)
Fix
Fix 'running but unreachable' gateway states by checking you're probing the right URL, confirming the port is listening, and aligning auth/bind settings.
Gateway fails to start: EADDRINUSE / another gateway instance is already listening
Fix
Fix OpenClaw gateway port conflicts (EADDRINUSE) by stopping the other process or choosing a new gateway port/profile.
Linux/systemd: OpenClaw leaves orphan gateway processes or port 18789 conflicts
Fix
Fix Linux hosts where CLI-triggered gateway respawn collides with a systemd-managed OpenClaw gateway, causing orphan processes, EADDRINUSE, or 'another gateway instance is already listening'.
Gateway restart is slow (`remote bin probe timed out` from a stale paired node)
Fix
Fix gateway restart/shutdown delays caused by unreachable or co-located paired nodes triggering repeated remote bin probes. Start with a minimal `gateway.nodes.denyCommands` workaround, then verify restart time returns to normal.
OpenClaw Remote Browser Setup: Gateway on One Machine, Browser on Another
Guide
Choose a stable remote-browser topology for OpenClaw, pin the right browser-capable node, and verify that gateway routing, relay startup, and browser takeover all land on the machine you intended.
OpenClaw Control UI Auth & Pairing: Fix 'unauthorized', 1008, and Remote Dashboard Access
Guide
Restore stable Control UI access by separating gateway auth from device pairing, fixing unauthorized and 1008 loops, and verifying that your remote path stays stable.