Guida Rapida

Segui questi passaggi per iniziare con NemoClaw e il tuo primo agente OpenClaw in sandbox.

Nota: NemoClaw attualmente richiede un’installazione pulita di OpenClaw.

Prerequisiti

• Una macchina Linux (Ubuntu 22.04+ raccomandata) o macOS con Docker/Colima.
• Docker Engine 20+ in esecuzione.
• Node.js 20+ installato.

Installare NemoClaw

Esegui l’installer con un singolo comando:

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

Lo script installa la CLI di NemoClaw e le sue dipendenze. Se Node.js non è presente, lo script lo installa tramite nvm.

Eseguire la Procedura Guidata di Onboarding

Avvia la procedura guidata di configurazione interattiva:

$ nemoclaw onboard

La procedura guidata esegue i seguenti passaggi:

1. Richiede la tua API key NVIDIA (ottienine una da build.nvidia.com).
2. Crea un gateway OpenShell.
3. Registra il provider di inferenza NVIDIA con il modello Nemotron 3 Super 120B.
4. Compila l’immagine della sandbox e crea la sandbox.
5. Applica la policy di rete di base.

Connettersi alla Sandbox

Dopo il completamento dell’onboarding, connettiti all’agente in sandbox:

$ nemoclaw my-assistant connect

Questo apre una sessione interattiva con l’agente OpenClaw in esecuzione all’interno della sandbox.

Eseguire il Primo Prompt

Invia un messaggio di test per verificare che tutto funzioni:

$ openclaw agent --agent main --local -m "Hello from my secure sandbox" --session-id test

L’agente elabora il prompt utilizzando il modello Nemotron configurato attraverso il gateway OpenShell.

Passaggi Successivi

• Cambiare provider di inferenza per utilizzare un modello o endpoint diverso.
• Approvare o negare richieste di rete quando l’agente tenta di raggiungere host esterni.
• Personalizzare la policy di rete per pre-approvare domini affidabili.
• Effettuare il deploy su un’istanza GPU remota per un funzionamento always-on.
• Monitorare l’attività della sandbox attraverso la TUI di OpenShell.

Risoluzione dei Problemi

Se riscontri problemi durante l’installazione o l’onboarding, consulta la guida alla risoluzione dei problemi per i messaggi di errore comuni e i passaggi di risoluzione.