<!-- 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 .
Use the NemoClaw status, logs, and TUI tools together to inspect sandbox health, trace agent behavior, and diagnose problems.
Check Sandbox Health
Run the status command to view the sandbox state, gateway health, and active inference configuration:
For local Ollama and local vLLM routes,
also probes the host-side health endpoint directly.
This catches a stopped local backend before you retry
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 or 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
on the host to check sandbox state.
Use
for the underlying sandbox details.
View Blueprint and Sandbox Logs
Stream the most recent log output from the blueprint runner and sandbox:
To follow the log output in real time:
console
$ nemoclaw <name> logs --follow
Monitor Network Activity in the TUI
Open the OpenShell terminal UI for a live view of sandbox network activity and egress requests:
For a remote sandbox, SSH to the instance and run
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.
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:
- Run to confirm the active provider and endpoint.
For local Ollama and local vLLM, check the line first.
If it shows , restart the local backend before retrying from inside the sandbox.
- Run
nemoclaw <name> logs --follow
- Verify that the inference endpoint is reachable from the host.
Related Skills
- — Troubleshooting (use the skill) for common issues and resolution steps
nemoclaw-user-manage-policy
nemoclaw-user-manage-policy
nemoclaw-user-configure-inference
nemoclaw-user-configure-inference