openclaw-cost-tracker-mcp

Claude 또는 MCP를 지원하는 모든 에이전트에서 쿼리할 수 있는 OpenClaw용 토큰 비용 텔레메트리. 에이전트별 + 공급자별 비용 귀속, 비용 급증에 대한 이상 징후 탐지, 모델 라우팅 권장 사항, 30일 예측을 제공합니다. silentwatch-mcp 및 openclaw-health-mcp와 함께 사용하는 보조 도구입니다.

기능

프로덕션 AI 배포는 여러 공급자, 수십 개의 에이전트, 수백 번의 스킬 호출에 걸쳐 토큰 비용을 발생시킵니다. 월말에 청구서가 도착하면 "우리 돈이 어디로 갔지?"라는 질문에 대한 답은 10만 줄의 로그 속에 묻혀버립니다. 이 MCP 서버는 해당 데이터를 실시간으로 표면화하여 Claude 내부에서 평이한 영어로 쿼리할 수 있게 합니다:

> claude: where did our LLM spend go this week?
[MCP tools: cost_overview + top_cost_drivers]

Total spend last 7 days: $42.18
By provider:
  Anthropic    $30.40 (72%) — claude-sonnet-4 dominates
  OpenAI       $9.20  (22%) — chat-bot agent
  Gemini       $1.86  (4%)  — cron-summarizer (cheap-route working)
  Ollama       $0.00  (local, free)

Top 3 cost drivers:
  data-extraction-agent      $28.50 (68%)
  chat-bot                   $9.20  (22%)
  cron-summarizer            $1.86  (4%)

1 anomaly flagged — see find_cost_anomalies for details.

> claude: any cheaper-routing opportunities?
[MCP tool: model_routing_recommendations]

Recommendation: data-extraction-agent currently runs claude-sonnet-4
with avg 400-token completions — extraction-style work that
gemini-2.5-flash usually handles at ~95% quality for ~5% the cost.
Estimated savings: $27.10/30d if migrated. Test on a 10% slice first.

openclaw-cost-tracker-mcp를 사용하는 이유

기존 도구(공급자 청구 대시보드, 일반적인 FinOps 도구, 사용자 지정 스크립트)가 수행하지 못하는 세 가지 기능:

1. 공급자별 합계가 아닌 에이전트별 귀속. 공급자 대시보드는 "Anthropic에 $X 지출"이라고 표시하지만, 6개의 에이전트 중 어느 것이 그 비용의 78%를 유발했는지는 알려주지 않습니다. 비용 추적기는 OpenClaw의 요청별 비용 로그 JSONL을 읽고 agent_id를 유지한 채 집계합니다.

2. 에이전트별 비용 급증 이상 징후 탐지. 채팅에 12만 토큰을 한 번 붙여넣는 것은 일반적인 트래픽의 일주일치 비용보다 더 많이 들 수 있습니다. 기본값인 에이전트별 중앙값의 3배 임계값은 월말 청구서에 나타나기 전에 이를 플래그 지정합니다.

3. 실제 사용량에 기반한 라우팅 권장 사항. 일반적인 "더 저렴한 모델 사용" 조언은 쓸모가 없습니다. 이 서버는 볼륨 + 완료 길이 패턴이 더 저렴한 공급자로도 동일한 결과를 얻을 수 있음을 시사하는 특정 에이전트를 식별하며, 구체적인 30일 절감액 추정치를 제공합니다.

실제 비용이 발생하는 프로덕션 환경에서 OpenClaw를 운영하는 프로덕션 AI 운영자를 위해 구축되었습니다.

도구 인터페이스

리소스:

• cost://overview — 7일 스냅샷

• cost://forecast — 30일 예측

• cost://anomalies — 최근 플래그 지정된 이상 징후

프롬프트:

• diagnose-cost-spike — 최근 급증의 근본 원인 파악 + 시정 조치

• weekly-cost-digest — 200단어 분량의 주간 비용 요약

퀵스타트

설치

pip install openclaw-cost-tracker-mcp

Claude Desktop 설정

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)에 추가하세요:

{
  "mcpServers": {
    "openclaw-cost": {
      "command": "python",
      "args": ["-m", "openclaw_cost_tracker_mcp"],
      "env": {
        "OPENCLAW_COST_BACKEND": "mock"
      }
    }
  }
}

백엔드

JSONL 로그 형식

각 줄은 하나의 JSON 레코드입니다:

{"request_id":"req-abc123","timestamp":"2026-05-04T12:34:56Z","provider":"anthropic","model":"claude-sonnet-4","agent_id":"data-extraction-agent","skill_id":"extract-structured-data","prompt_tokens":8500,"completion_tokens":600,"total_tokens":9100,"cost_usd":0.0345,"duration_ms":4823}

OpenClaw 배포가 이 형식을 내보내지 않는 경우, 작은 로깅 심(shim)으로 공급자 호출을 래핑하세요. 샘플 심은 examples/에 있습니다.

로드맵

스택에 맞게 조정이 필요하신가요?

AI 배포에 OpenClaw의 비용 로그 형식을 사용하지 않거나(다른 에이전트 하네스, 사용자 지정 로깅, AWS Bedrock 미터링, 공급업체 청구 API 등), 동일한 귀속 + 이상 징후 + 라우팅 가시성을 원하신다면 맞춤형 MCP 빌드 참여가 가능합니다.

참여 방법:

1. temur@pixelette.tech로 제목을 Custom MCP Build inquiry로 하여 이메일 발송

2. 포함 내용: 스택에 대한 1단락 설명 + 고려 중인 티어

3. 2영업일 이내에 30분 발견 통화 슬롯으로 회신

이 서버는 프로덕션 AI 인프라 MCP 제품군의 일부이며, silentwatch-mcp(크론 자동 실패 탐지) 및 openclaw-health-mcp(배포 상태)와 함께 사용됩니다. 전체 운영 가시성을 위해 세 가지 모두 설치하세요.

프로덕션 AI 감사

프로덕션 AI를 운영 중이며 외부 전문가가 준비 상태를 평가하고, 이미 존재하는 실패 패턴(비용 초과가 가장 흔한 패턴 중 하나)을 찾아 시정 조치 계획을 작성하기를 원하신다면:

동일한 이메일 채널: temur@pixelette.tech, 제목 AI audit inquiry.

기여

PR을 환영합니다. 백엔드는 플러그인 가능합니다. 계약 내용은 src/openclaw_cost_tracker_mcp/backends/를 참조하세요.

새 백엔드를 추가하려면:

1. backends/<your_backend>.py에서 CostBackend를 서브클래싱합니다.

2. get_entries()를 구현합니다.

3. backends/__init__.py에 등록합니다.

4. tests/test_backend_<your_backend>.py에 테스트를 추가합니다.

버그 보고서 + 기능 요청: GitHub 이슈를 여세요.

라이선스

MIT — LICENSE를 참조하세요.

관련 자료

• silentwatch-mcp — 크론 자동 실패 탐지

• openclaw-health-mcp — 배포 상태

• AI Production Discipline Framework — Notion 템플릿, $29 — 이 MCP 도구들이 구현하는 방법론 (비용 초과는 카탈로그의 P3.x 패턴입니다)

• SPEC.md — 전체 서버 설계

제작자: Temur Khan — 프로덕션 AI 시스템 독립 실무자. 연락처: temur@pixelette.tech