docs: restore Hermes variant page structure by jyaunches · Pull Request #11926 · NVIDIA/NemoClaw

jyaunches · 2026-09-16T16:43:30Z

Outcome

Restore the Hermes quickstart and Ollama page structure that commit 755f28d accidentally removed, while retaining its Portable Ollama guidance.

Why

Main's CI / Main Branch run fails two CLI shards because the affected MDX pages no longer start with YAML frontmatter and the Hermes quickstart lost its managed-image onboarding contract.

Shard 12 failure: https://github.com/NVIDIA/NemoClaw/actions/runs/35121590909/job/104880880220
Shard 4 failure: https://github.com/NVIDIA/NemoClaw/actions/runs/35121590909/job/104880880144

Changes

Restore the deleted Hermes quickstart prefix before the new Portable Ollama accordion.
Restore the Ollama page frontmatter and prerequisites before the Hermes-only Portable Ollama section.

Verification

npm exec -- vitest run --project integration test/generation/agent-variant-docs.test.ts
npm exec -- vitest run --project integration test/onboarding/onboard-managed-image-buildless-e2e.test.ts
npm run docs
git diff --check
Independent documentation review: no blockers or suggestions

Signed-off-by: Julie Yaunches jyaunches@nvidia.com

Summary by CodeRabbit

Documentation
- Added a Hermes-specific NemoClaw quickstart covering installation, onboarding, sandbox setup, dashboard and terminal access, inference, optional services, observability, and recovery guidance.
- Added Ollama setup documentation covering prerequisites, supported agent variants, installation, and inference.
- Documented NemoClaw’s ability to detect and manage Ollama on supported systems.

Signed-off-by: Julie Yaunches <jyaunches@nvidia.com>

copy-pr-bot · 2026-09-16T16:43:33Z

Auto-sync is disabled for draft pull requests in this repository. Workflows must be run manually.

Contributors can view more details about this message here.

coderabbitai · 2026-09-16T16:43:36Z

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Enterprise

Run ID: f3072c79-854e-4d6e-8f7f-76c9ef5b4289

📥 Commits

Reviewing files that changed from the base of the PR and between 2fd6903 and c28c3c3.

📒 Files selected for processing (2)

docs/get-started/quickstart-hermes.mdx
docs/inference/set-up-ollama.mdx

📝 Walkthrough

Walkthrough

Changes

The PR adds a Hermes-specific NemoClaw quickstart and an Ollama setup page. The documentation covers installation, onboarding, sandbox launch, integrations, observability, scripted workflows, and local inference prerequisites.

NemoClaw documentation

Layer / File(s)	Summary
Hermes onboarding flow `docs/get-started/quickstart-hermes.mdx`	Adds Hermes metadata, starter-agent guidance, interactive installation, deferred onboarding, sandbox readiness checks, dashboard access, and launch commands.
Hermes integrations and automation `docs/get-started/quickstart-hermes.mdx`	Adds provider, tool, messaging, Langfuse, credential, host restriction, key rotation, scripted onboarding, and troubleshooting guidance.
Ollama setup guidance `docs/inference/set-up-ollama.mdx`	Adds Ollama metadata, supported agent variants, local inference guidance, and prerequisites for NemoClaw and host Ollama availability.

Estimated code review effort: 2 (Simple) | ~12 minutes

Change: Bug fix

Suggested reviewers: miyoungc

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch codex/fix-main-docs-variants

_{Comment @coderabbitai help to get the list of available commands.}

github-actions · 2026-09-16T16:44:52Z

🌿 Preview your docs: https://nvidia-preview-pr-11926.docs.buildwithfern.com/nemoclaw

