ClawMetry for NVIDIA NemoClaw

ClawMetry란?

ClawMetry for NVIDIA NemoClaw는 NemoClaw 샌드박스에 실시간 구조화 관측성을 제공합니다. NemoClaw의 터미널 UI에만 의존하는 대신 도구 호출, 토큰 사용량, 메모리 파일 변경, 스케줄링(크론) 작업 상태 등의 활동을 수집하고 영속화합니다.

목표는 NemoClaw 플리트 전체에서 런타임에 에이전트가 무엇을 하는지 이해하는 데 도움을 주며, 웹 대시보드를 통해 실시간으로 확인할 수 있습니다. ClawMetry는 호스트에서 종단간 암호화된 클라우드 동기화도 수행하여 텔레메트리를 암호화된 스트림으로 전송합니다.

주요 기능

호스트 기반 원 명령 배포로 플리트 커버리지: NemoClaw가 실행 중인 호스트에서 단일 설치 명령을 실행하면 모든 샌드박스 인스턴스에 네트워크 정책 프리셋을 적용하고 동기화를 시작합니다.
클라우드로의 종단간 암호화 텔레메트리: 호스트에서 암호화 키를 생성합니다. ClawMetry Cloud에 도달하는 것은 암호화된 텔레메트리 스트림만이며, 프롬프트/응답 및 API 키는 평문으로 전송되지 않습니다.
호출별 상세를 포함한 실시간 에이전트 활동: 웹 대시보드에서 도구 호출, 토큰 소비, 서브 에이전트 생성 활동을 실시간으로 확인합니다.
주요 파일 메모리 모니터링: SOUL.md와 MEMORY.md의 예상치 못한 변경을 감시하여 메모리 손상을 조기에 탐지합니다.
토큰 비용 추적: 호출별 토큰 비용, 일일 총계, 월간 예측을 추적합니다.
크론 작업 모니터링: 로그를 읽거나 인스턴스에 SSH할 필요 없이 마지막 실행, 다음 실행, 실패 내역을 확인합니다.
실시간 세션 웹 액세스: 브라우저에서 app.clawmetry.com에 접속해 실시간 에이전트 세션과 상태를 모니터링합니다(모바일은 “coming soon”).
OpenShell 가드레일과 함께 실행되도록 설계: ClawMetry는 샌드박스 정책을 우회하지 않고 에이전트 활동을 관측하도록 위치합니다.

ClawMetry 사용 방법

NemoClaw 호스트에 설치: NemoClaw가 실행 중인 호스트 머신에서 원라이너 설치기를 실행합니다: curl -fsSL https://clawmetry.com/install.sh | bash.
ClawMetry가 정책 적용 및 동기화 시작: 설치기가 모든 샌드박스에 네트워크 정책 프리셋을 자동 적용하고 암호화된 클라우드 동기화를 시작합니다.
대시보드 열어 활동 관측: app.clawmetry.com을 사용해 실시간 세션, 호출별 토큰 소비, 메모리 파일 차이, 크론 작업 상태를 확인합니다.

이미 장기 실행 PTY에서 NemoClaw 에이전트가 실행 중이라면 “Help me install in a long running PTY…”와 같은 프롬프트로 설치 요청이 가능합니다. 에이전트가 설치기를 다운로드하고 ClawMetry를 설정하며 노드를 연결하고 자동으로 동기화를 시작합니다.

사용 사례

플리트 전체 에이전트 동작 디버깅: 단일 클라우드 대시보드에서 여러 NemoClaw 샌드박스의 도구 호출, 토큰 소비, 서브 에이전트 생성 이벤트를 모니터링합니다.
LLM 사용 예산 가시성: 호출별 토큰 비용을 추적하고 일일 총계 및 월간 예측으로 집계하여 비용이 누적되는 곳을 파악합니다.
손상된 에이전트 메모리 조기 탐지: SOUL.md와 MEMORY.md 변경을 지속적으로 감시하여 다운스트림 문제를 일으키기 전에 예상치 못한 업데이트를 발견합니다.
스케줄링 작업 운영 모니터링: 각 노드 로그를 확인하는 대신 대시보드에서 크론 실행 결과(마지막 실행, 다음 실행, 실패)를 추적합니다.
보안 가드레일 유지 모니터링: OpenShell 보안 레이어와 함께 작동하며 샌드박스 정책을 우회하지 않고 에이전트 활동을 관측합니다.

자주 묻는 질문

ClawMetry가 OpenShell 가드레일과 호환되나요?

네. 문서에 따르면 ClawMetry 관측성은 NemoClaw의 보안 레이어와 함께 실행되며 샌드박스 정책을 우회하지 않고 작동하도록 설계되었습니다.

클라우드로 전송 시 데이터는 어떻게 보호되나요?

ClawMetry는 호스트에서 암호화 키를 생성하고 ClawMetry Cloud로 암호화된 텔레메트리 스트림을 전송합니다. 프롬프트, 응답, API 키는 평문으로 머신을 떠나지 않습니다.

대시보드에서 무엇을 볼 수 있나요?

app.clawmetry.com에서 실시간 에이전트 세션, 호출별 토큰 소비, SOUL.md와 MEMORY.md의 메모리 파일 차이, 크론 작업 상태를 확인할 수 있습니다.

NemoClaw 인스턴스마다 별도 설정이 필요하나요?

설명된 워크플로는 호스트 기반입니다. NemoClaw 호스트에서 설치기를 실행하면 모든 NemoClaw 인스턴스를 한 번에 커버합니다.

이미 장기 실행 NemoClaw 에이전트가 있다면?

기존 에이전트에게 장기 실행 PTY에 ClawMetry를 설치하도록 요청할 수 있습니다. 설치기를 다운로드하고 ClawMetry를 설정하며 노드를 연결하고 동기화를 시작합니다.

대안

NemoClaw의 터미널/UI(TUI)에만 의존: 관측을 로컬 및 일시적(터미널 전용)으로 유지하지만, ClawMetry에서 설명된 구조화된 영속 히스토리, 클라우드 대시보드 액세스, 플릿 전체 뷰가 부족합니다.
에이전트 도구 호출 주변에 맞춤 로깅/텔레메트리 구축: 에이전트 런타임을 도구 호출, 토큰, 이벤트를 기록하도록 구현할 수 있지만, 영속성, 대시보드, 암호화 전송을 직접 구현해야 합니다.
범용 인프라 관측성(메트릭/로그/APM): 이 카테고리의 도구는 호스트/서비스 메트릭과 로그에 중점을 둡니다. 메모리 파일 diff(SOUL.md, MEMORY.md)나 에이전트별 도구 호출 토큰 계정과 같은 NemoClaw 전용 가시성을 기본 제공하지 않을 수 있습니다.