From 22076a18e7f7bc311d0f756bcfc73e6b54bb0685 Mon Sep 17 00:00:00 2001 From: Charan Jagwani Date: Fri, 8 May 2026 07:34:01 -0700 Subject: [PATCH 1/2] docs(reference): document OpenClaw build-time version pin (#2635) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Closes #2635 by documenting the existing build-time pin policy that satisfies the ticket's "OpenClaw version is pinned and documented in the release notes" acceptance criterion. The pin and detection machinery already exist; only the user-facing documentation was missing. The new "Checking the OpenClaw version" subsection under `nemoclaw status` in commands.md explains: - OpenClaw is pinned at build time via `min_openclaw_version` in `nemoclaw-blueprint/blueprint.yaml`; the Dockerfile upgrades the cached base image to that version on rebuild. - Existing sandboxes do not auto-upgrade — users rebuild to pick up a newer pin. - `nemoclaw status` prints the running OpenClaw version on the `Agent` line. - Stale sandboxes get an `Update` line in `status` and `connect` pointing at `nemoclaw rebuild`. No code change. The build-time pin (Dockerfile:60-83), the version probe (src/lib/sandbox-version.ts), and the staleness warning wiring into status/connect/doctor (src/lib/actions/sandbox/status.ts:107 prints the Agent line; status/connect emit the staleness warning) are all on main today. Signed-off-by: Charan Jagwani --- docs/reference/commands.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/reference/commands.md b/docs/reference/commands.md index 31be785909f..e57e80a93be 100644 --- a/docs/reference/commands.md +++ b/docs/reference/commands.md @@ -354,6 +354,24 @@ The command also tails `/tmp/gateway.log` inside the default sandbox and flags T $ nemoclaw my-assistant status ``` +#### Checking the OpenClaw version + +NemoClaw pins the OpenClaw version inside the sandbox at build time, not at runtime. +The minimum version comes from `min_openclaw_version` in `nemoclaw-blueprint/blueprint.yaml`, and the sandbox image upgrades OpenClaw to that version during `docker build` if the cached base image is older. +Existing sandboxes do not auto-upgrade when a newer NemoClaw release ships a newer pin — you upgrade by rebuilding the sandbox. + +`nemoclaw status` prints the running OpenClaw version on the `Agent` line: + +```console +$ nemoclaw my-assistant status +... + Agent: OpenClaw v2026.4.24 +... +``` + +If the sandbox is running an OpenClaw older than the version this NemoClaw release pins, `status` and `connect` add an `Update` line pointing at `nemoclaw rebuild` to pick up the newer version. +The rebuild reuses the existing sandbox name and persisted credentials, so messaging tokens and provider keys carry over. + ### `nemoclaw doctor` Run a focused health check for one sandbox and the host services it depends on. From e3a29380a19146b4b44ec56094df76bda923ede6 Mon Sep 17 00:00:00 2001 From: Charan Jagwani Date: Fri, 8 May 2026 07:41:57 -0700 Subject: [PATCH 2/2] docs(about): note OpenClaw version pin policy in release notes (#2635) Adds a Component Version Policy section to release-notes.md so the build-time pin choice for OpenClaw is captured in the literal location the #2635 acceptance criterion calls out (release notes), not just in the commands reference. The section links back to the full policy in docs/reference/commands.md to avoid duplicating the explanation. Signed-off-by: Charan Jagwani --- docs/about/release-notes.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/about/release-notes.md b/docs/about/release-notes.md index 78b198a8678..b5b49cb686f 100644 --- a/docs/about/release-notes.md +++ b/docs/about/release-notes.md @@ -30,3 +30,9 @@ NVIDIA NemoClaw is available in early preview starting March 16, 2026. Use the f | [Release comparison](https://github.com/NVIDIA/NemoClaw/compare) | Diff between any two tags or branches. | | [Merged pull requests](https://github.com/NVIDIA/NemoClaw/pulls?q=is%3Apr+is%3Amerged) | Individual changes with review discussion. | | [Commit history](https://github.com/NVIDIA/NemoClaw/commits/main) | Full commit log on `main`. | + +## Component Version Policy + +NemoClaw pins the OpenClaw version inside the sandbox at build time via `min_openclaw_version` in `nemoclaw-blueprint/blueprint.yaml`; existing sandboxes do not auto-upgrade. +Run `nemoclaw status` to see the OpenClaw version currently running in a sandbox, and `nemoclaw rebuild` to pick up a newer pin from a NemoClaw upgrade. +See [Checking the OpenClaw version](../reference/commands.md#checking-the-openclaw-version) for the full policy.