Monitor Sandbox Activity and Debug Issues

Use the NemoClaw status, logs, and TUI tools together to inspect sandbox health, trace agent behavior, and diagnose problems.

Prerequisites

• A running NemoClaw sandbox.
• The OpenShell CLI on your PATH.

Check Sandbox Health

Run the status command to view the sandbox state, blueprint run information, and active inference configuration:

$ openclaw nemoclaw status

For machine-readable output, add the --json flag:

$ openclaw nemoclaw status --json

Key fields in the output include the following:

• Sandbox state, which indicates whether the sandbox is running, stopped, or in an error state.
• Blueprint run ID, which is the identifier for the most recent blueprint execution.
• Inference provider, which shows the active provider, model, and endpoint.

If you run openclaw nemoclaw status from inside the sandbox, the command detects the sandbox context and reports it. Host-level sandbox and inference details are not available from within the sandbox. Run openshell sandbox list on the host to check the underlying sandbox state.

View Blueprint and Sandbox Logs

Stream the most recent log output from the blueprint runner and sandbox:

$ openclaw nemoclaw logs

To follow the log output in real time:

$ openclaw nemoclaw logs -f

To display a specific number of log lines:

$ openclaw nemoclaw logs -n 100

To view logs for a specific blueprint run instead of the most recent one:

$ openclaw nemoclaw logs --run-id <id>

Monitor Network Activity in the TUI

Open the OpenShell terminal UI for a live view of sandbox network activity and egress requests:

$ 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 for details on handling blocked requests.

Test Inference

Run a test inference request to verify that the provider is responding:

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

If the request fails, check the following:

1. Run openclaw nemoclaw status to confirm the active provider and endpoint.
2. Run openclaw nemoclaw logs -f to view error messages from the blueprint runner.
3. Verify that the inference endpoint is reachable from the host.

Related Topics

• Troubleshooting for common issues and resolution steps.
• Commands for the full CLI reference.
• Approve or Deny Agent Network Requests for the operator approval flow.
• Switch Inference Providers to change the active provider.