Comandi

NemoClaw fornisce due interfacce di comando. I comandi plugin vengono eseguiti nel namespace openclaw nemoclaw all’interno della CLI di OpenClaw. Il binario standalone nemoclaw gestisce la configurazione lato host, il deployment e la gestione dei servizi. Entrambe le interfacce vengono installate quando esegui npm install -g nemoclaw.

Comandi Plugin

openclaw nemoclaw launch

Avvia OpenClaw all’interno di una sandbox OpenShell. Se NemoClaw rileva un’installazione host esistente, launch si ferma a meno che non passi --force.

$ openclaw nemoclaw launch [--force] [--profile <profile>]

--force Salta l’avviso di ergonomia e forza il bootstrap guidato dal plugin. Senza questo flag, NemoClaw raccomanda di usare direttamente openshell sandbox create per le nuove installazioni.

--profile <profile> Profilo del blueprint da utilizzare. Predefinito: default.

nemoclaw <name> connect

Apri una shell interattiva all’interno della sandbox OpenClaw. Usa questo dopo il lancio per connetterti e chattare con l’agente attraverso la TUI o la CLI.

$ nemoclaw my-assistant connect

Se la visualizzazione TUI non è adatta per risposte molto lunghe, usa la forma CLI:

$ openclaw agent --agent main --local -m "<prompt>" --session-id <id>

Questa è la soluzione raccomandata quando hai bisogno della risposta completa stampata direttamente nel terminale.

openclaw nemoclaw status

Visualizza lo stato della sandbox, lo stato dell’esecuzione del blueprint e la configurazione dell’inferenza.

$ openclaw nemoclaw status [--json]

--json Output in formato JSON per il consumo programmatico.

Quando viene eseguito all’interno di una sandbox OpenShell attiva, il comando status rileva il contesto sandbox e riporta “active (inside sandbox)” invece di falsi negativi. Lo stato della sandbox lato host e la configurazione dell’inferenza non sono ispezionabili dall’interno della sandbox. Esegui openshell sandbox list sull’host per controllare lo stato sottostante della sandbox.

openclaw nemoclaw logs

Trasmetti in streaming i log di esecuzione del blueprint e della sandbox.

$ openclaw nemoclaw logs [-f] [-n <count>] [--run-id <id>]

-f, --follow Segui l’output dei log, simile a tail -f.

-n, --lines <count> Numero di righe da mostrare. Predefinito: 50.

--run-id <id> Mostra i log per una specifica esecuzione del blueprint invece dell’ultima.

Comando Slash /nemoclaw

Il comando slash /nemoclaw è disponibile all’interno dell’interfaccia chat di OpenClaw per azioni rapide:

Comandi Standalone per l’Host

Il binario nemoclaw gestisce le operazioni lato host che vengono eseguite al di fuori del contesto del plugin OpenClaw.

nemoclaw onboard

Esegui la procedura guidata di configurazione interattiva. La procedura crea un gateway OpenShell, registra i provider di inferenza, compila l’immagine della sandbox e crea la sandbox. Usa questo comando per nuove installazioni e per ricreare una sandbox dopo modifiche alla policy o alla configurazione.

$ nemoclaw onboard

La prima esecuzione richiede la tua API key NVIDIA e la salva in ~/.nemoclaw/credentials.json.

La procedura guidata richiede un nome per la sandbox. I nomi devono seguire le regole dei sottodomini RFC 1123: solo caratteri alfanumerici minuscoli e trattini, e devono iniziare e terminare con un carattere alfanumerico. Le lettere maiuscole vengono automaticamente convertite in minuscole.

Prima di creare il gateway, la procedura guidata esegue controlli preliminari. Sui sistemi con cgroup v2 (Ubuntu 24.04, DGX Spark, WSL2), verifica che Docker sia configurato con "default-cgroupns-mode": "host" e fornisce istruzioni per la correzione se l’impostazione manca.

nemoclaw list

Elenca tutte le sandbox registrate con il loro modello, provider e preset di policy.

$ nemoclaw list

nemoclaw deploy

Attenzione: Il comando nemoclaw deploy è sperimentale e potrebbe non funzionare come previsto.

Effettua il deploy di NemoClaw su un’istanza GPU remota attraverso Brev. Lo script di deploy installa Docker, NVIDIA Container Toolkit se è presente una GPU, e OpenShell sulla VM, poi esegue la configurazione di NemoClaw e si connette alla sandbox.

$ nemoclaw deploy <instance-name>

nemoclaw <name> connect

Connettiti a una sandbox per nome.

$ nemoclaw my-assistant connect

nemoclaw <name> status

Mostra lo stato della sandbox, lo stato di salute e la configurazione dell’inferenza.

$ nemoclaw my-assistant status

nemoclaw <name> logs

Visualizza i log della sandbox. Usa --follow per trasmettere in streaming l’output in tempo reale.

$ nemoclaw my-assistant logs [--follow]

nemoclaw <name> destroy

Arresta il container NIM e cancella la sandbox. Questo rimuove la sandbox dal registro.

$ nemoclaw my-assistant destroy

nemoclaw <name> policy-add

Aggiungi un preset di policy a una sandbox. I preset estendono la policy di rete di base con endpoint aggiuntivi.

$ nemoclaw my-assistant policy-add

nemoclaw <name> policy-list

Elenca i preset di policy disponibili e mostra quali sono applicati alla sandbox.

$ nemoclaw my-assistant policy-list

openshell term

Apri la TUI di OpenShell per monitorare l’attività della sandbox e approvare le richieste di egress di rete. Esegui questo sull’host dove la sandbox è in esecuzione.

$ openshell term

Per un’istanza Brev remota, connettiti via SSH all’istanza ed esegui openshell term lì, oppure usa un port-forward verso il gateway.

nemoclaw start

Avvia i servizi ausiliari, come il bridge Telegram e il tunnel cloudflared.

$ nemoclaw start

Richiede TELEGRAM_BOT_TOKEN per il bridge Telegram.

nemoclaw stop

Arresta tutti i servizi ausiliari.

$ nemoclaw stop

nemoclaw status

Mostra l’elenco delle sandbox e lo stato dei servizi ausiliari.

$ nemoclaw status

nemoclaw setup-spark

Configura NemoClaw su DGX Spark. Questo comando applica le correzioni per cgroup v2 e Docker richieste per Ubuntu 24.04. Esegui con sudo sull’host Spark. Dopo il completamento delle correzioni, lo script ti invita a eseguire nemoclaw onboard per continuare la configurazione.

$ sudo nemoclaw setup-spark