Back to Details

nemoclaw-user-monitor-sandbox

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

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

Monitor Sandbox Activity and Debug Issues

监控沙箱活动并调试问题

Prerequisites

前提条件

  • A running NemoClaw sandbox.
  • The OpenShell CLI on your 
    PATH
    .
Use the NemoClaw status, logs, and TUI tools together to inspect sandbox health, trace agent behavior, and diagnose problems.
  • 运行中的NemoClaw沙箱。
  • 系统
    PATH
    中已配置OpenShell CLI。
结合使用NemoClaw的状态、日志和TUI工具来检查沙箱健康状态、追踪Agent行为并诊断问题。

Check Sandbox Health

检查沙箱健康状态

Run the status command to view the sandbox state, gateway health, and active inference configuration:
console
$ nemoclaw <name> status
For local Ollama and local vLLM routes, 
nemoclaw <name> status
also probes the host-side health endpoint directly. This catches a stopped local backend before you retry 
inference.local
from inside the sandbox.
Key fields in the output include the following:
  • Sandbox details, which show the configured model, provider, GPU mode, and applied policy presets.
  • Gateway and process health, which show whether NemoClaw can still reach the OpenShell gateway and whether the in-sandbox agent process is running.
  • Inference health for local Ollama and local vLLM, which shows 
    healthy
    or 
    unreachable
    together with the probed local URL.
  • NIM status, which shows whether a NIM container is running and healthy when that path is in use.
Run 
nemoclaw <name> status
on the host to check sandbox state. Use 
openshell sandbox list
for the underlying sandbox details.
运行状态命令以查看沙箱状态、网关健康情况以及当前推理配置：
console
$ nemoclaw <name> status
对于本地Ollama和本地vLLM路由，
nemoclaw <name> status
还会直接探测主机端的健康端点。这可以在你从沙箱内部重试
inference.local
之前，发现已停止的本地后端服务。
输出中的关键字段包括：
  • 沙箱详情：显示已配置的模型、服务商、GPU模式以及已应用的策略预设。
  • 网关与进程健康情况：显示NemoClaw是否仍能连接到OpenShell网关，以及沙箱内的Agent进程是否在运行。
  • 本地Ollama和本地vLLM的推理健康状态：显示
    healthy
    或
    unreachable
    ，同时显示探测到的本地URL。
  • NIM状态：当使用该路径时，显示NIM容器是否在运行且状态健康。
在主机上运行
nemoclaw <name> status
以检查沙箱状态。使用
openshell sandbox list
查看底层沙箱详情。

View Blueprint and Sandbox Logs

查看蓝图与沙箱日志

Stream the most recent log output from the blueprint runner and sandbox:
console
$ nemoclaw <name> logs
To follow the log output in real time:
console
$ nemoclaw <name> logs --follow
流式输出蓝图运行器和沙箱的最新日志：
console
$ nemoclaw <name> logs
要实时追踪日志输出：
console
$ nemoclaw <name> logs --follow

Monitor Network Activity in the TUI

在TUI中监控网络活动

Open the OpenShell terminal UI for a live view of sandbox network activity and egress requests:
console
$ openshell term
For a remote sandbox, SSH to the instance and run 
openshell term
there.
The TUI shows the following information:
  • Active network connections from the sandbox.
  • Blocked egress requests awaiting operator approval.
  • Inference routing status.
Refer to Approve or Deny Agent Network Requests (use the 
nemoclaw-user-manage-policy
skill) for details on handling blocked requests.
打开OpenShell终端UI，实时查看沙箱网络活动和出站请求：
console
$ openshell term
对于远程沙箱，先通过SSH连接到实例，再运行
openshell term
。
TUI显示以下信息：
  • 沙箱的活跃网络连接。
  • 等待操作员批准的被拦截出站请求。
  • 推理路由状态。
有关处理被拦截请求的详细信息，请参考《批准或拒绝Agent网络请求》（使用
nemoclaw-user-manage-policy
技能）。

Test Inference

测试推理

Run a test inference request to verify that the provider is responding:
console
$ nemoclaw my-assistant connect
$ openclaw agent --agent main --local -m "Test inference" --session-id debug
If the request fails, check the following:
  1. Run 
    nemoclaw <name> status
    to confirm the active provider and endpoint. For local Ollama and local vLLM, check the 
    Inference
    line first. If it shows 
    unreachable
    , restart the local backend before retrying from inside the sandbox.
  2. Run 
    nemoclaw <name> logs --follow
    to view error messages from the blueprint runner.
  3. Verify that the inference endpoint is reachable from the host.
运行测试推理请求以验证服务商是否响应：
console
$ nemoclaw my-assistant connect
$ openclaw agent --agent main --local -m "Test inference" --session-id debug
如果请求失败，请检查以下内容：
  1. 运行
    nemoclaw <name> status
    确认当前服务商和端点。对于本地Ollama和本地vLLM，先查看
    Inference
    行。如果显示
    unreachable
    ，请先重启本地后端服务，再从沙箱内部重试。
  2. 运行
    nemoclaw <name> logs --follow
    查看蓝图运行器的错误信息。
  3. 验证推理端点是否可从主机访问。

Related Skills

相关技能

  • nemoclaw-user-reference
    — Troubleshooting (use the 
    nemoclaw-user-reference
    skill) for common issues and resolution steps
  • nemoclaw-user-manage-policy
    — Approve or Deny Agent Network Requests (use the 
    nemoclaw-user-manage-policy
    skill) for the operator approval flow
  • nemoclaw-user-configure-inference
    — Switch Inference Providers (use the 
    nemoclaw-user-configure-inference
    skill) to change the active provider
  • nemoclaw-user-reference
    — 故障排查（使用
    nemoclaw-user-reference
    技能），包含常见问题及解决步骤
  • nemoclaw-user-manage-policy
    — 批准或拒绝Agent网络请求（使用
    nemoclaw-user-manage-policy
    技能），介绍操作员批准流程
  • nemoclaw-user-configure-inference
    — 切换推理服务商（使用
    nemoclaw-user-configure-inference
    技能），用于更改当前服务商