🦞OpenClaw Guide
Gateway

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:

bash
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:

  1. Another gateway is already running — Often the old clawdbot service after an upgrade
  2. Port conflict — Something else is using port 18789
  3. Disk full — No space to write config or logs
  4. Telegram connection failure — Gateway crashes on startup trying to connect
  5. Invalid config — Syntax error in openclaw.json

The Fix

First, run the doctor command to diagnose:

bash
openclaw doctor --fix

Check for duplicate services (common after upgrading from clawdbot):

bash
systemctl --user list-units | grep -E 'clawdbot|openclaw|gateway'pgrep -af 'openclaw|clawdbot'

If you find old services, stop and disable them:

bash
systemctl --user stop clawdbot-gateway.servicesystemctl --user disable clawdbot-gateway.service

Check disk space:

bash
df -h

If disk is full, clean up old logs:

bash
rm -rf /tmp/openclaw/openclaw-*.log

Try starting the gateway manually to see errors:

bash
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.

Deploy Now — 50% Off First Month →

🔥 Your AI should run your business, not just answer questions.

We'll show you how.Free to join.

Join Vibe Combinator →

📋 Quick Commands

CommandDescription
openclaw doctor --fixDiagnose and fix common issues
openclaw gateway status --deepDetailed gateway status
openclaw gateway start --foregroundStart with visible logs
lsof -i :18789Check what's using the port

Related Issues

🐙 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 →