vivekchand/clawmetry

See your agent think. Zero-config observability & governance for 30 AI agent runtimes: Claude Code, OpenAI Codex, Hermes, OpenClaw & 26 more. Live token costs, sessions, tool calls, crons.

ClawMetry 기능

ClawMetry는 AI 코딩 에이전트가 이미 작성하는 세션 로그를 감시하는 로컬 대시보드입니다. 읽기 전용 파일을 읽어 모든 도구 호출, 토큰 사용량 및 비용의 타임라인을 구축하여 에이전트가 진행 중인지 아니면 영원히 루프에 빠져 있는지 한눈에 확인할 수 있습니다.

즉시 사용 가능 – Python 패키지를 설치하고 clawmetry를 실행하기만 하면 됩니다. 프로그램은 http://localhost:8900에서 웹 UI를 시작하고 컴퓨터에서 지원되는 33개 에이전트 런타임(예: Claude Code, OpenAI Codex, Cursor, OpenClaw, NVIDIA NemoClaw 등)을 자동으로 검색합니다. 코드 변경, SDK 가져오기 또는 계측이 필요 없습니다.

핵심 기능

기능	표시 내용	획득 방법
세션 재생	타임스탬프, 도구 호출 및 모델 응답이 포함된 턴바이턴 기록.	런타임의 세션 파일을 읽습니다(읽기 전용).
비용 및 토큰 분석	에이전트별, 모델별 일일, 주간, 월간 지출. 이상 플래그 포함.	각 런타임이 노출하는 토큰 수 및 가격 데이터를 구문 분석합니다.
흐름 다이어그램	메시지가 user → gateway → model → tools로 이동하는 것을 보여주는 라이브 그래프.	동일한 세션 로그에서 구축됩니다. 추가 네트워크 트래픽 없음.
컨텍스트 창 사용량	각 공급자의 컨텍스트 창 비율, 압축 이벤트, 오버플로 경고.	공급자별 창 크기(Anthropic, OpenAI, Google 등)의 내장 테이블을 사용합니다.
메모리/스킬 로딩	각 에이전트가 실제로 로드한 파일 및 "스킬".	런타임 메타데이터에서 추출됩니다.
상태 및 경고	디스크/메모리 사용량, 속도 제한 히트, 오류 급증, 예산 상한. Slack, Discord, PagerDuty, Telegram, Email로 푸시 가능.	로컬에서 모니터링됩니다. 선택적 아웃바운드 웹훅.
승인	위험한 도구 호출(예: sudo, 비밀 노출)을 일시 중지하고 휴대폰에서 승인/거부합니다.	선택적 시행 프록시가 필요합니다. 기본적으로 꺼져 있습니다.
SDK 추적	LangChain, Pydantic-AI 등으로 에이전트를 구축하는 경우 ClawMetry는 LLM 호출을 코드에 귀속시킬 수 있습니다.	활성화할 수 있는 인터셉터(`CLAWMETRY_INTERCEPT=1`)를 통해.

사용 방법

설치 – pip install clawmetry (Python 3.8+).
실행 – clawmetry는 데몬을 시작하고 UI를 엽니다.
탐색 – 헤더를 사용하여 런타임 간에 전환할 수 있습니다. 각 탭에는 위에 나열된 보기가 표시됩니다.
(선택 사항) 연결 – clawmetry connect는 원격 보기를 위해 암호화된 스냅샷을 클라우드에 업로드합니다. 그렇지 않으면 모든 것이 컴퓨터에 유지됩니다.

아직 에이전트가 없는 경우 clawmetry --sample은 UI를 탐색할 수 있도록 3개의 합성 세션을 로드합니다.

가격 및 라이선스

