Gateway 启动失败：端口 18789 被占用 EADDRINUSE

症状

运行 openclaw gateway start 时报错：

Error: listen EADDRINUSE: address already in use :::18789

Gateway 无法启动，其他服务占用了默认端口。

原因

端口 18789 被其他进程占用，常见原因：

• 之前的 OpenClaw 进程没有正确关闭
• 其他应用占用了同一端口

解法

方案一：找到并关闭占用进程

# macOS / Linux
lsof -i :18789
# 找到 PID 后
kill -9 <PID>

# Windows (WSL2)
netstat -ano | findstr :18789
taskkill /PID <PID> /F

方案二：换一个端口

openclaw gateway start --port 18790

或者在配置文件中修改：

// ~/.openclaw/openclaw.json
{
  "gateway": {
    "port": 18790
  }
}

验证修复

openclaw gateway status
# 应显示 Gateway running on port 18790