샌드박스 모니터링 및 디버그

NemoClaw의 status, logs, TUI 도구를 함께 사용하여 샌드박스 상태를 점검하고, 에이전트 동작을 추적하며, 문제를 진단합니다.

사전 요구 사항

• 실행 중인 NemoClaw 샌드박스.
• OpenShell CLI가 PATH에 있을 것.

샌드박스 상태 확인

status 명령어로 샌드박스 상태, 블루프린트 실행 정보, 현재 추론 설정을 확인합니다:

$ openclaw nemoclaw status

기계 판독 가능한 출력을 원하면 --json 플래그를 추가합니다:

$ openclaw nemoclaw status --json

출력의 주요 필드:

• 샌드박스 상태: 실행 중, 중지됨, 또는 오류 상태.
• 블루프린트 실행 ID: 가장 최근 블루프린트 실행의 식별자.
• 추론 프로바이더: 활성 프로바이더, 모델, 엔드포인트.

샌드박스 안에서 openclaw nemoclaw status를 실행하면 샌드박스 컨텍스트를 감지하여 보고합니다. 호스트 측 샌드박스·추론 정보는 샌드박스 안에서 확인할 수 없습니다. 호스트에서 openshell sandbox list를 실행하세요.

블루프린트 및 샌드박스 로그 확인

블루프린트 러너와 샌드박스의 최신 로그를 스트리밍합니다:

$ openclaw nemoclaw logs

실시간 로그 추적:

$ openclaw nemoclaw logs -f

표시할 줄 수 지정:

$ openclaw nemoclaw logs -n 100

최신이 아닌 특정 블루프린트 실행의 로그를 확인:

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

TUI에서 네트워크 활동 모니터링

OpenShell 터미널 UI를 열어 샌드박스의 네트워크 활동과 아웃바운드 요청을 실시간으로 확인합니다:

$ openshell term

원격 샌드박스라면 인스턴스에 SSH 접속 후 openshell term을 실행합니다.

TUI에 표시되는 정보:

• 샌드박스의 활성 네트워크 연결.
• 운영자 승인 대기 중인 차단된 아웃바운드 요청.
• 추론 라우팅 상태.

차단된 요청 처리에 대한 자세한 내용은 네트워크 요청 승인/거부를 참고하세요.

추론 테스트

테스트 추론 요청을 실행하여 프로바이더가 응답하는지 확인합니다:

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

요청이 실패하면 다음을 확인하세요:

1. openclaw nemoclaw status로 활성 프로바이더와 엔드포인트 확인.
2. openclaw nemoclaw logs -f로 블루프린트 러너의 오류 메시지 확인.
3. 추론 엔드포인트가 호스트에서 접근 가능한지 확인.

관련 주제

• 문제 해결에서 일반적인 문제와 해결 방법 확인.
• 명령어 레퍼런스에서 전체 CLI 레퍼런스 확인.
• 네트워크 요청 승인/거부에서 운영자 승인 흐름 확인.
• 추론 프로바이더 전환으로 활성 프로바이더 변경.