How nvidia/nemoclaw works
NemoClaw is a CLI reference stack for running supported AI agents inside OpenShell sandboxes. The principal workflow is: an operator invokes the CLI, onboarding selects an agent and inference provider, NemoClaw builds policy and runtime configuration, launches or rebuilds a sandbox, and the agent produces results through managed inference and integrations. The graph preserves lifecycle, snapshots, networking, messaging, MCP, and voice branches. Some subsystem links are documented or inferred only from directory structure; sampled source chiefly confirms orchestration, storage, policy, and runtime-adapter boundaries.
Main entry points: onboard.ts Onboarding · host-local-inference-routing.ts Inference Routing · container-engine.ts Container Engine · rebuild-pipeline.ts Rebuild Pipeline
Components 22
CLI and Onboarding
- NemoClaw CLI
- Onboarding
src/commands/onboard.ts - Agent Definitions
bin/lib/agent-defs.js
Sandbox Lifecycle
- Sandbox Actions
src/lib/actions/sandbox/launch.ts - Rebuild Pipeline
src/lib/actions/sandbox/rebuild-pipeline.ts - Snapshot Management
nemoclaw/src/blueprint/snapshot-management.ts - Blueprint Runner
nemoclaw/src/blueprint/runner.ts - Container Engine
src/lib/adapters/container-engine.ts
Security and State
- Network Policy
nemoclaw/src/blueprint/openshell-policy.ts - Runtime Authority
src/lib/onboard/runtime-provider/persisted-engine-authority.ts - MCP Lifecycle Lock
src/lib/state/mcp-lifecycle-lock-storage.ts
Inference and Agents
- Inference Routing
src/lib/onboard/runtime-provider/host-local-inference-routing.ts - Model Storage Checks
src/lib/inference/vllm-storage.ts - Supported Agent Profiles
agents
Managed Integrations
- Messaging Rendering
src/lib/messaging/compiler/engines/agent-render-engine.ts - Messaging Build Plan
src/lib/messaging/compiler/engines/build-step-engine.ts - Voice Sessions
src/lib/voice-gateway/session-service.ts
Other components
- Operator
- OpenShell
- Inference Providers
- Agent Runtime
- Messaging Channels
Connections 24
- Operator → NemoClaw CLI: invokes CLI
- NemoClaw CLI → Onboarding: dispatches
- Onboarding → Agent Definitions: selects agent
- Onboarding → Inference Routing: configures inference
- Onboarding → Sandbox Actions: starts sandbox
- Agent Definitions → Supported Agent Profiles: resolves profile
- Sandbox Actions → Blueprint Runner: runs blueprint
- Sandbox Actions → Container Engine: controls runtime
- Blueprint Runner → OpenShell: uses sandbox
- Rebuild Pipeline → Container Engine: recreates runtime
- Rebuild Pipeline → Snapshot Management: restores state
- Rebuild Pipeline → MCP Lifecycle Lock: coordinates lifecycle
- Snapshot Management → Runtime Authority: persists authority
- Network Policy → OpenShell: applies policy
- Container Engine → OpenShell: runs containers
- Inference Routing → Inference Providers: routes requests
- Inference Routing → Runtime Authority: verifies authority
- Model Storage Checks → Container Engine: probes storage
- Agent Runtime → Inference Routing: requests inference
- Agent Runtime → Messaging Rendering: renders channels
- Messaging Rendering → Messaging Channels: configures channels
- Messaging Build Plan → Agent Runtime: builds integration
- Voice Sessions → Agent Runtime: forwards turns
- Agent Runtime → Messaging Channels: exchanges messages