모델 및 제공업체

OpenClaw 에이전트는 모델에 구애받지 않습니다. 동일한 에이전트 설정, 스킬, 도구가 지원되는 모든 모델에서 작동합니다 — 두뇌만 교체하고 나머지는 그대로 유지하세요. 이 가이드는 어떤 두뇌를 선택할지 결정하는 데 도움을 줍니다.

OpenClaw의 모델 처리 방식

OpenClaw는 세 가지 프로토콜 어댑터를 통해 LLM 제공업체와 통신합니다:

• openai-completions — 대략 80%의 제공업체를 지원 (OpenAI, DeepSeek, Grok, GLM, Qwen, Step 및 모든 OpenAI 호환 API)
• anthropic-messages — Claude 모델용
• google-generative-ai — Gemini 모델용

대부분의 제공업체가 OpenAI 호환 형식을 따르기 때문에, 새로운 제공업체를 추가하는 것은 코드 변경이 아닌 설정 변경 — 베이스 URL과 API 키 — 으로 해결됩니다. 이것이 OpenClaw가 비대한 코드베이스 없이 20개 이상의 제공업체를 지원할 수 있는 이유입니다.

사용 가능한 모델

아래 표는 현재 Claw Buff에서 사용 가능한 모델입니다. 품질 지수는 공개 벤치마크 기반입니다(높을수록 좋으며, 0-4 스케일). 속도는 초당 토큰으로 측정됩니다. 혼합 비용은 입력 및 출력 토큰 가격의 가중 평균입니다.

어떤 모델을 선택해야 할까요?

단일 최고의 모델은 없습니다. 올바른 선택은 에이전트가 수행할 작업에 따라 달라집니다.

일반 에이전트 작업에 최적

Claude Sonnet 4.6 — 현재 모델 중 가장 강력한 도구 호출 정확도와 최고의 프롬프트 인젝션 저항성을 갖추고 있습니다. 에이전트가 도구를 호출하거나 웹을 브라우징하거나 신뢰할 수 없는 입력을 처리한다면, Sonnet이 가장 안전한 기본 선택입니다.

최고의 원시 지능

GPT-5.4 또는 Gemini 3.1 Pro — 둘 다 품질 벤치마크에서 idx 57을 기록합니다. GPT-5.4는 개방형 작업에서 더 창의적인 경향이 있습니다. Gemini 3.1 Pro는 훨씬 빠르고(125 vs 77 t/s) 저렴합니다($4.50 vs $5.63/M). Gemini 3.1 Pro는 Google에서 아직 "프리뷰"로 분류하므로 간헐적인 불완전함이 있을 수 있습니다.

최고 가성비

GLM-5 — 토큰당 $1.55에 품질 티어 4를 제공합니다. Sonnet과 GPT-5.4에 근접한 벤치마크 점수를 약 1/4 가격에 제공합니다. 프리미엄 비용 없이 좋은 품질이 필요할 때 강력한 선택입니다.

최고의 속도

Grok 4.20 Beta (227 t/s) 또는 Gemini 3 Flash (166 t/s) — 응답 지연 시간이 최고 품질보다 중요한 인터랙티브 에이전트에 적합합니다. Grok은 아직 베타이며 복잡한 에이전트 워크플로에 대한 검증이 부족합니다. Gemini 3 Flash는 품질을 속도로 교환합니다 — 티어 4가 아닌 티어 3입니다.

저예산 및 대량 처리

DeepSeek V3.2 ($0.29/M) 또는 Step 3.5 Flash ($0.15/M) — 대량 처리를 하거나 비용을 최소화하면서 실험할 때 적합합니다. Step 3.5 Flash는 가장 저렴한 옵션이지만 티어 2 품질입니다 — 간단한 Q&A에는 적합하지만 다단계 도구 호출 체인에서는 신뢰성이 떨어집니다.

프리미엄 및 복잡한 추론

Claude Opus 4.6 — 목록에서 가장 비싼 모델($10.00/M)이지만 깊은 다단계 추론, 섬세한 분석, 신중한 검토가 필요한 작업에 뛰어납니다. 품질이 비용을 정당화하는 경우에 사용하세요 — 법률 분석, 코드 아키텍처 결정, 연구 종합 등.

