Gateway Won't Start — Troubleshooting Guide
The OpenClaw gateway crashes on startup or won't run. Port conflicts, disk space, or duplicate services.
⚠️ The Problem
The OpenClaw gateway fails to start or crashes immediately after starting. You might see:
Port 18789 is already in useENOSPC: no space left on devicegateway closed (1006 abnormal closure)Or the service shows as "activating" but never becomes "active".
🔍 Why This Happens
Several things can prevent the gateway from starting:
- Another gateway is already running — Often the old
clawdbotservice after an upgrade - Port conflict — Something else is using port 18789
- Disk full — No space to write config or logs
- Telegram connection failure — Gateway crashes on startup trying to connect
- Invalid config — Syntax error in openclaw.json
✅ The Fix
First, run the doctor command to diagnose:
openclaw doctor --fixCheck for duplicate services (common after upgrading from clawdbot):
systemctl --user list-units | grep -E 'clawdbot|openclaw|gateway'pgrep -af 'openclaw|clawdbot'If you find old services, stop and disable them:
systemctl --user stop clawdbot-gateway.servicesystemctl --user disable clawdbot-gateway.serviceCheck disk space:
df -hIf disk is full, clean up old logs:
rm -rf /tmp/openclaw/openclaw-*.logTry starting the gateway manually to see errors:
openclaw gateway start --foreground🚀 Skip the setup. OpenClaw Cloud is ready in 60 seconds.
No server. No SSH. No config files. Just connect your channel and go.
🔥 Your AI should run your business, not just answer questions.
We'll show you how.Free to join.
📋 Quick Commands
| Command | Description |
|---|---|
| openclaw doctor --fix | Diagnose and fix common issues |
| openclaw gateway status --deep | Detailed gateway status |
| openclaw gateway start --foreground | Start with visible logs |
| lsof -i :18789 | Check what's using the port |
Related Issues
📚 You Might Also Like
OpenClaw Gateway Token Security: The Master Key You're Probably Mishandling
Your OpenClaw gateway token is the master key to your entire setup. Anyone who has it can access your dashboard, read your conversations, run commands throug...
Telegram
The easiest way to get started. Full bot support with groups, reactions, inline buttons, and rich media. Set up in under 10 minutes.
Cheapest Way to Host OpenClaw 24/7 (Under $5/Month)
Get 24/7 AI assistant hosting for less than a coffee. Compare all options from free to premium.
AI Assistant for Small Business Owners
Stop working IN the business. Start working ON it.
🐙 Your AI should run your business.
Weekly live builds + template vault. We'll show you how to make AI actually work.Free to join.
Join Vibe Combinator →