Skip to content
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions ci/platform-matrix.json
Original file line number Diff line number Diff line change
Expand Up @@ -62,11 +62,11 @@
{
"name": "DGX OS (Station)",
"runtimes": ["Docker"],
"status": "deferred",
"status": "caveated",
"prd_priority": "P1",
"ci_tested": false,
"prerequisites_notes": "Deferred. For evaluation on a qualifying DGX Station GB300, see [Additional Setup for DGX Station](additional-setup/dgx-station-preparation) before the Quickstart.",
"notes": "The PRD marks this platform as P1. DGX Station remains Deferred without dedicated CI. Direct-GPU policies expose only the exact read-only BDF directory for each discovered NVIDIA display-class PCI device plus required existing topology and module paths; they do not expose `/sys`, the PCI parent subtree, or sysfs write access. During physical validation, reads of `/sys/fs/cgroup/cgroup.controllers` and `/sys/class/net/lo/address` remained denied. One physical DGX OS `7.5.0` GB300 validation completed with released OpenShell `0.0.85`, local Nemotron Ultra serving, sandbox `cuInit(0)`, and a Hermes write/read file-tool task. Repeat clean-host qualification and CI coverage remain pending. For canonical hardware qualification, image requirements, preparation, repair limits, reboot handoff, and the explicit temporary metadata override, see [Prepare DGX Station to Install NemoClaw](../get-started/additional-setup/dgx-station-preparation)."
"prerequisites_notes": "Tested with limitations on one qualifying DGX Station GB300. Dual-Station configurations are not yet validated. See [Additional Setup for DGX Station](additional-setup/dgx-station-preparation) before the Quickstart.",
"notes": "The PRD marks this platform as P1. One DGX Station GB300 running DGX OS `7.5.0` passed physical validation with released OpenShell `0.0.85`, local Nemotron Ultra serving, sandbox `cuInit(0)`, and a Hermes write/read file-tool task. A dual-Station configuration has not been validated, and dedicated CI coverage is not available. Direct-GPU policies expose only the exact read-only BDF directory for each discovered NVIDIA display-class PCI device plus required existing topology and module paths; they do not expose `/sys`, the PCI parent subtree, or sysfs write access. During physical validation, reads of `/sys/fs/cgroup/cgroup.controllers` and `/sys/class/net/lo/address` remained denied. For canonical hardware qualification, image requirements, preparation, repair limits, reboot handoff, and the explicit temporary metadata override, see [Prepare DGX Station to Install NemoClaw](../get-started/additional-setup/dgx-station-preparation)."
},
{
"name": "NVIDIA RTX (consumer and Pro workstation GPUs)",
Expand Down Expand Up @@ -149,7 +149,7 @@
"name": "Local vLLM (managed install/start)",
"status": "caveated",
"endpoint_type": "Local OpenAI-compatible",
"notes": "Appears by default on DGX Spark and qualifying DGX Station GB300 hosts. DGX Station remains Deferred. For canonical Station qualification and host preparation, see the Additional Setup page for [OpenClaw](/user-guide/openclaw/get-started/additional-setup/dgx-station-preparation), [Hermes](/user-guide/hermes/get-started/additional-setup/dgx-station-preparation), or [Deep Agents](/user-guide/deepagents/get-started/additional-setup/dgx-station-preparation). Generic Linux NVIDIA GPU hosts require `NEMOCLAW_EXPERIMENTAL=1` or `NEMOCLAW_PROVIDER=install-vllm`, NVIDIA Container Toolkit, and CDI. NemoClaw pins runtime images to immutable digests. Station Express defaults to `nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-NVFP4`; `--station-deepseek` selects `deepseek-ai/DeepSeek-V4-Flash`. Direct managed-vLLM defaults are `nvidia/Qwen3.6-35B-A3B-NVFP4` on DGX Spark, `deepseek-ai/DeepSeek-V4-Flash` on DGX Station, and `nvidia/NVIDIA-Nemotron-3-Nano-4B-FP8` on generic Linux NVIDIA GPU hosts. Image pulls from `nvcr.io` require NGC registry login."
"notes": "Appears by default on DGX Spark and qualifying DGX Station GB300 hosts. DGX Station is Tested with limitations on one physical DGX Station GB300; dual-Station configurations are not yet validated. For canonical Station qualification and host preparation, see the Additional Setup page for [OpenClaw](/user-guide/openclaw/get-started/additional-setup/dgx-station-preparation), [Hermes](/user-guide/hermes/get-started/additional-setup/dgx-station-preparation), or [Deep Agents](/user-guide/deepagents/get-started/additional-setup/dgx-station-preparation). Generic Linux NVIDIA GPU hosts require `NEMOCLAW_EXPERIMENTAL=1` or `NEMOCLAW_PROVIDER=install-vllm`, NVIDIA Container Toolkit, and CDI. NemoClaw pins runtime images to immutable digests. Station Express defaults to `nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-NVFP4`; `--station-deepseek` selects `deepseek-ai/DeepSeek-V4-Flash`. Direct managed-vLLM defaults are `nvidia/Qwen3.6-35B-A3B-NVFP4` on DGX Spark, `deepseek-ai/DeepSeek-V4-Flash` on DGX Station, and `nvidia/NVIDIA-Nemotron-3-Nano-4B-FP8` on generic Linux NVIDIA GPU hosts. Image pulls from `nvcr.io` require NGC registry login."
}
],

