Work in Progress: This troubleshooting guide may be incomplete or outdated.

🚫 Gateway Won't Start

Error when starting the ClawdBot gateway

← Back to Help

✅ Try This First

# See what's wrong
clawdbot gateway --verbose

# Or restart it
clawdbot gateway restart

Common Causes

Port already in use

Something else is using port 18789.

# Check what's using the port
# Mac/Linux:
lsof -i :18789

# Windows:
netstat -ano | findstr :18789

Fix: Use a different port:

clawdbot gateway --port 18790

Config file corrupted

Re-run the setup wizard:

clawdbot onboard

Old ClawdBot version

Update to the latest:

npm update -g clawdbot

Check Gateway Status

clawdbot gateway status

This tells you if the gateway is running and on which port.

Related Problems

Was this helpful?

Share This Fix

Ask an AI for more help