部署故障排查

诊断三板斧

openclaw status     # 总览
openclaw doctor     # 诊断 + 修复建议
openclaw logs -f    # 实时日志

常见问题

Gateway 启动失败

端口占用：

lsof -i :18789
kill <pid>
openclaw gateway restart

配置错误：

openclaw doctor --fix

unreachable (missing scope: operator.read)

Gateway 在跑但 auth token 缺少必要 scope：

openclaw gateway auth --scope operator.read
openclaw gateway restart

Channel 显示 disconnected

openclaw status

# Telegram：验证 token
openclaw channels add --channel telegram --token "YOUR_TOKEN"

# WhatsApp：重新扫码
openclaw channels login

内存不足 (OOM)

# Docker 构建至少需要 2GB
# 如果是 sharp 编译 OOM：
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest