diff --git a/.agents/skills/nemoclaw-user-get-started/SKILL.md b/.agents/skills/nemoclaw-user-get-started/SKILL.md index b2edd2dc74..f17438278b 100644 --- a/.agents/skills/nemoclaw-user-get-started/SKILL.md +++ b/.agents/skills/nemoclaw-user-get-started/SKILL.md @@ -197,7 +197,7 @@ For example, if you picked an OpenAI-compatible endpoint, the summary looks like Web search: disabled Messaging: none Sandbox name: my-gpt-claw - Note: Sandbox build takes ~6 minutes on this host. + Note: Sandbox build typically takes 5–15 minutes on this host. ────────────────────────────────────────────────── Web search and messaging channels will be prompted next. Apply this configuration? [Y/n]: diff --git a/.agents/skills/nemoclaw-user-reference/references/troubleshooting.md b/.agents/skills/nemoclaw-user-reference/references/troubleshooting.md index a0d5385cdc..6bea6d7395 100644 --- a/.agents/skills/nemoclaw-user-reference/references/troubleshooting.md +++ b/.agents/skills/nemoclaw-user-reference/references/troubleshooting.md @@ -305,6 +305,23 @@ If neither is found, verify that Colima is running: $ colima status ``` +### Sandbox build is slow or hangs (under-provisioned container runtime) + +Default Colima ships with 2 vCPU and 2 GiB of memory, which is not enough headroom for the BuildKit-driven sandbox image build. +On macOS Apple Silicon, the build can stall part-way through with no progress and no error, leaving the wizard waiting indefinitely. + +Preflight inspects `docker info` for `NCPU` and `MemTotal` and prints a warning when the runtime falls below 4 vCPU or 8 GiB. +On Colima, raise the resources before re-running onboard: + +```console +$ colima stop +$ colima start --cpu 6 --memory 12 --disk 100 +``` + +On Docker Desktop, raise CPU and memory limits in *Settings → Resources*, then apply and restart. + +To silence the warning when the host is intentionally small, set `NEMOCLAW_IGNORE_RUNTIME_RESOURCES=1` before running `nemoclaw onboard`. + ### Re-onboard fails because port 18789 is held by SSH After destroying a sandbox and gateway, the SSH port-forward process for the @@ -608,7 +625,7 @@ This is expected. The sandbox's OpenClaw configuration (`/sandbox/.openclaw/openclaw.json`) is baked into the container image at build time. NemoClaw's sandbox entrypoint installs a guard that intercepts `openclaw config set` and `openclaw config unset` and prints an actionable error, because changes made inside the running sandbox do not persist across rebuilds. -To change your configuration, exit the sandbox and rerun onboarding: +For most configuration changes, exit the sandbox and rerun onboarding: ```console $ nemoclaw onboard @@ -617,6 +634,14 @@ $ nemoclaw onboard If NemoClaw reports a resumable failed onboarding session, run `nemoclaw onboard --resume` instead. This rebuilds the sandbox with your updated settings. +For advanced live edits, use the host-side config command instead of running `openclaw config set` inside the sandbox: + +```console +$ nemoclaw config set --key --value '' --restart +``` + +Host-side `config set` validates any HTTP or HTTPS URLs in the new value, including URLs nested inside JSON objects or arrays. NemoClaw rejects loopback, private, reserved, and internal hosts; DNS names must resolve successfully and must not resolve to private/internal addresses. HTTP URLs are written with the validated IP address pinned to reduce DNS-rebinding risk. Avoid putting credentials in config values; rotate provider credentials with `nemoclaw config rotate-token` instead. + ### `openclaw doctor --fix` cannot repair Discord channel config inside the sandbox This is expected in NemoClaw-managed sandboxes.