Expand Down
9 changes: 6 additions & 3 deletions docs/changelog/2026-07-14.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,18 @@

## v0.0.83

NemoClaw v0.0.83 makes shared inference route changes explicit and safe, restores DGX Station GB300 express setup, warns on risky local vLLM configurations, and fixes several onboarding and platform edge cases.
NemoClaw v0.0.83 restores the DGX Station GB300 express-install path without changing its Deferred support status.
It also makes shared inference route changes explicit and safe, warns on risky local vLLM configurations, and fixes several onboarding and platform edge cases.

- Shared inference route changes are now explicit and fail-safe.
When multiple sandboxes share a gateway, onboarding warns immediately before re-pointing the live route and fails closed before replacing a provider-global identity used by another sandbox.
Status output shows each sandbox's recorded route, the live route, and whether `connect` can safely restore a drifted route.
For more information, refer to [Use Shared Gateway Routes](/user-guide/openclaw/inference/manage-inference/use-shared-gateway-routes) and [View Active Inference Route](/user-guide/openclaw/inference/manage-inference/view-active-inference-route).
- DGX Station GB300 systems enter the express-install path, and managed vLLM storage preflight treats verified shortages as advisory during express and other non-interactive setup while the checks mature.
- Qualifying DGX Station GB300 systems enter the express-install path.
This path availability does not change DGX Station's Deferred support status.
Managed vLLM storage preflight treats verified shortages as advisory during express and other non-interactive setup while the checks mature.
Interactive setup still requires explicit confirmation, and non-interactive setup still stops when model-cache capacity is inconclusive.
Comment thread
miyoungc marked this conversation as resolved.
For more information, refer to [Set Up vLLM](/user-guide/openclaw/inference/local-inference/set-up-vllm) and [NemoClaw CLI Commands Reference](/user-guide/openclaw/reference/commands).
For more information, refer to [Set Up vLLM](/user-guide/openclaw/inference/local-inference/set-up-vllm), [Platform Support and Launch Claims](/user-guide/openclaw/reference/platform-support), and [NemoClaw CLI Commands Reference](/user-guide/openclaw/reference/commands).
- Onboarding warns when a bring-your-own vLLM server on DGX Spark appears to serve a large unquantized model that may exhaust GPU memory under agent tool-call load.
The warning is suppressed for the managed Spark vLLM recipe.
For more information, refer to [Set Up vLLM](/user-guide/openclaw/inference/local-inference/set-up-vllm) and [Troubleshooting](/user-guide/openclaw/reference/troubleshooting).
Expand Down
6 changes: 3 additions & 3 deletions docs/get-started/dgx-station-preparation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -126,12 +126,12 @@ Aside from the installer's separately disclosed `docker`-group membership grant
The AI Developer Tools path can also leave the packaged CDI refresh units enabled when it repairs a missing device.

