Description

On a fresh Windows-on-ARM machine, bootstrap-windows.ps1 registers Ubuntu-24.04 at handoff and reports Windows preparation completed successfully, but does NOT enable Docker Desktop's "Enable integration with additional distros" toggle for the newly-registered Ubuntu-24.04. The user then runs the Linux installer inside Ubuntu, the install completes, and nemoclaw onboard immediately fails preflight ([1/8]) with Docker is not reachable. Please fix Docker and try again.

Root-cause hint: scripts/bootstrap-windows.ps1 has Ensure-DockerWslIntegration, but the call is skipped when InstallDistroAtHandoff is true (scripts/bootstrap-windows.ps1:863-867) — i.e. exactly the fresh-machine path on ARM where Ubuntu-24.04 wasn't pre-registered. The user must then manually toggle Settings > Resources > WSL integration > Ubuntu-24.04 in Docker Desktop and run wsl --shutdown.

Environment

Device:        Windows on ARM (DESKTOP-BBRUTSP)
OS:            Windows 11 ARM
Architecture:  arm64
Node.js:       v22.22.3
npm:           10.9.8
Docker:        Docker Desktop 4.74.0 (arm64 build, auto-selected by winget)
OpenShell CLI: Installed via NemoClaw installer (version not captured in log)
NemoClaw:      Installed from main / latest at 2026-05-27
OpenClaw:      N/A (onboard not completed)

Steps to Reproduce

1. On a fresh Windows-on-ARM machine (no pre-existing Ubuntu-24.04 WSL distro), open PowerShell.
2. Run:

   Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/NVIDIA/NemoClaw/main/scripts/bootstrap-windows.ps1' -OutFile "$env:TEMP\bootstrap-windows.ps1"; powershell.exe -ExecutionPolicy Bypass -File "$env:TEMP\bootstrap-windows.ps1"

3. Bootstrap completes (Windows preparation completed successfully); an Ubuntu window opens automatically.
4. Complete Ubuntu first-run user-account setup (create user, set password).
5. Inside Ubuntu, run:

   curl -fsSL 'https://www.nvidia.com/nemoclaw.sh' | bash

6. Installer completes — the [3/8] Onboarding step is auto-skipped with Host preflight found issues that will prevent onboarding right now. Install Docker.
7. Refresh PATH and run:

   source /home/lab/.bashrc
   export PATH="/home/lab/.npm-global/bin:$PATH"
   nemoclaw onboard

Expected Result

Either:

• (a) bootstrap-windows.ps1 enables Docker Desktop WSL integration for the freshly-registered Ubuntu-24.04 distro (the Ensure-DockerWslIntegration path) before declaring Windows preparation completed successfully, OR
• (b) the Linux installer / nemoclaw onboard preflight detects "Docker Desktop is running on Windows but WSL integration for this distro is OFF" and provides actionable guidance (toggle Settings > Resources > WSL integration > Ubuntu-24.04, then wsl --shutdown).

Either way, the user should not have to discover the Docker Desktop GUI toggle by themselves to get past preflight [1/8].

Actual Result

Installer completes but auto-skips onboarding:

[3/8] Onboarding
──────────────────────────────────────────────────
  Running under WSL
[WARN]  Host preflight found issues that will prevent onboarding right now.
  - Install Docker: Docker is required before onboarding can create a gateway or sandbox.
    Install Docker Engine, then rerun `nemoclaw onboard`.
[WARN]  Skipping onboarding until the host prerequisites above are fixed.

nemoclaw onboard then fails preflight:

NemoClaw Onboarding
===================

[1/8] Preflight checks
──────────────────────────────────────────────────
Docker is not reachable. Please fix Docker and try again.

Suggested fix:
- Install Docker: Docker is required before onboarding can create a gateway or sandbox.
  Install Docker Engine, then rerun `nemoclaw onboard`.
- Install OpenShell: OpenShell is required before onboarding can create or manage a gateway.
  Run the NemoClaw installer or `scripts/install-openshell.sh`.

Workaround (confirmed working): Docker Desktop → Settings → Resources → WSL integration → toggle ON Ubuntu-24.04 under "Enable integration with additional distros"; then wsl --shutdown; reopen Ubuntu; nemoclaw onboard succeeds.

Note: docs/reference/troubleshooting.mdx:1259 already documents the manual fix ("docker info fails inside WSL"), but the installer should not require this manual step on a fresh ARM machine.

Logs

Windows side (PowerShell, bootstrap-windows.ps1):
  Enabling WSL 2 Windows features...
  Feature already enabled: VirtualMachinePlatform
  Feature already enabled: Microsoft-Windows-Subsystem-Linux
  WSL distro already registered: Ubuntu-24.04        # (or: registered at handoff on a truly-fresh machine)
  Ubuntu-24.04 is already WSL 2.
  Installing Docker Desktop with winget...
  Found Docker Desktop [Docker.DockerDesktop] Version 4.74.0
  Downloading https://desktop.docker.com/win/main/arm64/227015/Docker%20Desktop%20Installer.exe
    ██████████████████████████████   542 MB /  542 MB
  Successfully installed
  Docker engine is responsive.
  Docker is reachable from WSL distro 'Ubuntu-24.04'.   # only printed on the non-handoff path
  Windows preparation completed successfully.

Ubuntu side (after first-run user setup):
  lab@DESKTOP-BBRUTSP:/mnt/c/Users/lab$ curl -fsSL 'https://www.nvidia.com/nemoclaw.sh' | bash
  ... installer completes ...
  [WARN]  Host preflight found issues that will prevent onboarding right now.
    - Install Docker: Docker is required before onboarding can create a gateway or sandbox.
  [WARN]  Skipping onboarding until the host prerequisites above are fixed.

  lab@DESKTOP-BBRUTSP:/mnt/c/Users/lab$ nemoclaw onboard
    NemoClaw Onboarding
    ===================
    [1/8] Preflight checks
    ──────────────────────────────────────────────────
    Docker is not reachable. Please fix Docker and try again.

After manually toggling Docker Desktop > Settings > Resources > WSL integration > Ubuntu-24.04 ON and running `wsl --shutdown`, `nemoclaw onboard` proceeds normally.

NVB#6228747