ClawMetry for OpenClaw

Clawmetry: OpenClaw 에이전트를 위한 강력한 실시간 모니터링 대시보드

Clawmetry는 OpenClaw 에이전트가 수행하는 모든 작업을 실시간으로 시각화하고 관리할 수 있도록 설계된 오픈 소스 대시보드 솔루션입니다. 에이전트가 서브 에이전트를 생성하고, 토큰을 소비하며, 도구를 호출하는 복잡한 과정을 투명하게 공개하여 개발자의 가시성을 극대화합니다.

What's Clawmetry?

Clawmetry는 한마디로 "OpenClaw를 위한 실시간 관제 센터"입니다. OpenClaw 에이전트를 운영하다 보면 서브 에이전트가 정확히 무엇을 하는지, 비용은 얼마나 발생하는지 파악하기 어려울 때가 많습니다. Clawmetry는 이러한 블랙박스 현상을 해결하기 위해 탄생했습니다.

이 도구는 영원히 무료로 제공되는 오픈 소스 프로젝트이며, 설치가 매우 간편합니다. 에이전트의 사고 과정, 실행 중인 명령, 읽고 있는 파일 등을 Clawmetry를 통해 즉각적으로 확인할 수 있습니다.

Features (주요 기능)

Clawmetry는 OpenClaw 사용자에게 필수적인 다양한 기능을 제공합니다.

1. 실시간 서브 에이전트 모니터링 (THE BIG ONE)

에이전트가 서브 에이전트를 생성할 때, 단순히 "생성 중"이라는 메시지만 보고 기다릴 필요가 없습니다. Clawmetry는 서브 에이전트의 모든 단계를 보여줍니다:

• 읽고 있는 파일 목록
• 실행 중인 명령어
• 호출된 도구(Tools) 및 모델의 사고 과정(Thinking)
• 요약, 서술형 로그 제공

2. 라이브 플로우 그래프 (Live Flow Graph)

채널, 게이트웨이, 모델, 도구 및 노드 간의 연결 상태를 그래프로 시각화합니다. 시스템 내에서 발생하는 모든 상황이 실시간으로 업데이트됩니다.

3. 토큰 및 비용 추적

정확한 데이터 기반의 의사결정을 위해 필수적인 수치를 제공합니다:

• 입력/출력 토큰량 및 캐시 히트(Cache hits)
• 응답 시간 및 호출당 비용 계산
• 모델 및 도구별 비용 분석

4. 시스템 상태 및 세션 히스토리

• 시스템 헬스 체크: 크론 작업(Cron jobs), 서비스 업타임, 디스크 사용량, 활성 서브 에이전트 수를 한눈에 확인합니다.
• 세션 로그: 모든 세션이 타임라인별로 기록됩니다. 과거에 어떤 도구가 호출되었고 비용이 얼마나 들었는지 복기할 수 있습니다.

5. 미션 컨트롤 통합

OpenClaw의 작업 시스템과 연동되어 어떤 에이전트가 어떤 태스크를 수행 중인지 실시간으로 파악합니다.

Use Case (활용 사례)

Clawmetry는 다음과 같은 상황에서 매우 유용합니다.

• 에이전트 디버깅: 서브 에이전트가 예상과 다르게 동작할 때, 실시간 로그와 사고 과정을 추적하여 문제를 즉시 진단합니다.
• 비용 관리: 인보이스를 받기 전, 어떤 세션이나 모델에서 비용이 많이 발생하는지 미리 파악하고 최적화합니다.
• 시스템 최적화: 응답 시간과 토큰 사용량을 분석하여 OpenClaw 에이전트의 효율성을 높입니다.
• 인프라 모니터링: Raspberry Pi부터 AWS까지 다양한 환경에서 실행 중인 에이전트의 상태를 중앙에서 관리합니다.

How to Install (설치 방법)

Clawmetry는 단 30초 만에 설치를 완료할 수 있을 정도로 간편합니다.

One-liner Quick Start

터미널(macOS, Linux) 또는 PowerShell/CMD(Windows)에서 다음 명령어를 실행하면 설치 프로그램이 운영체제를 자동으로 감지하여 설치를 진행합니다.

$ curl -fsSL https://clawmetry.com/install.sh | bash

지원 환경

Clawmetry는 OpenClaw가 실행되는 곳이라면 어디든 지원됩니다:

• OS: macOS, Ubuntu, Debian, Windows WSL 등
• 클라우드 및 호스팅: Digital Ocean, Hostinger, Hetzner, AWS, GCP
• 하드웨어: 노트북, 서버, Raspberry Pi 등

FAQ (자주 묻는 질문)

Q: Clawmetry는 유료인가요? A: 아니요, Clawmetry는 MIT 라이선스 하에 배포되는 오픈 소스 소프트웨어이며 영원히 무료로 사용할 수 있습니다.

Q: 설치 시 특정 운영체제만 지원하나요? A: macOS, Linux, Windows(WSL)를 모두 지원하며, 설치 스크립트가 환경을 자동으로 식별합니다.

Q: 실시간 데이터 반영 속도는 어느 정도인가요? A: 에이전트의 활동이 발생하는 즉시 대시보드에 실시간으로 반영되어 지연 없는 모니터링이 가능합니다.

Q: 데이터를 어디서 확인할 수 있나요? A: 설치 후 제공되는 로컬 또는 서버 주소를 통해 웹 브라우저 기반의 실시간 대시보드에 접속할 수 있습니다.

---

더 자세한 정보는 GitHub 및 PyPI 공식 페이지를 참조하세요. Clawmetry는 vivekchand에 의해 개발되었습니다.