Errors / RPC Probe Failed

Fix: RPC Probe Failed

Error: "rpc probe failed"

What It Means

The OpenClaw CLI tried to connect to the gateway's RPC endpoint but got no response. The gateway might not be running, or there's a network/port issue preventing the connection.

Common Causes

•Gateway service is not running
•Wrong port configured (default: 18789)
•Firewall blocking the connection
•Gateway crashed and needs restart

Ask Your Agent to Fix This

Copy this prompt and send it to your OpenClaw agent:

Check if the OpenClaw gateway is running. If it's not, start it with "openclaw gateway start" and verify it's responding on the RPC endpoint.

How to Fix It

1. Start the Gateway

openclaw gateway start

2. Check Gateway Status

openclaw gateway status

openclaw doctor

3. Check the Port

Make sure you're using the correct port (default 18789):

curl http://localhost:18789/health

How to Prevent This

✓Install the gateway as a service: openclaw onboard --install-daemon
✓Run openclaw gateway status before running commands

Related Errors

ECONNREFUSED

Gateway not running.

Gateway Connect Failed

Related connection error.

Related Guides

Getting Started

Full setup guide.

Still having trouble?

Ask on Discord