Skip to content

Commit ce19c7b

Browse files
authored
docs: prepare v0.0.78 release notes (#6529)
<!-- markdownlint-disable MD041 --> ## Summary Prepares the user documentation for NemoClaw v0.0.78 by replacing the unreleased section with release highlights and synchronizing the affected inference, lifecycle, messaging, and CLI reference pages with merged behavior. ## Changes - Publish the v0.0.78 release-notes section with links to the most specific user guides for each shipped behavior. - Document authoritative Deep Agents route health, Nemotron Ultra profile behavior, and Hermes compatible-endpoint context metadata. - Document forced rebuild recovery after total backup failure and the ownership-safe tunnel/full-stop behavior. - Keep command examples and shared agent variants aligned with the current OpenClaw, Hermes, and Deep Agents interfaces. Source mapping: - [#3787](#3787) -> `docs/about/release-notes.mdx`: Record reliable workspace template seeding during sandbox startup. - [#4960](#4960) -> `docs/about/release-notes.mdx`: Record safer detection of rewritten OpenClaw gateway processes. - [#5676](#5676) -> `docs/about/release-notes.mdx`: Record warning-tolerant agent-list JSON handling. - [#5857](#5857) -> `docs/about/release-notes.mdx`: Record synchronization of explicit OpenClaw main-agent model state. - [#5929](#5929) -> `docs/about/release-notes.mdx`: Record copyable SSH port-forward guidance for remote dashboards. - [#6068](#6068) -> `docs/about/release-notes.mdx`: Record custom-image plugin provenance reconciliation. - [#6116](#6116) -> `docs/about/release-notes.mdx`: Record live-loopback dashboard-forward recovery. - [#6122](#6122) -> `docs/about/release-notes.mdx`: Announce validated, round-trippable policy YAML output. - [#6211](#6211) -> `docs/manage-sandboxes/lifecycle.mdx`, `docs/reference/commands.mdx`, `docs/about/release-notes.mdx`: Explain the explicit no-backup `rebuild --force` recovery boundary. - [#6283](#6283) -> `docs/about/release-notes.mdx`: Record Hermes WebUI port alignment. - [#6293](#6293) -> `docs/inference/switch-inference-providers.mdx`, `docs/about/release-notes.mdx`: Document compatible-endpoint context-length probing for Hermes. - [#6320](#6320) -> `docs/about/release-notes.mdx`: Record bounded gateway-recovery waits. - [#6377](#6377) -> `docs/reference/commands.mdx`, `docs/about/release-notes.mdx`: Explain rebuild diagnostics and prepared MCP-destroy recovery. - [#6412](#6412) -> `docs/get-started/quickstart-langchain-deepagents-code.mdx`, `docs/about/release-notes.mdx`: Document authoritative agent-visible inference route health. - [#6421](#6421) -> `docs/about/release-notes.mdx`: Record the longer quiet-pull window for managed vLLM images. - [#6431](#6431) -> `docs/inference/model-capability-audit.mdx`, `docs/about/release-notes.mdx`: Document the version-pinned Nemotron Ultra profile plugin. - [#6439](#6439) -> `docs/about/release-notes.mdx`: Summarize the authenticated, pinned credential-capture helper boundary. - [#6450](#6450) -> `docs/manage-sandboxes/messaging-channels.mdx`, `docs/reference/commands.mdx`, `docs/about/release-notes.mdx`: Document host-forward cleanup and ownership-safe gateway-port release. - [#6474](#6474) -> `docs/manage-sandboxes/messaging-channels.mdx`, `docs/about/release-notes.mdx`: Record composable OpenClaw messaging runtime loaders. - [#6475](#6475) -> `docs/about/release-notes.mdx`: Record removal of the unavailable Kimi K2.6 production endpoint option. - [#6480](#6480) -> `docs/about/release-notes.mdx`: Record stderr routing for the plugin registration banner. - [#6481](#6481) -> `docs/about/release-notes.mdx`: Record post-pull Ollama model discovery checks. - [#6482](#6482) -> `docs/about/release-notes.mdx`: Record Ollama model warm-up after daemon restart. - [#6486](#6486) -> `docs/about/release-notes.mdx`: Publish the opt-in, thread-scoped Deep Agents auto-approval boundary. - [#6490](#6490) -> `docs/about/release-notes.mdx`: Record diagnostics for custom images missing the managed runtime. - [#6494](#6494) -> `docs/inference/model-capability-audit.mdx`, `docs/about/release-notes.mdx`: Document nonempty tool-call content preservation and placeholder rejection. - [#6497](#6497) -> `docs/get-started/quickstart-langchain-deepagents-code.mdx`, `docs/about/release-notes.mdx`: Document isolated Deep Agents route-probe output. - [#6506](#6506) -> `docs/get-started/quickstart-langchain-deepagents-code.mdx`, `docs/about/release-notes.mdx`: Document observability-preserving managed route probes. - [#6508](#6508) -> `docs/about/release-notes.mdx`: Link the new extension taxonomy and SDK-readiness reference from the release summary. Release-source verification: GitHub reports all 29 cited source PRs as merged with base `main`, and every merge commit is an ancestor of `origin/main` at `17bf9a6a9688b3b1d69cf4b37d3f23110acb055e`. No source-mapping mismatches were found. ## Type of Change - [ ] Code change (feature, bug fix, or refactor) - [ ] Code change with doc updates - [ ] Doc only (prose changes, no code sample modifications) - [x] Doc only (includes code sample changes) ## Quality Gates <!-- Check exactly one tests line and one docs line. Check other lines when applicable. Add every requested justification or approval reference. --> - [ ] Tests added or updated for changed behavior - [ ] Existing tests cover changed behavior — justification: - [x] Tests not applicable — justification: Documentation-only release-prep changes; `npm run docs` validates variants, routes, and Fern content. - [x] Docs updated for user-facing behavior changes - [ ] Docs not applicable — justification: - [ ] Sensitive paths changed (security, policy, credentials, preflight, onboarding, inference, runner, sandbox, or messaging) - [ ] Sensitive-path review completed or maintainer-approved waiver recorded — reviewer/approval link/justification: - [ ] Non-success, skipped, or missing CI check accepted by maintainer — check name, approval link, and follow-up issue: ## Verification <!-- Check each applicable item only when supported by the requested evidence. Run targeted tests once per relevant change set and rerun after later edits or hook autofixes that can affect the tested behavior. Do not rerun hook-covered checks. --> - [x] PR description includes the DCO sign-off declaration and every commit appears as `Verified` in GitHub - [x] Normal `pre-commit`, `commit-msg`, and `pre-push` hooks passed, or `npm run check:diff` passed when hooks were skipped or unavailable - [x] Targeted behavior tests pass for the current change set, or tests are marked not applicable above — command/result or justification: Tests are not applicable to this documentation-only change set. - [ ] Applicable broad gate passed — `npm test` for broad runtime/test-harness changes; `npm run check` for repo-wide validation/coverage changes — command/result: - [x] Quality Gates section completed with required justifications or waivers - [x] No secrets, API keys, or credentials committed - [ ] `npm run docs` builds without warnings (doc changes only) — exited 0 with zero errors; Fern reported the existing unauthenticated redirect-check and light-mode contrast warnings. - [x] Doc pages follow the [style guide](https://github.com/NVIDIA/NemoClaw/blob/main/docs/CONTRIBUTING.md) (doc changes only) - [ ] New doc pages include SPDX header and frontmatter (new pages only) --- <!-- DCO sign-off is required in this PR description, and every commit must appear as Verified in GitHub. Run: git config user.name && git config user.email --> Signed-off-by: Charan Jagwani <cjagwani@nvidia.com> --------- Signed-off-by: cjagwani <cjagwani@nvidia.com>
1 parent 17bf9a6 commit ce19c7b

7 files changed

Lines changed: 103 additions & 38 deletions

File tree

docs/about/release-notes.mdx

Lines changed: 29 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,16 +16,38 @@ NVIDIA NemoClaw is available in early preview starting March 16, 2026.
1616
Use this page to track the highlights of the latest release.
1717
For more detailed release notes, refer to the [NemoClaw GitHub announcements](https://github.com/NVIDIA/NemoClaw/discussions/categories/announcements?discussions_q=is%3Aopen+category%3AAnnouncements).
1818

19-
## Unreleased
19+
## v0.0.78
2020

21-
The next NemoClaw release adds an optional thread-scoped auto-approval capability for managed LangChain Deep Agents Code sandboxes.
21+
NemoClaw v0.0.78 adds opt-in thread-scoped auto-approval for managed LangChain Deep Agents Code, authoritative agent-visible inference health, round-trippable policy export, and stronger recovery for local inference, custom images, managed MCP, remote dashboards, and credential capture.
2222

23-
- Deep Agents interactive sessions keep auto-approval disabled by default.
24-
Operators can enable the `thread-opt-in` capability through a named transactional rebuild, after which each thread must still activate it through the TUI approval choice or `dcode -y`.
25-
Active state resets for a new process or thread, `/clear`, thread switching, and agent switching.
26-
The root-owned capability fails closed on invalid state, ambient environment values cannot enable it, and OpenShell policy, credential, inference, MCP, filesystem, and process controls remain in force.
27-
Headless `dcode -n` remains a separate automation boundary.
23+
- Managed LangChain Deep Agents Code sandboxes keep auto-approval disabled by default and can enable the `thread-opt-in` capability through a named transactional rebuild.
24+
Each thread must still opt in through the TUI or `dcode -y`, and approval state resets across process, thread, and agent transitions without bypassing OpenShell controls.
25+
Managed Nemotron 3 Ultra aliases now load through a version-pinned first-party profile plugin, preserve required nonempty tool-call content, and reject the observed literal `[content]` execute placeholder before shell dispatch.
2826
For more information, refer to [Quickstart with LangChain Deep Agents Code](/user-guide/deepagents/get-started/quickstart), [Security Best Practices](../security/best-practices), [Model Capability Audit](../inference/model-capability-audit), and [NemoClaw CLI Commands Reference](../reference/commands).
27+
- `status`, `doctor`, and `connect` now treat the agent-visible `https://inference.local/v1/models` route as authoritative and return nonzero or fail closed when trusted evidence is unavailable.
28+
Deep Agents probes reject login-shell preambles and multiline contamination while preserving configured observability through a side-effect-free managed execution path.
29+
For more information, refer to [NemoClaw CLI Commands Reference](../reference/commands), [Monitor Sandbox Activity](../monitoring/monitor-sandbox-activity), and [Troubleshooting](../reference/troubleshooting).
30+
- Compatible-endpoint onboarding now probes `max_model_len` and carries it into Hermes `context_length` unless `NEMOCLAW_CONTEXT_WINDOW` is set.
31+
Inference switches also synchronize explicit OpenClaw main-agent model state, and NVIDIA Endpoints no longer advertises Kimi K2.6 while its production Chat Completions route is unavailable.
32+
For more information, refer to [Switch Inference Providers](../inference/switch-inference-providers), [NemoClaw Inference Options](../inference/inference-options), and [Model Capability Audit](../inference/model-capability-audit).
33+
- Local inference setup waits for newly pulled Ollama models to appear, warms an unloaded model before OpenClaw agent passthrough after daemon restarts, and allows a 15-minute quiet Docker pull window for large managed vLLM images.
34+
For more information, refer to [Use a Local Inference Server](../inference/use-local-inference) and [Troubleshooting](../reference/troubleshooting).
35+
- New `$$nemoclaw <name> policy-get` output provides validated base-policy YAML suitable for review, editing, and reapplication, while `--raw` preserves the metadata-bearing response for diagnostics.
36+
The plugin registration banner now uses stderr, and `agents apply` tolerates warning-prefixed and wrapped JSON so command stdout remains usable by automation.
37+
For more information, refer to [Customize the Network Policy](../network-policy/customize-network-policy), [Common Integration Policy Examples](../network-policy/integration-policy-examples), and [NemoClaw CLI Commands Reference](../reference/commands).
38+
- Rebuild now prints redacted managed MCP destroy diagnostics before backup or deletion, recovers prepared-only transactions through `mcp remove --force`, and lets an explicit `rebuild --force` continue without a backup when a crashed sandbox cannot be reached.
39+
The no-backup path warns that prior sandbox state is not preserved, and gateway recovery reports its bounded retry budget.
40+
For more information, refer to [Set Up MCP Servers](../manage-sandboxes/set-up-mcp-servers), [NemoClaw CLI Commands Reference](../reference/commands), and [Manage Sandbox Lifecycle](../manage-sandboxes/lifecycle).
41+
- Custom OpenClaw image handling now detects base-only images that lack the managed runtime and reconciles image-owned plugin provenance across recreate and rebuild while preserving user-owned plugin, channel, tool, and workspace state.
42+
Workspace template seeding also survives the startup function serialization path.
43+
A new reference defines lifecycle contributions, managed agent packages, agent-native plugins, and the gates required before any future public NemoClaw plugin SDK.
44+
For more information, refer to [Install OpenClaw Plugins](/user-guide/openclaw/manage-sandboxes/install-openclaw-plugins), [Manage Sandbox Lifecycle](../manage-sandboxes/lifecycle), and [Extension Taxonomy and SDK Readiness](../reference/extension-taxonomy-sdk-readiness).
45+
- Remote dashboard and shutdown flows now provide copyable SSH port-forward hints, recognize a live untracked loopback forward before rolling back onboarding, align the Hermes WebUI with the resolved host dashboard port, and make the deprecated full stop attempt agent-owned host-forward cleanup before safely releasing an unshared, ownership-verified OpenShell gateway port.
46+
Supervisor-owned Hermes runtime processes remain under sandbox control, and OpenClaw Slack and compact-QR WhatsApp runtime hooks compose safely when both are enabled.
47+
For more information, refer to [Deploy to a Remote GPU Host](/user-guide/openclaw/deployment/deploy-to-remote-gpu), [NemoClaw Quickstart with Hermes](/user-guide/hermes/get-started/quickstart), [Messaging Channels](/user-guide/openclaw/manage-sandboxes/messaging-channels), and [NemoClaw CLI Commands Reference](../reference/commands).
48+
- Starter prompts now bind the local credential form to an authenticated one-shot helper with immutable commit and SHA-256 pins, explicit isolated or account-home execution profiles, denial of ambient process-control variables, and a preview, edit, and confirm flow.
49+
This keeps credential collection behind verified helper and approved-command boundaries.
50+
For more information, refer to [NemoClaw Quickstart with OpenClaw](/user-guide/openclaw/get-started/quickstart) and [Use NemoClaw Agent Prompts, Docs MCP Server, and Skills with Your AI Coding Agent](../resources/agent-skills).
2951

3052
## v0.0.77
3153

docs/get-started/quickstart-langchain-deepagents-code.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -646,6 +646,8 @@ If an existing sandbox displays `Choose a Recommended Model`, rebuild it so its
646646
If `status` reports `Runtime health: degraded` with an OOM kill count, rebuild the sandbox to restore the terminal runtime.
647647
Proxy launchers and startup scripts are baked into the sandbox image.
648648
After upgrading NemoClaw from a release with older Deep Agents Code routing, rebuild each existing sandbox before troubleshooting `inference.local` connectivity.
649+
NemoClaw v0.0.78 and newer clients fail closed when a pre-v0.0.78 sandbox image lacks the trusted `/usr/local/lib/nemoclaw/dcode-managed-exec` route-probe helper, even when the installed Deep Agents Code version still matches the managed manifest.
650+
Rebuild the sandbox to install that image-owned helper before retrying `status`, `doctor`, `connect`, or onboarding recovery.
649651
There is no dashboard port or long-running gateway process for this harness.
650652

651653
## Next Steps

docs/inference/model-capability-audit.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -105,8 +105,8 @@ When importing a completed row from an issue comment, preserve the exact commit
105105
| OpenClaw primary agent | Other OpenAI-compatible endpoint | User-selected `custom-model` or another configured model id. | Managed `inference.local` route to the compatible endpoint. | `not-yet-run` | Add endpoint class and trajectory evidence before changing state. | Record endpoint API path forcing and store/streaming assumptions. | Add one row per endpoint class that is validated. | `src/lib/inference/config.ts`. |
106106
| OpenClaw primary agent | Other Anthropic-compatible endpoint | User-selected `custom-anthropic-model` or another configured model id. | `anthropic` route when supported, otherwise managed compatible route. | `not-yet-run` | Add endpoint class and trajectory evidence before changing state. | Record native Anthropic Messages or compatible-route transport behavior. | Add one row per endpoint class that is validated. | `src/lib/inference/config.ts`. |
107107
| Hermes sandbox API | Hermes Provider | Default `moonshotai/kimi-k2.6` or any model from `HERMES_PROVIDER_MODEL_OPTIONS`. | Hermes Provider route through NemoClaw managed inference. | `not-yet-run` | Add Hermes session, request dump, logs, and local API evidence before changing state. | Generated config uses native `tools.tool_search.enabled: on` with snake-case 5/20 limits; core tools stay direct while deferred MCP and non-core plugin tools use structured search, describe, and call. | Verify a deferred-tool trajectory and keep it separate from OpenClaw `mode: tools` evidence. | `agents/hermes/config/hermes-config.ts`, `test/generate-hermes-config.test.ts`. |
108-
| Deep Agents interactive `dcode` | NVIDIA Endpoints | `nvidia/nemotron-3-super-120b-a12b` | Managed `inference.local` OpenAI-compatible Chat Completions with `use_responses_api = false`. | `not-yet-run` | Add separate default-disabled and thread-opt-in terminal transcripts, host status output, reset evidence, and route evidence before changing state. | Managed `/sandbox/.deepagents/config.toml` forces the OpenAI-compatible route and disables Responses API for `dcode`; optional `thread-opt-in` remains a per-thread approval affordance. | Verify a terminal task with approval prompts intact, then separately verify explicit thread activation, reset behavior, policy enforcement, and no provider credential in sandbox-visible files. | `agents/langchain-deepagents-code/generate-config.ts`, `docs/get-started/quickstart-langchain-deepagents-code`. |
109-
| Deep Agents headless `dcode -n` | NVIDIA Endpoints | `nvidia/nemotron-3-super-120b-a12b` | Managed `inference.local` OpenAI-compatible Chat Completions with `use_responses_api = false`. | `not-yet-run` | Add headless command transcript and status output before changing state. | Headless mode has no approval UI and auto-approves non-shell tools while managed shell execution remains disabled. | Verify a bounded non-shell task and record the approval boundary separately from interactive evidence. | `agents/langchain-deepagents-code/dcode-wrapper.sh`, `docs/security/best-practices`. |
108+
| Deep Agents interactive `dcode` | NVIDIA Endpoints | `nvidia/nemotron-3-ultra-550b-a55b` | Managed `inference.local` OpenAI-compatible Chat Completions with `use_responses_api = false`. | `not-yet-run` | Add separate default-disabled and thread-opt-in terminal transcripts, host status output, reset evidence, and route evidence before changing state. | The managed Ultra profile preserves required nonempty tool-call content and rejects the observed literal `[content]` execute placeholder before shell dispatch; optional `thread-opt-in` remains a per-thread approval affordance. | Verify a terminal task with approval prompts intact, then separately verify explicit thread activation, reset behavior, policy enforcement, placeholder rejection, and no provider credential in sandbox-visible files. | `agents/langchain-deepagents-code/generate-config.ts`, `agents/langchain-deepagents-code/profile-plugin`, `docs/get-started/quickstart-langchain-deepagents-code`. |
109+
| Deep Agents headless `dcode -n` | NVIDIA Endpoints | `nvidia/nemotron-3-ultra-550b-a55b` | Managed `inference.local` OpenAI-compatible Chat Completions with `use_responses_api = false`. | `not-yet-run` | Add headless command transcript and status output before changing state. | Headless mode uses the managed Ultra profile, preserves required nonempty tool-call content, rejects the observed literal `[content]` execute placeholder, has no approval UI, and auto-approves non-shell tools while managed shell execution remains disabled. | Verify a bounded non-shell task, placeholder rejection, and the approval boundary separately from interactive evidence. | `agents/langchain-deepagents-code/dcode-wrapper.sh`, `agents/langchain-deepagents-code/profile-plugin`, `docs/security/best-practices`. |
110110

111111
## Completed Row Template
112112

docs/inference/switch-inference-providers.mdx

Lines changed: 32 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -295,16 +295,16 @@ Use `--no-verify` only when OpenShell cannot verify the provider at switch time
295295
`--no-verify` does not bypass the one-route-per-gateway compatibility check.
296296
</AgentOnly>
297297

298-
<AgentOnly variant="openclaw,hermes">
298+
<AgentOnly variant="openclaw">
299299

300300
## Tune Model Metadata
301301

302-
The sandbox image bakes model metadata (context window, max output tokens, reasoning mode, and accepted input modalities) into `openclaw.json` at build time.
302+
The sandbox image bakes model metadata into `openclaw.json` at build time.
303303
To change these values, set the corresponding environment variables before running `$$nemoclaw onboard` so they patch into the Dockerfile before the image builds.
304304

305305
| Variable | Values | Default |
306306
|---|---|---|
307-
| `NEMOCLAW_CONTEXT_WINDOW` | Positive integer (tokens) | `131072` (OpenClaw baked metadata); Hermes leaves it unset to auto-detect |
307+
| `NEMOCLAW_CONTEXT_WINDOW` | Positive integer (tokens) | `131072` |
308308
| `NEMOCLAW_MAX_TOKENS` | Positive integer (tokens) | `4096` |
309309
| `NEMOCLAW_REASONING` | `true` or `false` | `false` |
310310
| `NEMOCLAW_INFERENCE_INPUTS` | `text` or `text,image` | `text` |
@@ -314,9 +314,8 @@ To change these values, set the corresponding environment variables before runni
314314
NemoClaw ignores invalid values and bakes the default into the image.
315315
For Local Ollama, onboarding loads the selected model first and uses Ollama's reported runtime context length when `NEMOCLAW_CONTEXT_WINDOW` is unset.
316316
For local vLLM, onboarding uses the runtime `max_model_len` value when the server reports one and `NEMOCLAW_CONTEXT_WINDOW` is unset.
317-
For an OpenAI-compatible endpoint (the **Other OpenAI-compatible endpoint** provider, including a self-hosted vLLM server), onboarding probes the endpoint's `/v1/models` response and uses its reported `max_model_len` when `NEMOCLAW_CONTEXT_WINDOW` is unset, so the agent gets the endpoint's real context window instead of a small architecture default.
317+
For an OpenAI-compatible endpoint (the **Other OpenAI-compatible endpoint** provider, including a self-hosted vLLM server), onboarding probes the endpoint's `/v1/models` response and uses its reported `max_model_len` when `NEMOCLAW_CONTEXT_WINDOW` is unset, so OpenClaw gets the endpoint's real context window instead of a small architecture default.
318318
Set `NEMOCLAW_CONTEXT_WINDOW` to override the probed value.
319-
For Hermes, the resolved window is written as `model.context_length` in the generated `config.yaml`, and leaving it unset lets Hermes auto-detect.
320319
Use `NEMOCLAW_INFERENCE_INPUTS=text,image` only for a model that accepts image input through the selected provider.
321320
During interactive onboarding, NemoClaw prompts for **Text only** or **Text + Image** when the discovered model name looks multimodal and `NEMOCLAW_INFERENCE_INPUTS` is not already valid.
322321
Non-interactive onboarding uses the environment value or the default `text` setting.
@@ -331,6 +330,30 @@ export NEMOCLAW_AGENT_HEARTBEAT_EVERY=0m
331330
$$nemoclaw onboard
332331
```
333332

333+
</AgentOnly>
334+
<AgentOnly variant="hermes">
335+
336+
## Tune Model Metadata
337+
338+
Hermes accepts `NEMOCLAW_CONTEXT_WINDOW` as its model-metadata override.
339+
Set it before running `$$nemoclaw onboard` so NemoClaw patches the value into the Dockerfile before the image builds.
340+
341+
| Variable | Values | Default |
342+
|---|---|---|
343+
| `NEMOCLAW_CONTEXT_WINDOW` | Positive integer (tokens) | Unset so Hermes auto-detects |
344+
345+
For Local Ollama, onboarding loads the selected model first and uses Ollama's reported runtime context length when `NEMOCLAW_CONTEXT_WINDOW` is unset.
346+
For local vLLM, onboarding uses the runtime `max_model_len` value when the server reports one and `NEMOCLAW_CONTEXT_WINDOW` is unset.
347+
For an OpenAI-compatible endpoint (the **Other OpenAI-compatible endpoint** provider, including a self-hosted vLLM server), onboarding probes the endpoint's `/v1/models` response and uses its reported `max_model_len` when `NEMOCLAW_CONTEXT_WINDOW` is unset, so Hermes gets the endpoint's real context window instead of a small architecture default.
348+
Set `NEMOCLAW_CONTEXT_WINDOW` to override the probed value.
349+
When onboarding resolves a valid window from an explicit override or endpoint probe, NemoClaw writes it as `model.context_length` in the generated `config.yaml`.
350+
If neither path yields a valid value, `model.context_length` remains unset and Hermes auto-detects from the endpoint.
351+
352+
```bash
353+
export NEMOCLAW_CONTEXT_WINDOW=65536
354+
$$nemoclaw onboard
355+
```
356+
334357
</AgentOnly>
335358

336359
<AgentOnly variant="openclaw">
@@ -342,15 +365,6 @@ The default sandbox can keep that file writable for agent state, but direct in-s
342365
Rebuild the sandbox with `$$nemoclaw onboard` to apply a new value.
343366

344367
</AgentOnly>
345-
<AgentOnly variant="hermes">
346-
347-
`NEMOCLAW_AGENT_TIMEOUT` controls the per-request inference timeout baked into the Hermes sandbox image.
348-
Increase it for slow local inference, such as CPU-only Ollama or vLLM on modest hardware.
349-
Direct in-sandbox edits are not the supported or durable way to change NemoClaw-managed defaults.
350-
Rebuild the sandbox with `$$nemoclaw onboard` to apply a new value.
351-
352-
</AgentOnly>
353-
354368
<AgentOnly variant="openclaw">
355369

356370
`NEMOCLAW_AGENT_HEARTBEAT_EVERY` sets `agents.defaults.heartbeat.every`.
@@ -367,14 +381,14 @@ Recreate the sandbox with `$$nemoclaw onboard --fresh --name <sandbox-name> --re
367381
<AgentOnly variant="hermes">
368382

369383
Hermes does not use OpenClaw's `HEARTBEAT.md` wake-up mechanism.
370-
Recreate the sandbox with `$$nemoclaw onboard --fresh --name <sandbox-name> --recreate-sandbox` to apply build-time inference metadata changes.
384+
Hermes also does not consume the OpenClaw-only `NEMOCLAW_AGENT_TIMEOUT` or `NEMOCLAW_AGENT_HEARTBEAT_EVERY` model-metadata variables.
371385

372386
</AgentOnly>
373387

374388
<AgentOnly variant="openclaw,hermes">
375389

376-
These variables are build-time settings.
377-
If you change them on an existing sandbox, recreate the sandbox so the new values bake into the image:
390+
Supported model-metadata variables are build-time settings.
391+
If you change a supported value on an existing sandbox, recreate the sandbox so the new value bakes into the image:
378392

379393
```bash
380394
$$nemoclaw onboard --fresh --name <sandbox-name> --recreate-sandbox
@@ -440,7 +454,7 @@ The status output includes the active provider, model, and endpoint with the res
440454
- The host keeps provider credentials.
441455
- The sandbox continues to use `inference.local`.
442456
- `$$nemoclaw inference set` patches the selected running Hermes sandbox config and recomputes its config hash.
443-
- Use `$$nemoclaw onboard --fresh --name <sandbox-name> --recreate-sandbox` for build-time settings such as context window, max tokens, reasoning mode, heartbeat cadence, or image contents.
457+
- Use `$$nemoclaw onboard --fresh --name <sandbox-name> --recreate-sandbox` for build-time settings such as context window or image contents.
444458
- Local Ollama and local vLLM routes use local provider tokens rather than `OPENAI_API_KEY`. Rebuilds of older local-inference sandboxes clear the stale OpenAI credential requirement automatically.
445459

446460
</AgentOnly>

0 commit comments

Comments
 (0)