OpenClaw dashboard unable to connect 127.0.0.1:18789
OpenClaw dashboard unable to connect 127.0.0.1:18789 means ECONNREFUSED: nothing is listening. Run openclaw gateway start on that same computer first.
By Dillip Chowdary • Jul 05, 2026 • Source: Tech Bytes
connect ECONNREFUSED 127.0.0.1:18789 means the OpenClaw client reached port 18789 on this computer and nothing accepted the TCP connection. It is not a model outage and it is not an expired login.
Why 127.0.0.1:18789 refuses the connection
127.0.0.1 always means the computer you are using right now. The OpenClaw gateway listens on that loopback address, port 18789, by default. Pasting the dashboard URL into a browser on a different laptop or phone tries that other device, not the machine where the gateway runs.
Start the gateway on this machine
On the computer where OpenClaw is installed, run openclaw gateway status, then openclaw gateway start, then openclaw doctor. Open http://127.0.0.1:18789/ on that same computer. If curl http://127.0.0.1:18789 returns OpenClaw HTML, the gateway is up and a stale tab or desktop-app token is the leftover.
Dashboard on another computer
Forward the port, leave the session open, and only then open the address on your laptop:
ssh -N -L 18789:127.0.0.1:18789 user@your-server
The official dashboard notes describe the same tunnel at docs.openclaw.ai/web/dashboard. Binding the gateway to every interface on a public server is a separate choice, and it needs gateway auth turned on.
Advertisement
Tech Pulse Daily
Developer Action Items
- ☐ Confirm you are on the same computer as the gateway, or open an SSH tunnel before using 127.0.0.1:18789.
- ☐ Run openclaw gateway status before editing config.
- ☐ Treat “address already in use” as a port conflict, and ECONNREFUSED as nothing listening.
- ☐ Do not bind the gateway to 0.0.0.0 on a public host unless gateway auth is on.
Get tomorrow's pulse first
Join engineers who read Tech Pulse before stand-up. Free, weekday mornings.
Address already in use
“Address already in use” on 127.0.0.1:18789 means a process already holds the port. ECONNREFUSED means nothing is listening. On Linux this install’s unit is clawdbot-gateway.service, not clawdbot.service: sudo systemctl enable --now clawdbot-gateway.
If the gateway is up and the page still fails
Reload the tab, then run openclaw dashboard so the desktop app picks up the current token. A 401 is an auth mismatch, not a refused connection. If status still shows no listener, run openclaw gateway start again.
Advertisement