nvidia-nemoclaw
nvidia-nemoclaw — an installable skill for AI agents.
By reason-machines · 1,386 installs
npx skills add reason-machines/trending-skills --skill nvidia-nemoclaw
Source repository · Upstream listing
NVIDIA NemoClaw
Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection.
NVIDIA NemoClaw is an open source TypeScript CLI plugin that simplifies running [OpenClaw](https://openclaw.ai) always on AI assistants securely. It installs and orchestrates the [NVIDIA OpenShell](https://github.com/NVIDIA/OpenShell) runtime, creates policy enforced sandboxes, and routes all inference through NVIDIA cloud (Nemotron models). Network egress, filesystem access, syscalls, and model API calls are all governed by declarative policy.
Status: Alpha — interfaces and APIs may change without notice.
Installation
Prerequisites
Linux Ubuntu 22.04 LTS or later
Node.js 20+ and npm 10+ (Node.js 22 recommended)
Docker installed and running
[NVIDIA OpenShell](https://github.com/NVIDIA/OpenShell) installed
One Line Installer
This installs Node.js (if absent), runs the guided onboard wizard, creates a sandbox, configures inference, and applies security policies.
Manual Install (from source)
Environment Variables
Get an API key at [build.nvidia.com](https://build.nvidia.com).
Quick Start
1. Onboard a New Agent
The interactive wizard prompts for:
Sandbox name (e.g. my assistant )
NVIDIA API key ( $NVIDIA API KEY )
Inference model selection
Network and filesystem policy configuration
Expected output on success:
2. Connect to the Sandbox
3. Chat with the Agent (inside sandbox)
TUI (interactive chat):
CLI (single message):
Key CLI Commands
Host Commands ( nemoclaw )
Command Description
nemoclaw onboard Interactive setup: gateway, providers, sandbox
nemoclaw <name connect Open interactive shell inside sandbox
nemoclaw <name status Show NemoClaw level sandbox health
nemoclaw <name logs follow Stream sandbox logs
nemoclaw start Start auxiliary services (Telegram bridge, tunnel)
nemoclaw stop Stop auxiliary services
nemoclaw deploy <instance Deploy to remote GPU instance via Brev
openshell term Launch OpenShell TUI for monitoring and approvals
Plugin Commands ( openclaw nemoclaw , run inside sandbox)
Note: These are under active development — use nemoclaw host CLI as the primary interface.
Command Description
openclaw nemoclaw launch [ profile ...] Bootstrap OpenClaw inside OpenShell sandbox
openclaw nemoclaw status Show sandbox health, blueprint state, and inference
openclaw nemoclaw logs [ f] Stream blueprint execution and sandbox logs
OpenShell Inspection
Architecture
NemoClaw orchestrates four components:
Component Role
Plugin TypeScript CLI: launch, connect, status, logs
Blueprint Versioned Python artifact: sandbox creation, policy, inference setup
Sandbox Isolated OpenShell container running OpenClaw with policy enforced egress/filesystem
Inference NVIDIA cloud model calls routed through OpenShell gateway
Blueprint lifecycle:
1. Resolve artifact
2. Verify digest
3. Plan resources
4. Apply through OpenShell CLI
TypeScript Plugin Usage
NemoClaw exposes a programmatic TypeScript API for building custom integrations.
Import and Initialize
Create a Sandbox Programmatically
Connect and Send a Message
Check Sandbox Status
Stream Logs
Apply a Network Policy Update (Hot Reload)
Security / Protection Layers
Layer What it protects Hot reloadable?
Network Blocks unauthorized outbound connections ✅ Yes
Filesystem Prevents reads/writes outside /sandbox and /tmp ❌ Locked at creation
Process Blocks privilege escalation and dangerous syscalls ❌ Locked at creation
Inference Reroutes model API calls to controlled backends ✅ Yes
When the agent attempts to reach an unlisted host, OpenShell blocks the request and surfaces it in the TUI for operator approval.
Common Patterns
Pattern: Minimal Sandbox for Development
Pattern: Production Strict Sandbox
Pattern: Deploy to Remote GPU (Brev)
Troubleshooting
Error: Sandbox not found
Fix: Check at the OpenShell layer — NemoClaw errors and OpenShell errors are separate:
Error: NVIDIA API key missing or invalid
Fix:
Error: Docker not running
Fix:
Error: OpenShell not installed
Fix: Install [NVIDIA OpenShell](https://github.com/NVIDIA/OpenShell) first, then re run the NemoClaw installer.
Agent blocked on outbound request
When you see a blocked request notification in the TUI:
View Full Debug Logs
Documentation Links
[Overview](https://docs.nvidia.com/nemoclaw/latest/about/overview.html)
[How It Works](https://docs.nvidia.com/nemoclaw/latest/about/how it works.html)
[Architecture](https://docs.nvidia.com/nemoclaw/latest/reference/architecture.html)
[Inference Profiles](https://docs.nvidia.com/nemoclaw/latest/reference/inference profiles.html)
[Network Policies](https://docs.nvidia.com/nemoclaw/latest/reference/network policies.html)
[CLI Commands](https://docs.nvidia.com/nemoclaw/latest/reference/commands.html)