무료 티어 – OpenClaw, NVIDIA NemoClaw, Goose 및 Qwen Code와 함께 로컬에서 작동합니다. 데이터가 상자 밖으로 나가지 않습니다.
Starter ($9 / 노드 / 월) – 다른 28개 런타임과 스냅샷의 클라우드 동기화가 추가됩니다.
Pro ($19 / 노드 / 월) – 승인, 정책 엔진, 이상 감지, 비용 최적화, OpenTelemetry 내보내기, 변조 방지 감사 로그 등이 추가됩니다.

모든 티어는 MIT 라이선스 소스입니다. 유료 기능은 폐쇄 소스 컴패니언(clawmetry-pro)을 통해 제공됩니다.

데이터 개인 정보 보호 및 네트워크 트래픽

기본적으로 세션 콘텐츠는 어디에도 전송되지 않습니다.
유일한 아웃바운드 호출은 익명 설치 ping, PyPI 버전 확인 및 배너를 위한 일회성 공용 IP 조회입니다.
둘 다 옵트아웃이 가능하며 docs/EGRESS.md에 문서화되어 있습니다.
clawmetry connect를 명시적으로 실행하면 스냅샷이 종단 간 암호화됩니다. 복호화는 무결성이 검증된 정적 JS 파일을 사용하여 브라우저에서 수행됩니다.

성능 영향

계측 지점	추가 대기 시간(일반적)	기본 상태
세션 파일 추적	0ms(별도 프로세스)	켜짐
HTTP 인터셉터	LLM 호출당 +0.44ms	꺼짐
사전 도구 후크 게이트	게이트된 호출당 +44ms	꺼짐
시행 프록시	LLM 호출당 +9.7ms	꺼짐

데몬 자체는 CPU 코어의 약 **12%**와 디스크에서 10만 이벤트당 약 70KB를 사용합니다. 벤치마크는 benchmarks/overhead.py에 제공됩니다.

누가 혜택을 받을 수 있나요?

여러 코딩 에이전트를 실행하는 개발자(예: CI 서버 또는 개인 워크스테이션)가 막힌 루프, 비용 초과 또는 위험한 도구 사용을 발견하기 위한 단일 창이 필요한 경우.
예산 상한을 적용하거나 위험한 작업에 수동 승인을 요구하려는 팀 리더.
코드를 수정하지 않고 다양한 에이전트 런타임의 동작을 비교하는 연구자.

제한 사항 및 주의 사항

대시보드는 각 런타임이 실제로 기록하는 데이터만 표시할 수 있습니다. 일부 런타임은 비용 정보를 노출하지 않으며 이는 호환성 매트릭스에 반영됩니다.
컨텍스트 창 비율은 공급자별 창 크기에 대해 계산됩니다. 런타임이 테이블 항목보다 큰 창을 가진 모델을 사용하는 경우 백분율이 부풀려 보일 수 있습니다.
승인 및 정책 시행에는 선택적 프록시 구성 요소가 필요하며 기본적으로 꺼져 있습니다.
무료 티어는 4개의 런타임만 지원합니다. 나머지는 유료 플랜 또는 clawmetry-pro 컴패니언이 필요합니다.

빠른 시작 스니펫

pip install clawmetry               # 패키지 설치
clawmetry                           # 데몬 시작 및 UI 열기
# 에이전트가 아직 없는 경우:
clawmetry --sample                  # 데모용 합성 세션 로드

자세히 알아보기

문서 – docs/에는 호환성, 컨텍스트 폭주, 오버헤드, 승인, OpenTelemetry 내보내기 및 자체 에이전트 런타임을 추가하는 방법에 대한 자세한 가이드가 포함되어 있습니다.
스크린샷 – README에는 비용 분석, 흐름 다이어그램, 경고 및 품질 등급을 보여주는 여러 스크린샷이 포함되어 있습니다.
가격 – 전체 가격표는 https://clawmetry.com/pricing에 있습니다.

ClawMetry는 본질적으로 AI 코딩 에이전트를 위한 모니터링 및 관찰 가능성 레이어로, 에이전트 자체를 변경하지 않고도 가시성, 비용 인식 및 안전 제어 기능을 제공합니다.