NemoClaw/spark-install.md
Miyoung Choi 0bc607387a
docs: clarify last-known-good installer guidance (#6148)
<!-- markdownlint-disable MD041 -->
## Summary
Clarifies that the hosted NemoClaw installer follows the maintained
last-known-good release by default, so common install entry points do
not need version overrides.
Keeps explicit installer-tag examples generic or `lkg`-based where they
are documenting override mechanics.

## Related Issue
Fixes #6064

## Changes
- Updated the docs landing page, OpenClaw quickstart, Hermes quickstart,
lifecycle guide, and Spark entry point to describe the hosted installer
default without pinning a stale release.
- Updated root and versioned installer help so the displayed default
comes from `DEFAULT_INSTALL_REF` and the example tag comes from
`INSTALL_TAG_EXAMPLE`.
- Updated installer help tests to derive expected shell constants from
the installer source and ratcheted the legacy size budget after
shrinking `test/install-preflight.test.ts`.

## Type of Change

- [ ] Code change (feature, bug fix, or refactor)
- [x] Code change with doc updates
- [ ] Doc only (prose changes, no code sample modifications)
- [ ] Doc only (includes code sample changes)

## Quality Gates
- [x] Tests added or updated for changed behavior
- [ ] Existing tests cover changed behavior — justification:
- [ ] Tests not applicable — justification:
- [x] Docs updated for user-facing behavior changes
- [ ] Docs not applicable — justification:
- [x] Sensitive paths changed (security, policy, credentials, preflight,
onboarding, inference, runner, sandbox, or messaging)
- [x] Sensitive-path review completed or maintainer-approved waiver
recorded — reviewer/approval link/justification: installer help text and
test expectations only; no installer execution, credential, policy, or
onboarding control flow changed.
- [ ] Non-success, skipped, or missing CI check accepted by maintainer —
check name, approval link, and follow-up issue:

## Verification
- [x] PR description includes the DCO sign-off declaration and every
commit appears as `Verified` in GitHub
- [ ] Git hooks passed during commit and push, or `npx prek run
--from-ref main --to-ref HEAD` passes
- [x] Targeted tests pass for changed behavior
- [ ] Full `npm test` passes (broad runtime changes only)
- [x] Quality Gates section completed with required justifications or
waivers
- [x] No secrets, API keys, or credentials committed
- [x] `npm run docs` builds without warnings (doc changes only)
- [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)

Verification details:
- `npm run docs`
- `npm run check:installer-hash`
- `npm run test-size:check`
- `npx vitest run --project installer-integration
test/install-preflight.test.ts -t "defaults to the installer default
ref|shows NEMOCLAW_INSTALL_TAG"`
- `git diff --check`
- Normal pre-push hooks passed during `git push -u origin HEAD`.
- Pre-commit hooks were skipped for the final commit after maintainer
approval because the broad local `test-cli` hook failed on unrelated
integration tests and Node spawn timeouts in this environment.

---
Signed-off-by: Miyoung Choi <miyoungc@nvidia.com>

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **Documentation**
* Updated quickstart, terminal “From Your Terminal,” DGX Spark, and
sandbox lifecycle guides to describe “maintained last-known-good”
behavior by default and clarify when explicit version overrides are
needed.
* **Bug Fixes**
* Refreshed installer guidance so `--help` shows the computed default
and example values consistently with current release settings.
* **Tests**
* Updated preflight assertions to derive expected release tags from
shared shell constants instead of hardcoded values.
  * Adjusted the test file-size budget limit used by automated checks.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
2026-07-01 22:33:24 +00:00

791 B

NemoClaw on DGX Spark

The guide for setting up NemoClaw on DGX Spark is available on the NVIDIA Spark playbook instructions. DGX Spark needs no platform-specific pre-setup because Docker is pre-installed, so the standard OpenClaw quickstart works directly. Use the hosted installer without a version override. It follows the last-known-good (lkg) release tag by default.

curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash

Refer to the playbook for detailed instructions.