Running Hermes Inside NVIDIA OpenShell: the NemoClaw Sandbox Guide


You gave an agent your terminal, your SSH keys, your home directory and the ability to install packages — and it works, right up until the moment you want to run it on a machine that matters. An always-on agent on a shared box, a workstation with production credentials nearby, or a box that a teammate also uses: now every “just run this” is a decision about blast radius. NVIDIA’s answer is to stop arguing about permissions and put the whole agent in a container with a network allow-list, then keep the API keys on the host where the agent cannot read them.

What NemoClaw is

NVIDIA NemoClaw is an open-source (Apache-2.0) reference stack for running always-on AI agents more safely inside NVIDIA OpenShell sandboxes. Its own description names three supported agents, and Hermes is one of them:

Run agents like Hermes, LangChain Deep Agents, and OpenClaw more securely inside NVIDIA OpenShell with managed inference

It is not a Hermes fork and it does not change how you use Hermes. It is the packaging around it: a host CLI (nemohermes is the NemoClaw CLI with Hermes pre-selected), a versioned container blueprint, an onboarding wizard, and an agent-specific integration layer. The repository’s own framing is worth repeating before you invest an evening in it:

NemoClaw is an early-preview reference stack for a trusted operator on one host. It is not a hosted service, a multi-tenant enterprise control plane, or an enterprise identity system.

What the sandbox actually enforces

Capability What it means in practice
Sandboxed execution The agent runs in OpenShell with filesystem, process and network controls applied from first boot
Routed inference The agent calls inference.local inside the sandbox; OpenShell forwards to the provider you chose. Inference credentials stay on the host
Operator-controlled egress YAML network policy plus presets. Unapproved destinations are blocked and surfaced as requests for you to review
Managed MCP servers Authenticated HTTPS Streamable HTTP MCP servers for the agent, with credential placeholders replaced by OpenShell at approved egress boundaries
Lifecycle Versioned, digest-verified blueprints; status, logs, rebuild, recovery, snapshot and restore
State migration Moving agent state between machines with credential stripping and integrity verification

The design decision that matters most for a Hermes user is the inference path. Your provider key is never inside the sandbox. The agent talks to a local endpoint, OpenShell decides where that actually goes, and the key lives with the operator — so a prompt-injected agent that dumps its environment finds an endpoint name, not a secret.

Getting Hermes into a sandbox

On a supported host, the installer is one command, and it asks which agent you want. Express install defaults to OpenClaw, so answer n at the preset prompt to pick Hermes, a sandbox name, a provider and a model interactively:

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

For a scripted install, set the answers up front instead of answering prompts:

export NEMOCLAW_AGENT=hermes
export NEMOCLAW_NON_INTERACTIVE=1
export NEMOCLAW_ACCEPT_THIRD_PARTY_SOFTWARE=1
export NEMOCLAW_SANDBOX_NAME=my-hermes
export NVIDIA_INFERENCE_API_KEY=<your-key>
curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash

Afterwards nemohermes onboard re-enters the wizard, which is also the fastest way to see the options on your machine before committing to a config.

The provider list is broad, and one entry is Hermes-specific: alongside NVIDIA Endpoints (NEMOCLAW_PROVIDER=build), OpenRouter, OpenAI, Anthropic, Gemini, the Model Router (routed), OpenAI- and Anthropic-compatible endpoints and a ready local vLLM server, there is NEMOCLAW_PROVIDER=hermes-provider, documented as Hermes-only. Local Ollama is offered for OpenClaw and Hermes when it is installed, running, or installable.

When onboarding finishes, the wizard prints the two addresses you will actually use:

NemoHermes is ready

Sandbox:  my-hermes
Model:    nvidia/nemotron-3-super-120b-a12b (NVIDIA Endpoints)

  Hermes Agent Dashboard
  Port 18789 must be forwarded before opening this URL.
  http://127.0.0.1:18789/

  Hermes Agent OpenAI-compatible API
  Port 8642 must be forwarded before connecting.
  http://127.0.0.1:8642/v1

Both ports are forwarded from the host, not published by the sandbox — so reaching the dashboard from another machine is an explicit step, not a default.

Two Hermes-specific details worth knowing

The baseline network policy is written for Hermes, not for a generic agent. NemoClaw ships an agent-specific policy that lets the Hermes binary and its Python runtime reach the endpoints they need: Nous Research service endpoints, PyPI, NVIDIA inference endpoints, and selected messaging APIs. If you enable messaging channels, read the policy before you flip the switch — the docs point you at the messaging-channel and network-policy pages for exactly that reason.

Light terminals get a managed skin. When you connect to a Hermes sandbox from a terminal with poor contrast handling, NemoClaw may install a managed nemoclaw-light Hermes skin so the assistant text stays readable. It removes that managed state again when the terminal no longer needs it, and it preserves a skin you chose yourself.

Where the preview stops

Being clear about this saves you a bad afternoon:

  • Platforms: Linux and DGX Spark are the primary tested platforms. macOS, WSL, DGX Station and headless Linux servers are documented with their own limitations rather than promised.
  • Scale: one trusted operator, one host. No multi-tenancy, no enterprise identity.
  • Enforcement is host-dependent. The docs say enforcement limitations vary by host; a sandbox is only as strong as the kernel features underneath it.
  • It is a preview. Digest-verified blueprints and a documented lifecycle are real, but the stack is young and the docs themselves call it early-preview.

One more honest note: if your actual problem is “the agent keeps running commands I did not approve”, Hermes already has an approval gate and a deny list for that, and a sandbox is a different tool aimed at a different threat. The two compose well — the sandbox decides what the agent can touch, approvals decide what it may do.

Should you use it?

If you are running Hermes on a laptop where you watch every turn, NemoClaw is more machinery than you need. It starts to pay for itself the moment the agent runs unattended: a long-lived gateway on a workstation, a home server, or a box that other people also log into. The parts worth adopting even if you never install it are the design ideas — inference routed through a local endpoint so the key never enters the agent’s world, egress as a reviewed allow-list rather than a firewall footnote, and secrets replaced at the boundary instead of handed to the process.

The NemoClaw documentation walks through host readiness, provider choices and network policy. Closer to home: the sandbox is orthogonal to what Hermes itself does about approvals, and if you want Hermes running somewhere permanent, the gateway self-heal and loop watchdog write-ups cover the parts that keep an unattended install alive.


Sources: the NemoClaw repository README and the NVIDIA NemoClaw documentation (Hermes quickstart and overview pages); repository metadata (Apache-2.0, ~22.7k stars, actively pushed as of October 16, 2026); the Hermes baseline network policy and nemohermes CLI details are from the NemoClaw Hermes quickstart.