docs: refresh 0.0.58 release docs and refresh skills#4743
Conversation
Document the 0.0.58 release-facing behavior changes. Refresh generated user skills for release prep.
|
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Enterprise Run ID: 📒 Files selected for processing (1)
✅ Files skipped from review due to trivial changes (1)
📝 WalkthroughWalkthroughThis PR standardizes CLI examples to ChangesNemoClaw Documentation Consolidation and Feature Notes
🎯 3 (Moderate) | ⏱️ ~25 minutes Possibly related PRs
Suggested labels
Suggested reviewers
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
|
🌿 Preview your docs: https://nvidia-preview-pr-4743.docs.buildwithfern.com/nemoclaw |
PR Review AdvisorFindings: 0 needs attention, 1 worth checking, 0 nice ideas Review findings🛠️ Needs attention
🔎 Worth checking
🌱 Nice ideas
This is an automated advisory review. A human maintainer must make the final merge decision. |
E2E Advisor RecommendationRequired E2E: None Full advisor summaryE2E Recommendation AdvisorBase: Required E2E
Optional E2E
New E2E recommendations
|
E2E Scenario Advisor RecommendationRequired scenario E2E: None Full scenario advisor summaryE2E Scenario AdvisorBase: Required scenario E2E
Optional scenario E2E
Relevant changed files
|
There was a problem hiding this comment.
Actionable comments posted: 3
🧹 Nitpick comments (3)
.agents/skills/nemoclaw-user-reference/references/commands-nemohermes.md (1)
1601-1601: ⚡ Quick winSplit this into one sentence per source line.
Line 1601 contains multiple sentences on a single line, which hurts diff readability.
As per coding guidelines, "One sentence per line in source (makes diffs readable)."
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In @.agents/skills/nemoclaw-user-reference/references/commands-nemohermes.md at line 1601, The sentence on the same line mixes multiple statements; split it into separate lines so each sentence is on its own line. Specifically, break the paragraph that mentions the preset openclaw-diagnostics-otel-local, the condition NEMOCLAW_OPENCLAW_OTEL=1, and the guidance about enabling OTEL after sandbox creation into one sentence per line (one sentence stating onboarding applies the openclaw-diagnostics-otel-local preset at sandbox create and again during the policy step when NEMOCLAW_OPENCLAW_OTEL=1; one sentence stating OTLP export is allowed before the gateway's first trace flush; one sentence instructing to run nemohermes <sandbox-name> policy-add openclaw-diagnostics-otel-local --yes or recreate the sandbox with OTEL enabled at build time if OTEL was enabled after creation)..agents/skills/nemoclaw-user-reference/references/commands.md (1)
1872-1872: ⚡ Quick winSplit this into one sentence per source line.
Line 1872 contains multiple sentences on a single line, which hurts diff readability and violates the docs formatting rule.
As per coding guidelines, "One sentence per line in source (makes diffs readable). Flag paragraphs where multiple sentences appear on the same line."
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In @.agents/skills/nemoclaw-user-reference/references/commands.md at line 1872, Split the long line into separate source lines so each sentence stands alone: break the line mentioning the preset `openclaw-diagnostics-otel-local`, the condition `NEMOCLAW_OPENCLAW_OTEL=1`, the note about OTLP export/gateway flush, and the instructions to run `nemoclaw <sandbox-name> policy-add openclaw-diagnostics-otel-local --yes` or recreate the sandbox into individual sentences on their own lines, preserving backticks and punctuation.docs/about/release-notes.mdx (1)
20-24: ⚡ Quick winUse one sentence per source line in these bullets.
Each changed bullet currently includes multiple sentences on the same line; split sentence boundaries into separate lines to match docs formatting rules.
As per coding guidelines: "One sentence per line in source (makes diffs readable). Flag paragraphs where multiple sentences appear on the same line."
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@docs/about/release-notes.mdx` around lines 20 - 24, The release-notes bullet lines each contain multiple sentences on the same source line; update each bullet so every sentence is on its own line (e.g., split the line starting with "GPU and local-inference setup report more accurate state." into separate lines for each sentence, do the same for the bullets beginning "Onboarding and installer failures stop earlier...", "Policy and sandbox hardening paths avoid misleading success.", "OpenClaw runtime diagnostics can export conversation traces...", and "Hermes sandboxes are more reliable..."), ensuring one sentence per source line to comply with the "one sentence per line" docs rule.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In
@.agents/skills/nemoclaw-user-manage-sandboxes/references/runtime-controls.md:
- Line 81: The bullet contains a duplicated command name: "every `nemoclaw` and
`nemoclaw` command"; remove the duplicate and make the phrase unambiguous (e.g.,
"every `nemoclaw` command") or replace the second occurrence with the correct
command if a different tool was intended; update the sentence that references
the `nemoclaw-user-reference` skill so it clearly lists the distinct commands
and the environment variables that affect runtime behavior.
In @.agents/skills/nemoclaw-user-manage-sandboxes/SKILL.md:
- Line 25: Fix the duplicated CLI name in the sentence on line 25 of SKILL.md:
replace the repeated "`nemoclaw`" with the intended "`nemoclaw-user-reference`"
so the sentence reads that the boundary is between `nemoclaw`,
`nemoclaw-user-reference`, and `openshell` (reference the mentioned
`nemoclaw-user-reference` skill and the existing `nemoclaw`/`openshell` CLI
names to locate the text to update).
In @.agents/skills/nemoclaw-user-overview/references/release-notes.md:
- Around line 9-19: The file
.agents/skills/nemoclaw-user-overview/references/release-notes.md is an
autogenerated skill doc and must not be edited directly; revert any direct edits
here and instead update the canonical source documentation (the release-notes
source used to generate the NemoClaw user skills), then run the skill generation
pipeline to regenerate the skill outputs (so the changes propagate into the
generated release-notes.md); ensure you locate the original source file that
feeds the generator (the release notes source for the NemoClaw user docs) and
apply the content changes there rather than modifying the generated
.agents/skills/*/*.md file.
---
Nitpick comments:
In @.agents/skills/nemoclaw-user-reference/references/commands-nemohermes.md:
- Line 1601: The sentence on the same line mixes multiple statements; split it
into separate lines so each sentence is on its own line. Specifically, break the
paragraph that mentions the preset openclaw-diagnostics-otel-local, the
condition NEMOCLAW_OPENCLAW_OTEL=1, and the guidance about enabling OTEL after
sandbox creation into one sentence per line (one sentence stating onboarding
applies the openclaw-diagnostics-otel-local preset at sandbox create and again
during the policy step when NEMOCLAW_OPENCLAW_OTEL=1; one sentence stating OTLP
export is allowed before the gateway's first trace flush; one sentence
instructing to run nemohermes <sandbox-name> policy-add
openclaw-diagnostics-otel-local --yes or recreate the sandbox with OTEL enabled
at build time if OTEL was enabled after creation).
In @.agents/skills/nemoclaw-user-reference/references/commands.md:
- Line 1872: Split the long line into separate source lines so each sentence
stands alone: break the line mentioning the preset
`openclaw-diagnostics-otel-local`, the condition `NEMOCLAW_OPENCLAW_OTEL=1`, the
note about OTLP export/gateway flush, and the instructions to run `nemoclaw
<sandbox-name> policy-add openclaw-diagnostics-otel-local --yes` or recreate the
sandbox into individual sentences on their own lines, preserving backticks and
punctuation.
In `@docs/about/release-notes.mdx`:
- Around line 20-24: The release-notes bullet lines each contain multiple
sentences on the same source line; update each bullet so every sentence is on
its own line (e.g., split the line starting with "GPU and local-inference setup
report more accurate state." into separate lines for each sentence, do the same
for the bullets beginning "Onboarding and installer failures stop earlier...",
"Policy and sandbox hardening paths avoid misleading success.", "OpenClaw
runtime diagnostics can export conversation traces...", and "Hermes sandboxes
are more reliable..."), ensuring one sentence per source line to comply with the
"one sentence per line" docs rule.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Enterprise
Run ID: a212a42a-12a2-449f-b023-755cd1035a45
📒 Files selected for processing (30)
.agents/skills/nemoclaw-user-configure-inference/SKILL.md.agents/skills/nemoclaw-user-configure-inference/references/inference-options.md.agents/skills/nemoclaw-user-configure-inference/references/switch-inference-providers.md.agents/skills/nemoclaw-user-configure-security/references/best-practices.md.agents/skills/nemoclaw-user-configure-security/references/credential-storage.md.agents/skills/nemoclaw-user-deploy-remote/SKILL.md.agents/skills/nemoclaw-user-deploy-remote/references/sandbox-hardening.md.agents/skills/nemoclaw-user-get-started/references/prerequisites.md.agents/skills/nemoclaw-user-manage-policy/SKILL.md.agents/skills/nemoclaw-user-manage-policy/references/integration-policy-examples.md.agents/skills/nemoclaw-user-manage-sandboxes/SKILL.md.agents/skills/nemoclaw-user-manage-sandboxes/references/backup-restore.md.agents/skills/nemoclaw-user-manage-sandboxes/references/messaging-channels.md.agents/skills/nemoclaw-user-manage-sandboxes/references/runtime-controls.md.agents/skills/nemoclaw-user-manage-sandboxes/references/workspace-files.md.agents/skills/nemoclaw-user-monitor-sandbox/SKILL.md.agents/skills/nemoclaw-user-overview/references/how-it-works.md.agents/skills/nemoclaw-user-overview/references/overview.md.agents/skills/nemoclaw-user-overview/references/release-notes.md.agents/skills/nemoclaw-user-reference/SKILL.md.agents/skills/nemoclaw-user-reference/references/cli-selection-guide.md.agents/skills/nemoclaw-user-reference/references/commands-nemohermes.md.agents/skills/nemoclaw-user-reference/references/commands.md.agents/skills/nemoclaw-user-reference/references/troubleshooting.mddocs/about/release-notes.mdxdocs/get-started/prerequisites.mdxdocs/inference/switch-inference-providers.mdxdocs/inference/use-local-inference.mdxdocs/reference/commands-nemohermes.mdxdocs/reference/commands.mdx
💤 Files with no reviewable changes (2)
- .agents/skills/nemoclaw-user-configure-security/references/credential-storage.md
- .agents/skills/nemoclaw-user-manage-policy/references/integration-policy-examples.md
Summary
binutilsprerequisite, CUDA proof status output, policy-add safety behavior, and vLLM runtime context-window metadata.Source summary
docs/about/release-notes.mdx,docs/reference/commands.mdx,docs/inference/use-local-inference.mdx: Document WSL Docker Desktop GPU proof acceptance and CUDA proof status reporting.docs/inference/use-local-inference.mdx,docs/inference/switch-inference-providers.mdx: Document vLLM runtimemax_model_lenuse for context-window metadata.docs/about/release-notes.mdx: Capture DeepSeek managed-vLLM runtime argument handling in the release notes.docs/get-started/prerequisites.mdx: Document the installer'sbinutils/stringsprerequisite and remediation.docs/about/release-notes.mdx: Capture fail-fast Docker unreachable handling during gateway startup.docs/about/release-notes.mdx: Capture WSL Docker Desktop integration diagnostics.docs/about/release-notes.mdx: Capture Windows-host Ollama detection when the daemon is stopped.docs/about/release-notes.mdx: Capture runtime forwarding for custom sandbox proxy host and port settings.docs/reference/commands.mdx: Document refusal to merge policy presets when the live policy read is unparseable.docs/reference/commands.mdx: Document the warning when custom presets cannot be recorded in the local sandbox registry.docs/about/release-notes.mdx: Capture opt-in fail-closed capability dropping.docs/about/release-notes.mdx,docs/reference/commands.mdx: Include OpenClaw OTEL diagnostics in the release summary and generated references.docs/about/release-notes.mdx,docs/manage-sandboxes/messaging-channels.mdx: Summarize Hermes messaging, inference, startup marker cleanup, and locked-state repair improvements..agents/skills/,docs/reference/commands-nemohermes.mdx: Refresh generated docs and user skills from the current agent-variant source docs.docs/about/release-notes.mdx: Include already-landed docs catch-up items in the v0.0.58 release summary.Verification
npm run docs:sync-agent-variantspython3 scripts/docs-to-skills.py docs/ .agents/skills/ --prefix nemoclaw-user --doc-platform fern-mdxnpm run docsNote: this repository does not currently have a literal
documentationlabel; this PR usesarea: docsplusv0.0.58.Summary by CodeRabbit
nemoclawacross docs for simpler, consistent commands.diagnostics-otelpreset.strings(binutils) with troubleshooting steps.