Monitorar Atividade do Sandbox e Depurar Problemas

Use as ferramentas de status, logs e TUI do NemoClaw em conjunto para inspecionar a saúde do sandbox, rastrear o comportamento do agente e diagnosticar problemas.

Pré-requisitos

• Um sandbox NemoClaw em execução.
• O CLI do OpenShell no seu PATH.

Verificar a Saúde do Sandbox

Execute o comando de status para visualizar o estado do sandbox, informações de execução do blueprint e a configuração de inferência ativa:

$ openclaw nemoclaw status

Para saída legível por máquina, adicione a flag --json:

$ openclaw nemoclaw status --json

Os campos principais na saída incluem os seguintes:

• Estado do sandbox, que indica se o sandbox está em execução, parado ou em estado de erro.
• ID de execução do blueprint, que é o identificador da execução mais recente do blueprint.
• Provedor de inferência, que mostra o provedor ativo, o modelo e o endpoint.

Se você executar openclaw nemoclaw status de dentro do sandbox, o comando detecta o contexto do sandbox e o reporta. Os detalhes de sandbox e inferência no nível do host não estão disponíveis de dentro do sandbox. Execute openshell sandbox list no host para verificar o estado subjacente do sandbox.

Visualizar Logs do Blueprint e do Sandbox

Transmita a saída de log mais recente do executor do blueprint e do sandbox:

$ openclaw nemoclaw logs

Para acompanhar a saída de log em tempo real:

$ openclaw nemoclaw logs -f

Para exibir um número específico de linhas de log:

$ openclaw nemoclaw logs -n 100

Para visualizar logs de uma execução de blueprint específica em vez da mais recente:

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

Monitorar Atividade de Rede no TUI

Abra o TUI do OpenShell para uma visualização ao vivo da atividade de rede do sandbox e requisições de saída:

$ openshell term

Para um sandbox remoto, conecte via SSH à instância e execute openshell term lá.

O TUI mostra as seguintes informações:

• Conexões de rede ativas do sandbox.
• Requisições de saída bloqueadas aguardando aprovação do operador.
• Status do roteamento de inferência.

Consulte Aprovar ou Negar Requisições de Rede do Agente para detalhes sobre como lidar com requisições bloqueadas.

Testar a Inferência

Execute uma requisição de inferência de teste para verificar se o provedor está respondendo:

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

Se a requisição falhar, verifique o seguinte:

1. Execute openclaw nemoclaw status para confirmar o provedor e endpoint ativos.
2. Execute openclaw nemoclaw logs -f para visualizar mensagens de erro do executor do blueprint.
3. Verifique se o endpoint de inferência está acessível a partir do host.

Tópicos Relacionados

• Resolução de Problemas para problemas comuns e passos de resolução.
• Comandos para a referência completa do CLI.
• Aprovar ou Negar Requisições de Rede do Agente para o fluxo de aprovação do operador.
• Trocar Provedores de Inferência para alterar o provedor ativo.