## Outcome Initial cleanup in Pi qualification, agent-turn latency, and sessions/agents CLI E2E checks the named OpenShell gateway before deleting a sandbox. A verified absent registration lets onboarding proceed. Failed or ambiguous observations and terminal cleanup failures remain errors. ## Reason Main E2E run 35087621077 failed these jobs before onboarding because a fresh runner had no `nemoclaw` gateway. The fixtures handled an absent sandbox but not an absent gateway. ## Changes - Add a shared gateway observation to `SandboxClient`. It accepts only complete, ordered missing-registration guidance from the pinned gateway-info command. - Use that observation in the three initial cleanup paths. Preserve strict terminal cleanup and forward cleanup. - Resolve the latency cleanup gateway once, so inspection and registration removal use the same name when `OPENSHELL_GATEWAY` overrides it. - Cover malformed, incomplete, repeated, reordered, failed, timed-out, and signaled observations; gateway overrides; and cleanup ordering. - Map Pi qualification to the shared cleanup-client regression suite. ## Verification Candidate: `fcef6f7b17abdf8b18c5fe178975accd7f4ab43e`. Integrated trusted main: `8657616c8171de9371f80c6c1cdaf93f54dffb09`. - 196 focused tests passed across `e2e-clients`, `agent-turn-latency-progress`, and `agent-variant-docs`. Command: `node_modules/.bin/vitest run --project e2e-support --project integration test/e2e/support/e2e-clients.test.ts test/e2e/support/agent-turn-latency-progress.test.ts test/generation/agent-variant-docs.test.ts --testTimeout 120000`. The explicit timeout accommodates cold imports. - Normal commit hooks passed, including formatting, lint, repository checks, E2E phases, source-shape and growth budgets, secret scanning, and commitlint. - The former shard 4 and 12 documentation failures were inherited. Merged repairs #11908 and #11926 are integrated; the retained documentation test passes. - The diff contains no secrets, API keys, or credentials. Normal pre-push publication validation and JavaScript/CLI type-checks passed with `NODE_OPTIONS=--max-old-space-size=8192`. GitHub verified every PR commit. Latest-commit CI and selected trusted E2E results are being collected; those gates remain pending. ## Review notes Alternative review completed for the candidate above. Both CodeRabbit findings and the matching maintainer change request were repaired with protecting tests. The full seven-file diff was reviewed for correctness, gateway identity, absence classification, error propagation, cleanup ordering, and coverage. The local Docker Advisor used trusted main, pinned OpenShell 0.0.116, Landlock, and an isolated controller. It failed before its first specialist: the pinned Pi image pull reported `no space left on device` in the shared VM. No specialist completed. The task sandbox, gateway, controller, and failed cache were cleaned up without stopping other tasks. This is self-review supplemented by the existing CodeRabbit and human findings, not Advisor clearance or independent review. Selected E2E: `cloud-onboard`, `cloud-inference`, `security-posture`, `pi-agent-qualification`, `agent-turn-latency`, and `sessions-agents-cli`. --- Signed-off-by: Julie Yaunches <jyaunches@nvidia.com>  ## Summary by CodeRabbit - **Bug Fixes** - Improved sandbox cleanup reliability by verifying the configured gateway before attempting deletion. - Missing gateways are handled safely, while malformed, unexpected, timed-out, or failed checks are surfaced. - Sandbox destruction continues even when gateway cleanup cannot proceed. - Standardized pre-onboarding cleanup across end-to-end workflows. - Cleanup now respects configured gateway names and verifies cleanup ordering. - **Tests** - Expanded coverage for gateway detection, custom gateway names, cleanup ordering, timeout behavior, failure handling, and deletion errors.  --------- Signed-off-by: Julie Yaunches <jyaunches@nvidia.com>

docs: restore Hermes variant page structure

c28c3c3

Signed-off-by: Julie Yaunches <jyaunches@nvidia.com>

jyaunches marked this pull request as ready for review September 16, 2026 16:44

jyaunches merged commit fc8a179 into main Sep 16, 2026
33 of 34 checks passed

jyaunches deleted the codex/fix-main-docs-variants branch September 16, 2026 16:45

github-actions Bot added the v0.0.127 label Sep 16, 2026

jyaunches mentioned this pull request Sep 16, 2026

ci(images): add optional managed image security scans #11876

Closed

rsliter mentioned this pull request Sep 16, 2026

docs(hermes): fix Portable Ollama navigation #11920

Closed

This was referenced Sep 16, 2026

fix(config): export read-only rosters sharing managed vLLM #11919

Merged

fix(config): export read-only agents sharing attached Ollama #11918

Merged

This was referenced Sep 16, 2026

fix(openclaw): reload native plugins on gateway restart #11911

Merged

fix(onboard): check portable registry before image build #11874

Merged

fix(advisor): retain failure artifacts and repair E2E receipts #11925

Merged

jyaunches added a commit that referenced this pull request Sep 16, 2026

Merge main fix #11926 into fix/telegram-runtime-credential-10847

95dadcd

deepujain mentioned this pull request Sep 16, 2026

Buildless docs E2E asserts Hermes onboarding prose removed by #11907 #11942

Closed

1 of 4 tasks

jyaunches mentioned this pull request Sep 17, 2026

test(e2e): verify absent gateways during initial cleanup #11912

Merged

Navigation Menu

Repository navigation

docs: restore Hermes variant page structure - #11926

docs: restore Hermes variant page structure#11926
jyaunches merged 1 commit into
mainfrom
codex/fix-main-docs-variants

jyaunches commented Sep 16, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

copy-pr-bot Bot commented Sep 16, 2026

Uh oh!

coderabbitai Bot commented Sep 16, 2026 •

edited

Loading

Review failed

Walkthrough

Changes

Uh oh!

github-actions Bot commented Sep 16, 2026

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

jyaunches commented Sep 16, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Outcome

Why

Changes

Verification

Summary by CodeRabbit

Uh oh!

copy-pr-bot Bot commented Sep 16, 2026

Uh oh!

coderabbitai Bot commented Sep 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review failed

Walkthrough

Changes

Uh oh!

github-actions Bot commented Sep 16, 2026

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

jyaunches commented Sep 16, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Sep 16, 2026 •

edited

Loading