Guida all'installazione

Rendi operativo NemoClaw

Scegli il metodo di installazione che preferisci. Tutti conducono allo stesso stack sicuro per agenti IA.

checklist Requisiti di sistema

javascript Node.js 20+

v20+ (raccomandata v22). Installata in automatico dallo script via nvm, se non presente.

computer OS

Ubuntu 22.04+ (raccomandato). macOS tramite Colima/Docker Desktop. Windows tramite WSL2 + Docker Desktop.

deployed_code Container Runtime

Docker (Linux), Colima o Docker Desktop (macOS), Docker Desktop con backend WSL (Windows). Podman su macOS non è ancora supportato.

memory RAM

8 GB minimo, 16 GB raccomandati

hard_drive Disk

20 GB liberi minimo, 40 GB raccomandati

extension GPU

Facoltativa. Indispensabile per l'inferenza locale Nemotron (8 GB+ VRAM). Senza GPU, l'inferenza passa per la NVIDIA Cloud API.

Script in una riga che installano lo stack completo. La scelta consigliata per la maggior parte degli utenti. Guida completa nella documentazione arrow_forward

Linux / macOS / WSL

Ubuntu 22.04+, macOS (Apple Silicon), Windows WSL2

$ curl -fsSL https://www.nvidia.com/nemoclaw.sh | bash
Compatibile con Linux (Ubuntu 22.04+), macOS (Apple Silicon tramite Colima/Docker Desktop) e Windows (WSL2 + Docker Desktop). Lo script installa Node.js in automatico e avvia nemoclaw onboard.

verified Verifica l'installazione

Lancia questi comandi per accertarti che NemoClaw sia installato correttamente.

1
$ nemoclaw list

Elenca tutte le sandbox NemoClaw. Se il comando viene riconosciuto, la CLI è correttamente installata.

2
$ nemoclaw onboard

Procedura guidata interattiva: crea una sandbox, configura l'inferenza (Nemotron locale o NVIDIA Cloud API) e applica le policy di sicurezza.

settings Configurazione iniziale

Dopo l'installazione, la procedura guidata ti accompagna nella configurazione. Ecco cosa prevede ogni fase.

1

Seleziona i modelli

Scegli fra Nemotron 3 Super 120B (locale, privacy totale), Nemotron 3 Nano 4B (edge) o modelli cloud (OpenAI, Anthropic). Il Privacy Router gestisce la selezione automatica in fase di esecuzione.

2

Definisci le policy sulla privacy

Stabilisci quali categorie di dati restano in locale e quali possono essere inoltrate ai modelli cloud. L'impostazione predefinita è la massima privacy: tutto resta in locale.

3

Configura le regole di rete

Imposta le regole per il traffico in uscita. Il valore predefinito è deny-all. Autorizza i domini e le API specifiche di cui il tuo agente ha bisogno.

4

Metti alla prova la sandbox

Fai girare un agente di test nella sandbox OpenShell. Verifica che isolamento, regole di rete e instradamento dei modelli funzionino a dovere.

.env — L'intera configurazione è salvata in ~/.nemoclaw/config.yaml. Puoi modificare questo file direttamente. Per i dettagli, consulta la guida Quickstart su /docs/get-started/quickstart.

system_update_alt Aggiornare NemoClaw

Mantieni NemoClaw aggiornato per avere sempre le ultime patch di sicurezza e le nuove funzionalità. Guida ad aggiornamento e migrazione arrow_forward

npm
$ npm update -g nemoclaw
pnpm
$ pip install --upgrade nemoclaw
Git
$ cd NemoClaw && git pull && pip install -e .
Docker
$ docker pull ghcr.io/nvidia/nemoclaw:latest && docker restart nemoclaw

Dai un'occhiata al changelog su github.com/NVIDIA/NemoClaw/releases per scoprire le novità di ogni versione.

delete_forever Disinstallare NemoClaw

Per rimuovere NemoClaw dal sistema, segui le istruzioni corrispondenti al metodo di installazione che hai usato. Procedura di disinstallazione dettagliata arrow_forward

npm
$ npm uninstall -g nemoclaw
pnpm
$ pip uninstall nemoclaw
Git (Source)
$ rm -rf ~/NemoClaw
Docker
$ docker stop nemoclaw && docker rm nemoclaw && docker rmi ghcr.io/nvidia/nemoclaw:latest

Eliminare i dati utente (facoltativo)

Questa operazione cancella tutti i blueprint, le configurazioni sandbox e i dati dei modelli. Fai un backup di quello che ti serve prima di procedere.

macOS/Linux $ rm -rf ~/.nemoclaw
Windows PS> rmdir /s /q %USERPROFILE%\.nemoclaw

build Risoluzione dei problemi

Problemi frequenti e relative soluzioni. Ulteriori consigli per la risoluzione dei problemi arrow_forward

Serve una mano?

Entra nelle GitHub Discussions per ricevere supporto sull'installazione e la risoluzione dei problemi.

Rimani al passo

Ricevi novità sulle release di NemoClaw, bollettini di sicurezza e aggiornamenti dall'ecosistema. Zero spam, puoi cancellarti in qualunque momento.