Summary

nemoclaw onboard fails on Ubuntu 24.04 environments with cgroup v2 enabled, surfacing errors such as Kubernetes namespace not ready, openat2 ... pids.max: no such file or directory, and container manager startup failures.

Problem

This is the top blocker for new users on modern Linux hosts, including DGX Spark, WSL2, and fresh Ubuntu 24.04 systems. The fix is known, but NemoClaw neither detects the condition nor guides the user to a supported recovery path.

Expected behavior

Onboarding should detect incompatible Docker cgroup namespace configuration before attempting cluster startup and either fix it automatically or fail with precise remediation steps.

Acceptance criteria

• Preflight detects incompatible cgroup v2 Docker configuration.
• Onboarding fails early with a targeted remediation message that includes the required Docker daemon setting.
• Troubleshooting docs cover the exact error signatures and the recovery steps.
• A regression test or scripted environment check exists for the Ubuntu 24.04 case.