Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 15 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
[![Security Policy](https://img.shields.io/badge/Security-Report%20a%20Vulnerability-red)](SECURITY.md)
[![Project Status](https://img.shields.io/badge/status-alpha-orange)](docs/about/release-notes.md)

NVIDIA NemoClaw is an open source stack that simplifies running [OpenClaw](https://openclaw.ai) always-on assistants safely. It installs the [NVIDIA OpenShell](https://github.com/NVIDIA/OpenShell) runtime, part of [NVIDIA Agent Toolkit](https://docs.nvidia.com/nemo/agent-toolkit/latest), a secure environment for running autonomous agents, and open source models like [NVIDIA Nemotron](https://build.nvidia.com).
NVIDIA NemoClaw is an open source stack that simplifies running [OpenClaw](https://openclaw.ai) always-on assistants safely. It installs the [NVIDIA OpenShell](https://github.com/NVIDIA/OpenShell) runtime, part of [NVIDIA Agent Toolkit](https://docs.nvidia.com/nemo/agent-toolkit/latest), a secure environment for running autonomous agents, with inference routed through [NVIDIA cloud](https://build.nvidia.com).

> **Alpha software**
>
Expand Down Expand Up @@ -101,28 +101,25 @@ NemoClaw installs the NVIDIA OpenShell runtime and Nemotron models, then uses a
| **Plugin** | TypeScript CLI commands for launch, connect, status, and logs. |
| **Blueprint** | Versioned Python artifact that orchestrates sandbox creation, policy, and inference setup. |
| **Sandbox** | Isolated OpenShell container running OpenClaw with policy-enforced egress and filesystem. |
| **Inference** | NVIDIA-routed model calls (cloud, local NIM, or vLLM), transparent to the agent. |
| **Inference** | NVIDIA cloud model calls, routed through the OpenShell gateway, transparent to the agent. |

The blueprint lifecycle follows four stages: resolve the artifact, verify its digest, plan the resources, and apply through the OpenShell CLI.

When something goes wrong, errors may originate from either NemoClaw or the OpenShell layer underneath. Run `nemoclaw <name> status` for NemoClaw-level health and `openshell sandbox list` to check the underlying sandbox state.

## Inference Profiles
---

Inference requests from the agent never leave the sandbox directly. OpenShell intercepts every call and routes it to the configured provider. NemoClaw ships with three profiles:
## Inference

| Profile | Provider | Model | Use Case |
|-------------|--------------|--------------------------------------|-------------------------------------------------|
| `default` | NVIDIA cloud | `nvidia/nemotron-3-super-120b-a12b` | Production. Requires an NVIDIA API key. |
| `nim-local` | Local NIM | `nvidia/nemotron-3-super-120b-a12b` | On-premises. NIM deployed as a local container. |
| `vllm` | vLLM | `nvidia/nemotron-3-nano-30b-a3b` | Local development. vLLM on the host. |
Inference requests from the agent never leave the sandbox directly. OpenShell intercepts every call and routes it to the NVIDIA cloud provider.

Select a profile at launch with `--profile`, or switch at runtime without restarting the sandbox:
| Provider | Model | Use Case |
|--------------|--------------------------------------|-------------------------------------------------|
| NVIDIA cloud | `nvidia/nemotron-3-super-120b-a12b` | Production. Requires an NVIDIA API key. |

```console
$ openclaw nemoclaw launch --profile vllm
$ openshell inference set --provider vllm-local --model nvidia/nemotron-3-nano-30b-a3b
```
Get an API key from [build.nvidia.com](https://build.nvidia.com). The `nemoclaw onboard` command prompts for this key during setup.

---

## Protection Layers

Expand All @@ -137,6 +134,8 @@ The sandbox starts with a strict baseline policy that controls network egress an

When the agent tries to reach an unlisted host, OpenShell blocks the request and surfaces it in the TUI for operator approval.

---

## Key Commands

### Host commands (`nemoclaw`)
Expand Down Expand Up @@ -167,6 +166,7 @@ See the full [CLI reference](https://docs.nvidia.com/nemoclaw/latest/reference/c
> - The `openclaw nemoclaw` plugin commands are under active development. Use the `nemoclaw` host CLI as the primary interface.
> - Setup may require manual workarounds on some platforms. File an issue if you encounter blockers.

---

## Learn More

Expand All @@ -175,7 +175,7 @@ Refer to the documentation for more information on NemoClaw.
- [Overview](https://docs.nvidia.com/nemoclaw/latest/about/overview.html): what NemoClaw does and how it fits together
- [How It Works](https://docs.nvidia.com/nemoclaw/latest/about/how-it-works.html): plugin, blueprint, and sandbox lifecycle
- [Architecture](https://docs.nvidia.com/nemoclaw/latest/reference/architecture.html): plugin structure, blueprint lifecycle, and sandbox environment
- [Inference Profiles](https://docs.nvidia.com/nemoclaw/latest/reference/inference-profiles.html): NVIDIA cloud, NIM, and vLLM configuration
- [Inference Profiles](https://docs.nvidia.com/nemoclaw/latest/reference/inference-profiles.html): NVIDIA cloud inference configuration
- [Network Policies](https://docs.nvidia.com/nemoclaw/latest/reference/network-policies.html): egress control and policy customization
- [CLI Commands](https://docs.nvidia.com/nemoclaw/latest/reference/commands.html): full command reference

Expand Down
8 changes: 1 addition & 7 deletions docs/about/how-it-works.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,13 +49,7 @@ After the sandbox starts, the agent runs inside it with all network, filesystem,

Inference requests from the agent never leave the sandbox directly.
OpenShell intercepts every inference call and routes it to the configured provider.
NemoClaw ships with three inference profiles:

- NVIDIA cloud, which routes to Nemotron 3 Super 120B through [build.nvidia.com](https://build.nvidia.com).
- Local NIM, which routes to a NIM container on your local network.
- Local vLLM, which routes to a vLLM server on localhost for offline development.

You can switch providers at runtime without restarting the sandbox.
NemoClaw routes inference to NVIDIA cloud, specifically Nemotron 3 Super 120B through [build.nvidia.com](https://build.nvidia.com). You can switch models at runtime without restarting the sandbox.

## Network and Filesystem Policy

Expand Down
2 changes: 1 addition & 1 deletion docs/about/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ It moves OpenClaw into a sandboxed environment where every network request, file
## What NemoClaw Does

- Sandboxes OpenClaw. Creates an OpenShell sandbox pre-configured for OpenClaw, with strict filesystem and network policies applied from the first boot.
- Routes inference through NVIDIA. Configures OpenShell inference routing so agent traffic flows through cloud-hosted Nemotron 3 Super 120B, a local NIM service, or vLLM, depending on the selected profile.
- Routes inference through NVIDIA cloud. Configures OpenShell inference routing so agent traffic flows through cloud-hosted Nemotron 3 Super 120B via [build.nvidia.com](https://build.nvidia.com).
- Manages the lifecycle. Handles blueprint versioning, digest verification, and sandbox setup.

## How It Fits Together
Expand Down
6 changes: 2 additions & 4 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ status: published
[![License](https://img.shields.io/badge/License-Apache_2.0-blue)](https://github.com/NVIDIA/NemoClaw/blob/main/LICENSE)

NemoClaw is the OpenClaw plugin for [NVIDIA OpenShell](https://github.com/NVIDIA/OpenShell).
It runs OpenClaw inside a sandboxed environment with NVIDIA inference, such as Nemotron 3 Super 120B through [build.nvidia.com](https://build.nvidia.com) or local vLLM.
It runs OpenClaw inside a sandboxed environment with NVIDIA cloud inference, such as Nemotron 3 Super 120B through [build.nvidia.com](https://build.nvidia.com).
The sandbox enforces strict network policies and operator-controlled egress approval.

## Get Started
Expand Down Expand Up @@ -128,7 +128,7 @@ CLI commands for launching, connecting, monitoring, and managing sandboxes.
:link: reference/inference-profiles
:link-type: doc

Switch between NVIDIA cloud, local NIM, and vLLM inference backends.
NVIDIA cloud inference configuration and available models.

+++
{bdg-secondary}`Reference`
Expand Down Expand Up @@ -203,8 +203,6 @@ Quickstart <get-started/quickstart>
:hidden:

Switch Inference Providers <inference/switch-inference-providers>
Set Up Local vLLM <inference/set-up-local-vllm>
Set Up a Local NIM Service <inference/set-up-local-nim>
```

```{toctree}
Expand Down
109 changes: 0 additions & 109 deletions docs/inference/set-up-local-nim.md

This file was deleted.

101 changes: 0 additions & 101 deletions docs/inference/set-up-local-vllm.md

This file was deleted.

Loading