<!-- SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. --> <!-- SPDX-License-Identifier: Apache-2.0 -->

Surveiller l'activité du sandbox NemoClaw et déboguer les problèmes

Prérequis

• Un sandbox NemoClaw en cours d'exécution.
• OpenShell CLI sur votre PATH.

Utilisez ensemble les outils de statut, de logs et TUI de NemoClaw pour inspecter la santé du sandbox, tracer le comportement de l'agent et diagnostiquer les problèmes.

Étape 1 : Vérifier la santé du sandbox

Exécutez la commande status pour afficher l'état du sandbox, la santé de la passerelle et la configuration d'inférence active :

$ nemoclaw <name> status

Pour les routes Ollama local et vLLM local, nemoclaw <name> status sonde également directement le point de terminaison de santé côté hôte. Cela détecte un backend local arrêté avant que vous ne réessayiez inference.local depuis l'intérieur du sandbox.

Les champs clés de la sortie incluent les éléments suivants :

• Détails du sandbox, qui affichent le modèle configuré, le fournisseur, le mode GPU et les présets de politique appliqués.
• Santé de la passerelle et des processus, qui indiquent si NemoClaw peut encore atteindre la passerelle OpenShell et si le processus agent dans le sandbox est en cours d'exécution.
• Santé de l'inférence pour Ollama local et vLLM local, qui affiche healthy ou unreachable avec l'URL locale sondée.
• Statut NIM, qui indique si un conteneur NIM est en cours d'exécution et sain lorsque ce chemin est utilisé.

Exécutez nemoclaw <name> status sur l'hôte pour vérifier l'état du sandbox. Utilisez openshell sandbox list pour les détails du sandbox sous-jacent.

Étape 2 : Afficher les logs du blueprint et du sandbox

Diffusez la sortie de logs la plus récente du runner blueprint et du sandbox :

$ nemoclaw <name> logs

Pour suivre la sortie des logs en temps réel :

$ nemoclaw <name> logs --follow

Étape 3 : Surveiller l'activité réseau dans la TUI

Ouvrez l'interface utilisateur du terminal OpenShell pour une vue en direct de l'activité réseau du sandbox et des demandes de sortie :

$ openshell term

Pour un sandbox distant, SSH vers l'instance et exécutez openshell term là-bas.

La TUI affiche les informations suivantes :

• Connexions réseau actives depuis le sandbox.
• Demandes de sortie bloquées en attente d'approbation de l'opérateur.
• Statut du routage d'inférence.

Consultez Approuver ou refuser les demandes réseau de l'agent (utilisez la skill nemoclaw-user-manage-policy) pour les détails sur la gestion des demandes bloquées.

Étape 4 : Tester l'inférence

Exécutez une demande d'inférence de test pour vérifier que le fournisseur répond :

$ nemoclaw my-assistant connect
$ openclaw agent --agent main --local -m "Test inference" --session-id debug

Si la demande échoue, vérifiez les éléments suivants :

1. Exécutez nemoclaw <name> status pour confirmer le fournisseur actif et le point de terminaison. Pour Ollama local et vLLM local, vérifiez d'abord la ligne Inference. Si elle affiche unreachable, redémarrez le backend local avant de réessayer depuis l'intérieur du sandbox.
2. Exécutez nemoclaw <name> logs --follow pour afficher les messages d'erreur du runner blueprint.
3. Vérifiez que le point de terminaison d'inférence est accessible depuis l'hôte.

Skills connexes

• nemoclaw-user-reference — Dépannage (utilisez la skill nemoclaw-user-reference) pour les problèmes courants et les étapes de résolution
• nemoclaw-user-manage-policy — Approuver ou refuser les demandes réseau de l'agent (utilisez la skill nemoclaw-user-manage-policy) pour le flux d'approbation par l'opérateur
• nemoclaw-user-configure-inference — Basculer les fournisseurs d'inférence (utilisez la skill nemoclaw-user-configure-inference) pour changer le fournisseur actif