Skip to content

[NemoClaw][macOS][Onboard] nemoclaw onboard does not auto-restart Docker (Colima) when daemon is stopped — hangs indefinitely at gateway health #2347

@zNeill

Description

@zNeill

Description

[Summary]
nemoclaw onboard does not auto-restart the Docker runtime (Colima on macOS) when the daemon is stopped. After gateway startup fails at [2/8], onboard loops on "Waiting for gateway health..." with no timeout and no attempt to start Docker. User must Ctrl+C and manually start Colima.

[Environment]
Device: MacBook Pro (Apple M4)
OS: macOS (Darwin 25.1.0, arm64)
Architecture: arm64
Node.js: v23.10.0
npm: 11.3.0
Docker: Colima (Docker version 27.4.0)
OpenShell CLI: openshell 0.0.32
NemoClaw: v0.0.23
OpenClaw: 2026.4.2 (d74a122)

[Steps to Reproduce]

  1. Run: colima stop
  2. Verify Docker is unreachable: docker ps
  3. Run: nemoclaw onboard
  4. Wait at [2/8] Starting OpenShell gateway

[Expected Behavior]
Onboard detects that Docker is stopped and either:
(a) Auto-restarts the Docker runtime (colima start on macOS, systemctl start docker on Linux), then continues, OR
(b) Exits at [1/8] with a clear message: "Docker is not running. Start it with: colima start"

[Actual Behavior]
[2/8] Starting OpenShell gateway
Gateway start returned before healthy:
Error: Failed to create Docker client.
Socket not found: /var/run/docker.sock
Waiting for gateway health... (hangs indefinitely, no timeout, no restart attempt)

Must be killed with Ctrl+C.

[Logs]
No sandbox logs — failure is pre-sandbox at onboard stage.
Terminal output captured above.

[Notes]
No auto-restart code exists in onboard.js or preflight.js.
grep for "colima start", "systemctl start docker" in both files returns empty.
The gateway health wait loop has no timeout and no socket-presence check.

Bug Details

Field Value
Priority Unprioritized
Action Dev - Open - To fix
Disposition Open issue
Module Machine Learning - NemoClaw
Keyword NemoClaw, NEMOCLAW_GH_SYNC_APPROVAL, NemoClaw_Install

[NVB#6107562]

Metadata

Metadata

Assignees

Labels

NV QABugs found by the NVIDIA QA Teamarea: installInstall, setup, prerequisites, or uninstall flowarea: onboardingOnboarding FSM, provider setup, sandbox launch, or first-run flowplatform: macosAffects macOS, including Apple Silicon

Type

No fields configured for Bug.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions