NVIDIA / NVIDIA/NemoClaw

Register External Component page links to a non-existent flat inference/switch-providers path

Open
#11,988 0 comments 0 reactions 0 assignees View on GitHub
area: docs needs: triage NV QA
Dominant language
TypeScript
Stars
22.5k
Forks
3.1k
Avg merge
1d 1h
Merged PRs (30d)
715

Description

## Description

The published "Register an External Component During Onboarding" page contains a relative link whose target path does not exist. Following the "Switch Inference Providers" link returns HTTP 404.

**Platform scope:** Published documentation content issue, independent of client platform; reproduced by direct URL fetch.
**Regression:** Unknown — earlier documentation versions not tested.
**OpenShell issue:** No.

## Environment

```text
Device: Documentation validation workstation
OS: macOS
Architecture: arm64
Node.js: N/A - static published-document validation only
npm: N/A - static published-document validation only
Docker: N/A - static published-document validation only
OpenShell CLI: N/A - static published-document validation only
NemoClaw: N/A - static published-document validation only
OpenClaw: N/A - static published-document validation only
```

## Steps to Reproduce

1. Open https://docs.nvidia.com/nemoclaw/deployment/register-external-component
2. In the "Select Interceptor-Supplied Policy" section, find the "Switch Inference Providers" link.
3. Follow the link. Its target resolves to `https://docs.nvidia.com/nemoclaw/inference/switch-providers`
4. Observe that this target returns HTTP 404.

## Expected Result

The link resolves to a real, existing documentation page describing how to switch inference providers/models for a sandbox.

## Actual Result

The target `https://docs.nvidia.com/nemoclaw/inference/switch-providers` returns "This page does not exist" (HTTP 404). The `.md` variant of the same path also 404s.

The site's actual content for this topic is published under per-agent-runtime nested paths instead of the flat path this link assumes:

- `/nemoclaw/user-guide/openclaw/inference/manage-inference/switch-providers`
- `/nemoclaw/user-guide/deepagents/inference/manage-inference/switch-providers`
- `/nemoclaw/user-guide/hermes/inference/manage-inference/switch-providers`

The Register External Component page's own content is agent-runtime-agnostic, so it is unclear which of the three (if any single one) the link is meant to target.

Every other link on the page (CLI commands reference, its `--apf-interceptor` anchor, gateway lifecycle authority, host files and state) was individually verified reachable with content consistent with the page's references.

## Logs

```text
Not captured - static published-document validation only, no terminal/application log applies.
```

Contributor guide

Open the contributing guide

Research direction

Start at the published Register External Component During Onboarding page and inspect the broken relative link in the Select Interceptor-Supplied Policy section. Compare the three listed per-agent-runtime switch-providers paths, determine the intended destination for this agent-runtime-agnostic page, update the link, and verify the published target no longer returns HTTP 404.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.