제공업체별 알려진 한계

모든 제공업체에는 트레이드오프가 있습니다. 주의할 점은 다음과 같습니다:

• DeepSeek — 25 t/s로 가장 느린 모델입니다. 다단계 추론 체인에서 품질이 저하될 수 있습니다. 피크 시간대에 속도 제한에 자주 걸립니다.
• OpenAI — 도구 호출이 Claude보다 일관성이 떨어집니다. 컨텍스트 윈도우가 Anthropic의 200K 대비 128K 토큰으로, 대용량 메모리나 많은 도구를 사용하는 에이전트에서는 중요합니다.
• Google Gemini — Gemini 3.1 Pro는 아직 "프리뷰" 상태입니다. Gemini 3 Flash는 속도를 위해 품질을 희생합니다.
• xAI Grok — 아직 "Beta"로 표시됩니다. Claude나 GPT에 비해 복잡한 에이전트 워크플로에 대한 커뮤니티 테스트가 적습니다.
• Z AI GLM-5 Turbo — 이름과 달리 처리량이 3 t/s에 불과합니다. 비 Turbo GLM-5가 훨씬 빠릅니다.

Claw Buff에서의 비용

Claw Buff는 크레딧 시스템을 사용합니다. 크레딧을 구매하고 에이전트가 토큰을 사용할 때 소비합니다. 환율은 간단합니다: 1센트 = 10크레딧. 크레딧 잔액은 콘솔에서 확인할 수 있으며, 모델별 사용량을 추적할 수 있습니다.

제공업체에 직접 결제하고 싶다면, Hobby 플랜은 BYOK(Bring Your Own Key)를 지원합니다. 지원되는 제공업체의 API 키를 직접 제공하면 Claw Buff는 구독료만 청구합니다 — 토큰 사용에 대한 마크업이 없습니다. API 키는 AES-256-GCM으로 저장 시 암호화됩니다.

모델 폴백

OpenClaw는 자동 모델 폴백을 지원합니다. 기본 모델과 폴백 목록을 정의합니다. 인증 오류, 속도 제한(HTTP 429), 타임아웃 등으로 기본 모델이 실패하면 에이전트가 자동으로 체인의 다음 모델로 재시도합니다.

Claw Buff에서는 플랜에 따라 폴백 체인이 자동으로 설정됩니다. 셀프 호스팅 OpenClaw에서는 openclaw.json에서 설정합니다:

{
  llm: {
    provider: "anthropic",
    model: "claude-sonnet-4.6",
    fallbacks: [
      { provider: "openai", model: "gpt-5.4" },
      { provider: "google", model: "gemini-3.1-pro" }
    ]
  }
}

Ollama를 사용한 로컬 모델

OpenClaw를 셀프 호스팅하는 경우, Ollama를 통해 로컬 모델을 사용할 수 있습니다. OpenClaw는 openai-completions 어댑터를 통해 Ollama에 연결됩니다(Ollama는 localhost:11434에서 OpenAI 호환 API를 제공합니다).

인기 있는 로컬 모델로는 Llama 3, Mistral, Qwen 2.5, Phi-4, DeepSeek, Gemma 등이 있습니다.

장점:

• 완전한 데이터 프라이버시 — 어떤 것도 컴퓨터를 떠나지 않음
• 하드웨어 투자 후 API 비용 없음
• 속도 제한 없음

단점:

• 모델 크기에 따라 16-32GB RAM 필요
• 소비자 하드웨어에서 클라우드 API보다 느림
• 대부분의 로컬 모델에서 도구 호출이 약하여 에이전트 기능이 제한됨

모델 전환

Claw Buff에서는 콘솔을 열고 Settings > Model로 이동하여 새 모델을 선택합니다. 변경은 다음 메시지부터 적용됩니다 — 재시작이 필요 없습니다.

셀프 호스팅 OpenClaw에서는 openclaw.json의 llm 섹션을 편집하고 Gateway를 재시작합니다. 대화 기록, 스킬, 도구는 모델 변경 시에도 보존됩니다.