Commandes

NemoClaw fournit deux interfaces de commande. Les commandes du plugin fonctionnent sous l’espace de noms openclaw nemoclaw à l’intérieur du CLI OpenClaw. Le binaire autonome nemoclaw gère la configuration côté hôte, le déploiement et la gestion des services. Les deux interfaces sont installées lorsque vous exécutez npm install -g nemoclaw.

Commandes du plugin

openclaw nemoclaw launch

Initialise OpenClaw dans un sandbox OpenShell. Si NemoClaw détecte une installation existante sur l’hôte, launch s’arrête sauf si vous passez --force.

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

--force Ignore l’avertissement d’ergonomie et force l’initialisation pilotée par le plugin. Sans ce drapeau, NemoClaw recommande d’utiliser directement openshell sandbox create pour les nouvelles installations.

--profile <profile> Profil de blueprint à utiliser. Par défaut : default.

nemoclaw <name> connect

Ouvre un shell interactif à l’intérieur du sandbox OpenClaw. Utilisez cette commande après le lancement pour vous connecter et discuter avec l’agent via le TUI ou le CLI.

$ nemoclaw my-assistant connect

Si la vue TUI n’est pas adaptée aux réponses très longues, utilisez plutôt le formulaire CLI :

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

C’est la solution recommandée lorsque vous avez besoin de la réponse complète affichée directement dans le terminal.

openclaw nemoclaw status

Affiche la santé du sandbox, l’état d’exécution du blueprint et la configuration d’inférence.

$ openclaw nemoclaw status [--json]

--json Sortie au format JSON pour une consommation programmatique.

Lorsque la commande est exécutée à l’intérieur d’un sandbox OpenShell actif, la commande de statut détecte le contexte du sandbox et signale « active (inside sandbox) » au lieu de faux négatifs. L’état du sandbox côté hôte et la configuration d’inférence ne sont pas inspectables depuis l’intérieur du sandbox. Exécutez openshell sandbox list sur l’hôte pour vérifier l’état sous-jacent du sandbox.

openclaw nemoclaw logs

Diffuse les journaux d’exécution du blueprint et du sandbox.

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

-f, --follow Suit la sortie du journal, similaire à tail -f.

-n, --lines <count> Nombre de lignes à afficher. Par défaut : 50.

--run-id <id> Affiche les journaux d’une exécution de blueprint spécifique au lieu de la plus récente.

Commande slash /nemoclaw

La commande slash /nemoclaw est disponible dans l’interface de chat OpenClaw pour des actions rapides :

Commandes autonomes de l’hôte

Le binaire nemoclaw gère les opérations côté hôte qui s’exécutent en dehors du contexte du plugin OpenClaw.

nemoclaw onboard

Exécute l’assistant de configuration interactif. L’assistant crée un gateway OpenShell, enregistre les fournisseurs d’inférence, construit l’image du sandbox et crée le sandbox. Utilisez cette commande pour les nouvelles installations et pour recréer un sandbox après des modifications de politique ou de configuration.

$ nemoclaw onboard

La première exécution demande votre clé API NVIDIA et l’enregistre dans ~/.nemoclaw/credentials.json.

L’assistant demande un nom de sandbox. Les noms doivent suivre les règles de sous-domaine RFC 1123 : caractères alphanumériques minuscules et tirets uniquement, et doivent commencer et se terminer par un caractère alphanumérique. Les lettres majuscules sont automatiquement converties en minuscules.

Avant de créer le gateway, l’assistant exécute des vérifications préliminaires. Sur les systèmes avec cgroup v2 (Ubuntu 24.04, DGX Spark, WSL2), il vérifie que Docker est configuré avec "default-cgroupns-mode": "host" et fournit des instructions de correction si le paramètre est manquant.

nemoclaw list

Liste tous les sandboxes enregistrés avec leur modèle, fournisseur et préréglages de politique.

$ nemoclaw list

nemoclaw deploy

Avertissement : La commande nemoclaw deploy est expérimentale et peut ne pas fonctionner comme prévu.

Déploie NemoClaw sur une instance GPU distante via Brev. Le script de déploiement installe Docker, le NVIDIA Container Toolkit si un GPU est présent, et OpenShell sur la VM, puis exécute la configuration nemoclaw et se connecte au sandbox.

$ nemoclaw deploy <instance-name>

nemoclaw <name> connect

Se connecte à un sandbox par nom.

$ nemoclaw my-assistant connect

nemoclaw <name> status

Affiche le statut du sandbox, la santé et la configuration d’inférence.

$ nemoclaw my-assistant status

nemoclaw <name> logs

Affiche les journaux du sandbox. Utilisez --follow pour diffuser la sortie en temps réel.

$ nemoclaw my-assistant logs [--follow]

nemoclaw <name> destroy

Arrête le conteneur NIM et supprime le sandbox. Cela supprime le sandbox du registre.

$ nemoclaw my-assistant destroy

nemoclaw <name> policy-add

Ajoute un préréglage de politique à un sandbox. Les préréglages étendent la politique réseau de base avec des endpoints supplémentaires.

$ nemoclaw my-assistant policy-add

nemoclaw <name> policy-list

Liste les préréglages de politique disponibles et affiche lesquels sont appliqués au sandbox.

$ nemoclaw my-assistant policy-list

openshell term

Ouvre le TUI OpenShell pour surveiller l’activité du sandbox et approuver les requêtes de trafic sortant réseau. Exécutez cette commande sur l’hôte où le sandbox fonctionne.

$ openshell term

Pour une instance Brev distante, connectez-vous en SSH à l’instance et exécutez openshell term depuis celle-ci, ou utilisez un transfert de port vers le gateway.

nemoclaw start

Démarre les services auxiliaires, tels que le pont Telegram et le tunnel cloudflared.

$ nemoclaw start

Nécessite TELEGRAM_BOT_TOKEN pour le pont Telegram.

nemoclaw stop

Arrête tous les services auxiliaires.

$ nemoclaw stop

nemoclaw status

Affiche la liste des sandboxes et le statut des services auxiliaires.

$ nemoclaw status

nemoclaw setup-spark

Configure NemoClaw sur DGX Spark. Cette commande applique les corrections cgroup v2 et Docker requises pour Ubuntu 24.04. Exécutez avec sudo sur l’hôte Spark. Une fois les corrections terminées, le script vous invite à exécuter nemoclaw onboard pour poursuivre la configuration.

$ sudo nemoclaw setup-spark