One physical DGX OS `7.5.0` GB300 validation completed with released OpenShell `0.0.85`, local Nemotron Ultra serving, sandbox `cuInit(0)`, and a Hermes write/read file-tool task.
Repeat qualification from a clean host and CI coverage remain pending.
A dual-Station configuration has not been validated, and dedicated CI coverage is not available.
For the complete support status and direct GPU policy boundaries, see [Platform Support](../../reference/platform-support).

<Warning title="DGX Station Support Status">
DGX Station remains Deferred.
Repeat qualification from a clean host and CI coverage remain pending before any support-status promotion.
DGX Station is Tested with limitations on the single-Station configuration above.
Dual-Station configurations are not yet validated.
</Warning>

## Next Step
Expand Down
11 changes: 6 additions & 5 deletions docs/get-started/prerequisites.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -82,15 +82,15 @@ Refer to the [troubleshooting guide](../reference/troubleshooting) for the overr

## Platforms

The following table lists tested platforms and deferred platforms with a documented preparation path.
A Deferred row is available for evaluation only and is not a support claim.
The following table lists platforms with a documented installation path.
A Tested with limitations row applies only to the configuration in its notes.
The table comes from [`ci/platform-matrix.json`](https://github.com/NVIDIA/NemoClaw/blob/main/ci/platform-matrix.json), the single source of truth kept in sync by CI and QA.

{/* platform-matrix:begin */}
| OS | Container runtime | Status | Notes |
|----|-------------------|--------|-------|
| DGX OS (Spark) | Docker | Tested | Use the standard installer and `$$nemoclaw onboard`. For an end-to-end walkthrough with local inference, see the [NVIDIA Spark playbook](https://build.nvidia.com/spark/nemoclaw). |
| DGX OS (Station) | Docker | Deferred | Deferred. For evaluation on a qualifying DGX Station GB300, see [Additional Setup for DGX Station](additional-setup/dgx-station-preparation) before the Quickstart. |
| DGX OS (Station) | Docker | Tested with limitations | Tested with limitations on one qualifying DGX Station GB300. Dual-Station configurations are not yet validated. See [Additional Setup for DGX Station](additional-setup/dgx-station-preparation) before the Quickstart. |
| Linux | Docker | Tested | Primary tested path. Ubuntu 24.04 has host-level onboarding validation. A digest-pinned Ubuntu 26.04 userspace lane builds the CLI and runs preflight, installer, and platform contracts on eligible main pushes; Docker-host, AppArmor, Landlock, and live onboarding validation on 26.04 remain pending. Other distros (Ubuntu 22.04, Fedora, Rocky, Alma, NixOS, Arch) may work but are not validated. |
| macOS (Apple Silicon) | Colima, Docker Desktop | Tested with limitations | Start the container runtime (Colima or Docker Desktop) before running the installer. Homebrew Colima users must install both Colima and the Docker CLI (`brew install colima docker`) before `docker info` can work. Xcode Command Line Tools (`xcode-select --install`) are typically required for Node native modules during install. NemoClaw recommends them but does not enforce them during preflight. |
| Windows WSL2 | Docker Desktop (WSL backend) | Tested with limitations | Requires WSL2 with Docker Desktop backend. See [Additional Setup for Windows Machines](additional-setup/windows-preparation) before the Quickstart. |
Expand All @@ -105,8 +105,9 @@ Use only the page that matches your host.

### DGX Station Express Preparation

DGX Station remains Deferred.
If you are evaluating a qualifying DGX Station GB300, follow [Prepare DGX Station to Install NemoClaw](additional-setup/dgx-station-preparation) before the Quickstart.
DGX Station is Tested with limitations on one qualifying DGX Station GB300.
Dual-Station configurations are not yet validated.
Follow [Prepare DGX Station to Install NemoClaw](additional-setup/dgx-station-preparation) before the Quickstart.

### Windows Preparation

Expand Down
10 changes: 6 additions & 4 deletions docs/get-started/quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -125,7 +125,8 @@ Use these details when your first-run path needs more control.
[Prepare DGX Station to Install NemoClaw](additional-setup/dgx-station-preparation) defines Station qualification, generic Ubuntu preparation, stock DGX OS validation, repair limits, and reboot handoff.
By default, unknown versions, unsafe release markers, NVIDIA BaseOS images, and other Station generations stop before host preparation; set `NEMOCLAW_PROVIDER` or `NEMOCLAW_NO_EXPRESS=1` to bypass Station host automation.
For an explicit temporary override on genuine Station GB300 hardware with unrecognized release metadata, follow the `--force-station-install` safeguards in the Station preparation guide.
One physical DGX OS `7.5.0` GB300 validation completed, but Station remains Deferred pending repeat clean-host qualification and CI coverage.
DGX Station is Tested with limitations on one DGX Station GB300 running DGX OS `7.5.0`.
Dual-Station configurations are not yet validated, and dedicated CI coverage is not available.
Pass `--station-deepseek` to use DeepSeek V4 Flash for a Station demo instead; the flag selects the interactive prompt and requires terminal access.
Refer to [Platform Support](../reference/platform-support) and [Choose an Inference Provider](../inference/learn-and-choose/choose-inference-provider) for the current platform behavior.

Expand Down Expand Up @@ -200,7 +201,8 @@ Use these details when your first-run path needs more control.
If preparation requires a reboot or a new login, run the printed command to restore the recorded revision, agent, model, sandbox, policy tier, and gateway, dashboard, and vLLM ports without repeating the Express prompt.
Generic Ubuntu preparation can change pinned packages and then exits with status `10`; reboot, sign in, and run that printed command to resume.
Stock DGX OS validation checks the factory stack in place without installing packages, restarting services, or rewriting the Docker runtime.
One physical DGX OS `7.5.0` GB300 validation completed, but Station remains Deferred pending repeat clean-host qualification and CI coverage.
DGX Station is Tested with limitations on one DGX Station GB300 running DGX OS `7.5.0`.
Dual-Station configurations are not yet validated, and dedicated CI coverage is not available.
To select DeepSeek V4 Flash while retaining the one-confirmation Station express flow, run `curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash -s -- --station-deepseek`.
The `--station-deepseek` flag requires an interactive terminal; in a `curl | bash` pipeline, `/dev/tty` must be available.
The temporary `--force-station-install` flag has the same terminal requirement and bypasses only DGX release-metadata qualification on genuine Station GB300 hardware.
Expand All @@ -223,8 +225,8 @@ Use these details when your first-run path needs more control.
Set `NEMOCLAW_NO_EXPRESS=1` to skip the express prompt, or set `NEMOCLAW_PROVIDER` before launching the installer to choose a provider yourself.

<Warning>
Express install automates the configuration but does not change DGX Station's Deferred support status.
One physical DGX OS 7.5 GB300 validation completed; repeat qualification from a clean host and CI coverage remain pending.
DGX Station is Tested with limitations on one DGX Station GB300 running DGX OS `7.5.0`.
Express install does not extend that validation to dual-Station configurations.
</Warning>

The installer auto-launches `nemoclaw onboard` when it can find the new binary.
Expand Down
2 changes: 1 addition & 1 deletion docs/inference/choose-inference-provider.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Use this status table to distinguish validated provider integrations from adapte
| Local Ollama | Tested with limitations | Local Ollama API | Available when Ollama is installed or running on the host. Validated default models: `qwen3.6:35b` (high VRAM), `nemotron-3-nano:30b` (medium VRAM), `qwen3.5:9b` (low VRAM fallback). |
| Local NVIDIA NIM | Experimental | Local OpenAI-compatible | Requires `NEMOCLAW_EXPERIMENTAL=1` and a NIM-capable NVIDIA GPU. Host must have the NVIDIA Container Toolkit installed and a CDI spec present (`onboard` asserts CDI presence with `assertCdiNvidiaGpuSpecPresent`, `src/lib/onboard/fatal-runtime-preflight.ts`). NIM images pull from `nvcr.io` and require NGC registry login. NemoClaw gates this path behind the experimental flag because it does not auto-select a NIM image for the host today. You must explicitly pick from the validated image list. On Linux arm64 DGX Spark and DGX Station hosts, onboarding warns that some NIM images may not publish a `linux/arm64` manifest; the warning is advisory, and the selected image pull can still fail when the registry has no matching platform manifest. Managed vLLM has host-specific default models and is not gated on the same boxes. Validated images referenced in `src/lib/inference/config.ts` and `nemoclaw/src/index.ts`: `nvidia/nemotron-3-super-120b-a12b` (default cloud model), `nvidia/nemotron-3-nano-30b-a3b`, `nvidia/llama-3.3-nemotron-super-49b-v1.5`. |
| Local vLLM (already running) | Tested with limitations | Local OpenAI-compatible | Appears in the onboarding menu when NemoClaw detects a server already on `localhost:8000`. No flag required. Model is whatever the existing server serves. |
| Local vLLM (managed install/start) | Tested with limitations | Local OpenAI-compatible | Appears by default on DGX Spark and qualifying DGX Station GB300 hosts. DGX Station remains Deferred. For canonical Station qualification and host preparation, see the Additional Setup page for [OpenClaw](/user-guide/openclaw/get-started/additional-setup/dgx-station-preparation), [Hermes](/user-guide/hermes/get-started/additional-setup/dgx-station-preparation), or [Deep Agents](/user-guide/deepagents/get-started/additional-setup/dgx-station-preparation). Generic Linux NVIDIA GPU hosts require `NEMOCLAW_EXPERIMENTAL=1` or `NEMOCLAW_PROVIDER=install-vllm`, NVIDIA Container Toolkit, and CDI. NemoClaw pins runtime images to immutable digests. Station Express defaults to `nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-NVFP4`; `--station-deepseek` selects `deepseek-ai/DeepSeek-V4-Flash`. Direct managed-vLLM defaults are `nvidia/Qwen3.6-35B-A3B-NVFP4` on DGX Spark, `deepseek-ai/DeepSeek-V4-Flash` on DGX Station, and `nvidia/NVIDIA-Nemotron-3-Nano-4B-FP8` on generic Linux NVIDIA GPU hosts. Image pulls from `nvcr.io` require NGC registry login. |
| Local vLLM (managed install/start) | Tested with limitations | Local OpenAI-compatible | Appears by default on DGX Spark and qualifying DGX Station GB300 hosts. DGX Station is Tested with limitations on one physical DGX Station GB300; dual-Station configurations are not yet validated. For canonical Station qualification and host preparation, see the Additional Setup page for [OpenClaw](/user-guide/openclaw/get-started/additional-setup/dgx-station-preparation), [Hermes](/user-guide/hermes/get-started/additional-setup/dgx-station-preparation), or [Deep Agents](/user-guide/deepagents/get-started/additional-setup/dgx-station-preparation). Generic Linux NVIDIA GPU hosts require `NEMOCLAW_EXPERIMENTAL=1` or `NEMOCLAW_PROVIDER=install-vllm`, NVIDIA Container Toolkit, and CDI. NemoClaw pins runtime images to immutable digests. Station Express defaults to `nvidia/NVIDIA-Nemotron-3-Ultra-550B-A55B-NVFP4`; `--station-deepseek` selects `deepseek-ai/DeepSeek-V4-Flash`. Direct managed-vLLM defaults are `nvidia/Qwen3.6-35B-A3B-NVFP4` on DGX Spark, `deepseek-ai/DeepSeek-V4-Flash` on DGX Station, and `nvidia/NVIDIA-Nemotron-3-Nano-4B-FP8` on generic Linux NVIDIA GPU hosts. Image pulls from `nvcr.io` require NGC registry login. |
{/* provider-status:end */}

## Hosted Providers
Expand Down
Loading
Loading