OpenClaw Gateway DX

Diagnose, fix, and document openclaw gateway issues. Covers both main (port 18789) and vesper profile (port 18999) gateways.

When to Use

• Gateway not starting or crash-looping
• TUI/CLI can't connect (pairing required, password mismatch, device token mismatch)
• Gateway unresponsive or high memory
• After openclaw version upgrades
• User says "openclaw is stuck" or similar

Triage Protocol

Run these in parallel to assess state:

# 1. What's listening?
lsof -i :18789 -i :18999 2>/dev/null | grep LISTEN