ClawRouter 소개
ClawRouter는 BlockRunAI에서 개발한 OpenClaw 생태계를 위한 에이전트 네이티브(Agent-native) 대형 언어 모델(LLM) 라우터입니다. 현대의 AI 개발 환경에서는 다양한 제공업체의 LLM을 목적에 맞게 혼합하여 사용하는 것이 필수적이 되었습니다. 하지만 각 제공업체마다 발급받아야 하는 API 키를 관리하고, 모델별로 상이한 가격 정책에 맞춰 최적의 비용 효율을 달성하는 것은 매우 번거롭고 복잡한 작업입니다. ClawRouter는 이러한 문제를 해결하기 위해 등장했으며, 여러 LLM을 사용할 때 발생하는 비용과 관리의 복잡성을 혁신적으로 낮춰주는 강력한 도구입니다.
ClawRouter의 가장 큰 특징은 단일 지갑을 통해 41개 이상의 다양한 모델을 API 키 없이 사용할 수 있다는 점입니다. 15차원 스코어링 시스템을 활용하여 요청을 분석하고, 1밀리초(ms) 미만의 지연 시간으로 가장 적합하고 저렴한 모델로 요청을 라우팅합니다. 특히, 외부 API 호출 없이 100% 클라이언트 측에서 로컬 라우팅을 수행하므로 자율 에이전트 환경에서 최적화된 성능을 발휘합니다. 이를 통해 개발자는 번거로운 설정 없이도 최고 품질의 모델을 저렴한 비용으로 자유롭게 활용할 수 있습니다.
또한, 기존의 중앙 집중식 크레딧 결제 방식과 달리 Base 네트워크(L2) 기반의 USDC를 이용한 x402 프로토콜을 채택하여 비수탁형(Non-custodial) 종량제 결제를 구현했습니다. 사용자는 가입 절차나 구독 없이 자신이 보유한 지갑의 잔액만큼만 비용을 지불하게 됩니다. 이러한 구조 덕분에 API 키 유출 위험이나 과도한 요금 청구에 대한 걱정 없이 안전하게 AI 모델 인프라를 구축할 수 있으며, 여러 모델을 혼합하여 사용할 경우 Claude Opus 단일 모델 사용 대비 약 92%의 비용 절감 효과를 기대할 수 있습니다.
OpenRouter 및 LiteLLM과의 비교
ClawRouter는 기존에 널리 사용되던 라우팅 서비스인 OpenRouter나 LiteLLM과 비교할 때 인증 및 결제 방식, 그리고 라우팅 처리 구조에서 뚜렷한 차별점을 가집니다.
-
설정 및 인증 방식: 기존 서비스들은 사용자가 직접 계정을 생성하고 API 키(공유 비밀키)를 발급받아 시스템에 등록해야 했습니다. 반면, ClawRouter는 에이전트가 자체적으로 지갑을 생성하고, 암호화된 지갑 서명을 통해 인증을 수행합니다. 즉, 별도의 회원가입이나 API 키 관리가 전혀 필요하지 않습니다.
-
결제 시스템: OpenRouter 등은 플랫폼에 선불로 잔고를 충전하는 수탁형(Custodial) 방식입니다. 반면, ClawRouter는 x402 프로토콜을 통해 요청 건당 USDC로 즉시 결제하는 비수탁형(Non-custodial) 방식을 사용하므로, 자금의 통제권을 온전히 사용자가 가지게 됩니다.
-
라우팅 및 비용: 기존 서비스의 라우팅 로직은 비공개(Closed)된 서버 측에서 처리되며 API 키마다 할당된 속도 제한(Rate limits)을 받습니다. ClawRouter는 오픈소스 기반으로 클라이언트 측에서 로컬 라우팅을 수행하며, 사용자의 지갑 잔고가 허락하는 한 별도의 속도 제한이 없습니다. 비용 면에서도 Opus 수준의 모델을 사용할 때 기존 서비스가 100만 토큰당 약 $25를 청구하는 반면, ClawRouter는 스마트 라우팅을 통해 100만 토큰당 약 $2.05의 혼합 평균 비용을 달성하여 압도적인 경제성을 자랑합니다.
더 상세한 OpenRouter/LiteLLM과의 비교는 GitHub에 공개된 비교 문서를 참고해주세요.
ClawRouter의 주요 특징
15차원의 로컬 라우팅 시스템
ClawRouter의 핵심 기술은 요청(Request)을 받아 가장 적합한 모델을 찾아내는 15차원 가중치 기반 스코어링 시스템입니다. 사용자의 프롬프트가 입력되면 라우터는 외부 API를 호출하지 않고 로컬 환경에서 1ms 미만의 지연 시간으로 요청의 복잡도를 분석합니다. 이후 요청을 '단순(SIMPLE)', '중간(MEDIUM)', '복잡(COMPLEX)', '추론(REASONING)' 등의 티어로 분류하고, 설정된 라우팅 프로필에 맞춰 해당 작업을 수행할 수 있는 가장 저렴한 모델을 선택하여 응답을 반환합니다.
4가지 맞춤형 라우팅 프로필
사용자의 예산과 요구 품질에 따라 동적으로 라우팅 전략을 선택할 수 있도록 네 가지 기본 프로필을 제공합니다. 명령어 형태(/model <profile>)로 쉽게 전환할 수 있습니다.
- auto (기본값): 균형 잡힌 전략으로, 품질을 유지하면서 74%~100%의 비용 절감을 목표로 하는 범용 프로필입니다.
- eco: 가장 저렴한 모델을 최우선으로 선택하여 95%~100%의 비용을 절감하는 전략으로, 단순 작업에 적합합니다.
- premium: 비용 절감(0%)보다는 최고의 품질이 요구되는 미션 크리티컬한 작업에 사용되는 프로필입니다.
- free: 비용이 전혀 발생하지 않는 무료 티어 모델(예:
gpt-oss-120b)만을 사용하여 비용을 100% 절감합니다. 지갑 잔고가 소진되었을 때 자동 폴백(Fallback)으로도 작동합니다.
또한 /model grok, /model br-sonnet, /model gpt5, /model o3와 같은 단축 명령어를 통해 특정 모델 계열로 빠르게 고정할 수도 있습니다.
x402 프로토콜 기반의 결제 및 인증
ClawRouter는 별도의 계정 없이 결제 자체가 인증(Payment IS authentication)이 되는 구조입니다. 내부적으로 Base 네트워크(Ethereum L2) 기반의 USDC를 사용합니다.
- 시스템 시작 시
~/.openclaw/blockrun/wallet.key에 Base L2 네트워크용 지갑이 자동 생성됩니다. - 사용자가 브릿지나 중앙화 거래소(CEX)를 통해 해당 지갑으로 USDC를 전송하여 충전합니다. (단돈 $5만으로도 수천 번의 요청 처리가 가능합니다.)
- AI 요청이 발생하면 402 상태 코드와 함께 예상 가격(예: $0.003)이 제시되고, 지갑이 USDC 서명을 완료하면 재시도를 통해 모델 응답을 받아옵니다.
사용하지 않은 USDC는 지갑에 그대로 안전하게 보관되며, 서명 전 402 헤더를 통해 가격을 미리 확인할 수 있어 투명합니다. x402 프로토콜과 관련해서는 아래 링크를 참고해주세요:
ClawRouter의 지원 모델 및 가격 정책
ClawRouter는 OpenAI, Anthropic, Google, DeepSeek, xAI, Moonshot, MiniMax 등 7개 제공업체의 41개 이상 모델을 단일 지갑으로 지원합니다.
| Model | Input $/M | Output $/M | Context | Reasoning |
|---|---|---|---|---|
| OpenAI | ||||
| gpt-5.2 | $1.75 | $14.00 | 400K | * |
| gpt-4o | $2.50 | $10.00 | 128K | |
| gpt-4o-mini | $0.15 | $0.60 | 128K | |
| gpt-oss-120b | FREE | FREE | 128K | |
| o1 | $15.00 | $60.00 | 200K | * |
| o1-mini | $1.10 | $4.40 | 128K | * |
| o3 | $2.00 | $8.00 | 200K | * |
| o4-mini | $1.10 | $4.40 | 128K | * |
| Anthropic | ||||
| claude-opus-4.6 | $5.00 | $25.00 | 200K | * |
| claude-sonnet-4.6 | $3.00 | $15.00 | 200K | * |
| claude-haiku-4.5 | $1.00 | $5.00 | 200K | |
| gemini-3.1-pro | $2.00 | $12.00 | 1M | * |
| gemini-3-pro-preview | $2.00 | $12.00 | 1M | * |
| gemini-3-flash-preview | $0.50 | $3.00 | 1M | |
| gemini-2.5-pro | $1.25 | $10.00 | 1M | * |
| gemini-2.5-flash | $0.30 | $2.50 | 1M | |
| gemini-2.5-flash-lite | $0.10 | $0.40 | 1M | |
| DeepSeek | ||||
| deepseek-chat | $0.28 | $0.42 | 128K | |
| deepseek-reasoner | $0.28 | $0.42 | 128K | * |
| xAI | ||||
| grok-4-0709 | $0.20 | $1.50 | 131K | * |
| grok-4-1-fast-reasoning | $0.20 | $0.50 | 131K | * |
| grok-code-fast-1 | $0.20 | $1.50 | 131K | |
| Moonshot | ||||
| kimi-k2.5 | $0.60 | $3.00 | 262K | * |
| MiniMax | ||||
| minimax-m2.5 | $0.30 | $1.20 | 205K | * |
ClawRouter 설치 및 사용 방법
ClawRouter는 간단한 스크립트로 설치와 구동을 시작할 수 있습니다. 설치 후 출력되는 지갑 주소에 USDC를 충전하면 즉시 스마트 라우팅을 사용할 수 있습니다:
# 1. 스마트 라우팅이 활성화된 상태로 설치
curl -fsSL https://blockrun.ai/ClawRouter-update | bash
openclaw gateway restart
# 2. 설치 시 화면에 출력된 Base 네트워크 주소로 USDC 충전
AI 기반 진단 도구 'Doctor'
설정이나 네트워크에 문제가 생겼을 때, 자체 내장된 진단 도구인 'Doctor'를 사용하여 문제를 쉽게 해결할 수 있습니다. 시스템의 진단 정보를 수집한 뒤 Claude Sonnet이나 Opus 모델로 전송하여 AI가 직접 분석 결과를 알려줍니다.
# 기본 진단 (Claude Sonnet 4.6 사용)
npx @blockrun/clawrouter doctor
# 특정 문제에 대한 복잡한 질의 (Claude Opus 사용)
npx @blockrun/clawrouter doctor opus "why is my request failing?"
라이선스
ClawRouter 프로젝트는 MIT License로 공개 및 배포되고 있습니다.
ClawRouter 프로젝트 GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 