2026 年 OpenClaw Docker 在 VPS 起步排障
Exit 137 与 Control UI 报错对照表

资源前置：free -h、mem_limit 与首轮 WASM 编译「假卡死」怎么区分

OpenClaw Gateway 在容器内首次启动时常见CPU 打满但端口迟迟不开，多数属于 WASM 沙箱编译阶段而非死锁。与v2026.4 安装长文中的资源建议对齐：宿主可用内存与 mem_limit 同时过紧时，Linux OOM 会直接给出 Exit 137，日志里未必来得及打印友好错误。

1. 01

   宿主侧：在宿主机执行 free -h，确认可用内存是否长期低于约 1.5～2 GiB 的可用余量；swap 为 0 时 137 更常见。

2. 02

   Compose 侧：为服务设置 mem_limit: 2g 或更高，并避免与其它重服务同机抢内存。

3. 03

   首轮窗口：冷启动预留 3～7 分钟再判定失败；期间可用 docker logs -f 观察是否仍在编译链。

4. 04

   健康检查：healthcheck.start_period 建议至少 360s，避免 compose 在 WASM 完成前误杀重启。

5. 05

   误判止损：不要在首轮窗口内连续 docker compose restart，否则每次都会重新触发冷编译峰值。

把以上五条写进「VPS 上架 OpenClaw」Runbook 的第一页，可显著减少「教程一步步照做仍起不来」的工单量。更完整的 Gateway 分层排障见运行期三段式长文。

Control UI、127.0.0.1 绑定与反代：allowedOrigins 与 Host 头选项怎么选

在 VPS 上把 18789 暴露到公网是最常见的误配置之一。安装长文推荐容器只绑定回环地址，由 Caddy 或 Nginx 在 443 终止 TLS。Control UI 若报 non-loopback 类错误，本质是浏览器来源与 Gateway 允许的 Origin 不一致，而不是「Docker 坏了」。

{
  "gateway": {
    "mode": "local",
    "controlUi": {
      "allowedOrigins": ["https://openclaw.example.com"]
    }
  }
}

可复制 compose 骨架、十条上线勾选与「笔记本挂机」替代方案

下列三条为社区与生产环境常见的核对区间，请用你们宿主机的真实监控数据替换；写进 README 可避免新人重复踩坑。

• 首轮启动预算：冷启动至少预留 3～7 分钟再打开工单；短于 3 分钟就重启会放大 137。
• 内存水位：单实例建议宿主可用内存长期高于 2 GiB 余量；低于该区间优先考虑升配而非继续堆功能。
• 日志轮转：Docker json-file 限制 单文件 ≤10MiB、保留 ≤3 个，避免磁盘写满导致二次故障。

services:
  openclaw:
    image: ghcr.io/openclaw/openclaw:latest
    restart: unless-stopped
    mem_limit: 2g
    ports:
      - "127.0.0.1:18789:18789"
    volumes:
      - ${HOME}/.openclaw:/home/node/.openclaw
    env_file:
      - .env
    healthcheck:
      test: ["CMD", "curl", "-f", "http://127.0.0.1:18789/health"]
      interval: 60s
      timeout: 15s
      retries: 5
      start_period: 360s

在笔记本上长期跑 Gateway 往往被休眠、合盖与不稳定上行拖累；纯靠家用宽带也很难给出可验收 SLA。相较之下，按周期计费的云端 Mac Mini 节点更适合承载「需要与 VPS 上 OpenClaw 协同、又要图形或 Xcode 侧操作」的混合工作流。

若你希望Docker 网关稳定在线，同时把重编译或真机相关步骤放到可合同化的 macOS 环境，继续维护自购固定资产往往在采购与多地同步上不占优。对需要7×24 可验收节点与弹性规格 的场景，VpsMesh 的 Mac Mini 云端租赁通常是更优解：把 VPS 上的 OpenClaw 与专用远程 Mac 的分工写进架构图，再用价格页与订购页做容量评审，比口头承诺更容易落地。