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.