OpenClaw에 가장 좋은 API: 작업별 제공업체와 모델 선택

OpenClaw에 가장 적합한 API를 선택하려면 문서화된 모델 프로바이더에서 시작하세요. 모델 다양성이 필요하면 OpenRouter를, 집중적인 Claude 설정에는 직접 Anthropic을 선택하고, 모델 요금이 주요 구매 기준이라면 Kunavo를 비교하세요. 지속 가능한 최저가 설정을 위해 모든 작업을 하나의 비싼 모델로 보내지 말고 일상적인 확인과 어려운 작업을 분리하세요.

이 가이드는 어시스턴트의 응답과 도구 호출을 생성하는 LLM API를 비교합니다. 검색, 브라우징 및 이미지 서비스는 별도 구매 항목입니다. 호스팅과 전체 운영 비용은 OpenClaw 가격을 참조하세요.

무엇을 구매하는지에 따라 프로바이더를 선택하세요

OpenClaw는 프로바이더 디렉터리, OpenRouter 설정 가이드 및 별도의 사용자 지정 프로바이더 참조 문서를 제공합니다. 가격표에 등록된 게이트웨이라고 해서 OpenClaw에 기본 통합되어 있는 것은 아닙니다.

작업별로 다른 모델을 사용하세요

짧은 요약, 분류 및 범위가 제한된 하트비트 확인에는 Claude Haiku 4.5부터 시작하세요. 일반적인 코딩과 도구 작업에는 Claude Sonnet 5를 우선 후보로 삼으세요. 복잡한 저장소 변경과 장시간의 추론에는 Claude Opus 5를 우선 후보로 삼으세요. 이러한 시작점은 Anthropic의 모델 선택 가이드를 따르며, OpenClaw의 벤치마크 결과가 아닙니다.

에스컬레이션 규칙을 명시하세요. 일상적인 확인은 알려진 상태를 보고하거나 익숙하지 않은 상태를 더 강한 모델에 넘길 수 있습니다. 확인 작업이 조용히 대규모 디버깅 작업으로 커져서는 안 됩니다. 값과 임계값만 비교하면 되는 경우 해당 비교를 직접 실행하고 예외 해석에만 모델을 사용하세요.

기능 등급과 프로바이더 가격은 별개의 결정입니다. 원하는 모델의 실제 행을 비교하세요. 게이트웨이 요금은 벤더의 정가와 같은 순서를 따를 필요가 없습니다.

구체적인 가격 비교

프로바이더 간에 동일한 모델을 비교하세요. 표는 표준 비캐시 입력 및 출력 토큰 100만 개당 USD를 보여줍니다. 2026년 9월 17일에 확인한 Anthropic 직접 API 가격과 현재 Kunavo 카탈로그 요금을 나란히 비교합니다. 캐시 요금, 유료 도구 및 세금은 별도입니다.

한 달에 캐시되지 않은 입력 토큰 1,000만 개와 출력 토큰 100만 개가 있다고 가정해 보세요. 전부 Claude Opus 5에 할당하면 이 요금 기준으로 $52.50가 듭니다. 입력 토큰 900만 개와 출력 토큰 900,000개를 Claude Haiku 4.5에 할당하고 나머지를 Claude Opus 5에 할당하면 $14.70가 듭니다.

이는 가정한 작업 분할에 대한 산술 계산이며 절약을 보장하지 않습니다. 캐시 요금, 외부 도구 및 인프라는 제외되었고, 더 작은 모델이 추가 시도 없이 할당된 작업을 완료할 수 있다고 가정합니다. 이 마지막 조건에 따라 낮은 요금이 실제로 더 낮은 청구액을 만드는지가 결정됩니다.

첫 결제와 반복되는 컨텍스트를 예산에 반영하세요

Kunavo는 $10 선불 충전으로 시작하며 필수 구독이 없고 잔액은 만료되지 않습니다. 작은 작업은 해당 잔액의 일부를 사용하지만 토큰 비용은 자금이 충전된 계정을 개설하는 데 필요한 현금과 같지 않습니다. 결제 가이드에서는 카탈로그 추정치가 가격 상한이 아닌 이유도 설명합니다. 상위 단계 비용 청구가 해당 추정치를 초과하면 최종 요금이 더 높아질 수 있습니다.

OpenRouter의 크레딧 약관은 최소 구매 금액을 $5로 정합니다. 표준 종량제 카드 수수료는 5.5%이며 충전 1회당 최소 $0.80입니다. 따라서 세금 전 기준으로 크레딧 $5를 구매하면 $5.80, $100를 구매하면 $105.50가 듭니다. 수수료는 계정에 자금을 충전할 때 지불하며 모든 API 호출에 다시 추가되지 않습니다. 실제로 사용할 충전 크레딧을 비교하세요.

동일한 지침을 반복해서 보내는 어시스턴트라면 새 입력 가격을 기준으로 선택하기 전에 보고된 캐시 적중을 비교하세요. Sonnet 5의 직접 API 요금은 토큰 100만 개당 캐시 읽기 $0.20, 5분 캐시 쓰기 $2.50, 1시간 캐시 쓰기 $4입니다. Kunavo의 동일 모델 카탈로그 캐시 읽기 요금은 $0.14입니다. Kunavo에서는 Claude 캐시 쓰기가 입력 요금의 1.25배로 청구됩니다. 이러한 청구 요금만으로 모든 OpenClaw 경로가 캐싱을 사용한다고 확인할 수는 없습니다. 일상적인 확인을 캐시 적중으로 예산에 반영하기 전에 반환된 사용량을 확인하세요.

Anthropic의 가격에는 Sonnet 5와 Opus 5의 지원되는 1M 컨텍스트 창이 표준 요금으로 포함됩니다. Kunavo 역시 이러한 Claude 모델에 장문 컨텍스트 추가 요금을 부과하지 않습니다. 그래도 더 긴 기록은 더 많은 청구 토큰을 의미합니다. 반복 확인의 범위를 제한하고 새 입력, 캐시 쓰기, 캐시 읽기 및 출력을 월간 추정치에 별도로 포함하세요.

OpenRouter, 무료 또는 로컬 방식이 더 적합한 경우

모델 제품군을 비교하거나 상위 프로바이더 기본 설정을 제어해야 한다면 OpenRouter를 선택하세요. OpenRouter의 라우팅 문서는 가격, 지연 시간 및 처리량과 같은 우선순위를 지원합니다. 자동 라우팅이 항상 허용 가능한 결과 중 가장 저렴한 것을 선택한다고 가정하지 말고 구체적인 모델을 선택해 실시간 가격을 확인하세요.

초기 탐색이나 긴급하지 않은 작업에는 무료 엔드포인트를 사용하세요. OpenRouter는 무료 모델 요청 한도를 문서화하고 있으므로 토큰 가격이 0이라고 해서 항상 켜져 있는 어시스턴트에 충분한 용량이 보장되는 것은 아닙니다. 확인하지 않은 할당량에 시간에 민감한 일상 작업을 의존시키지 마세요.

하드웨어가 이미 준비되어 있고 운영을 감수할 수 있다면 로컬 추론을 선택하세요. OpenClaw의 Ollama 설정은 도구 지원을 포함한 모델 기능을 확인합니다. 대화는 잘하지만 필요한 도구 워크플로를 실행할 수 없는 모델은 해당 작업에서 유용한 절약형 선택이 아닙니다.

대체 경로를 복잡하게 추가하기 전에 작동하는 경로 하나를 구매하세요

먼저 모델 역할과 프로바이더를 선택하세요. 하나의 범위가 제한된 작업으로 모델 ID, 엔드포인트, 스트리밍, 도구 호출 및 사용량 보고를 확인하세요. 그런 다음 예산을 알고 있는 대체 경로를 추가하세요. 그렇지 않으면 장애가 작업을 다른 가격 또는 기능 등급으로 조용히 이동시킬 수 있습니다.

OpenClaw에서 Kunavo 경로 구성하기

이는 OpenClaw의 사용자 지정 프로바이더 스키마와 Kunavo의 Messages 엔드포인트를 기반으로 한 텍스트 전용 시작 구성입니다. 여기서는 유료 OpenClaw 작업으로 검증하지 않았습니다. 시험 기간 동안 현재 작동하는 경로를 계속 사용할 수 있게 유지하세요.

1. API 키에서 Kunavo 키를 생성하고 유료 요청을 보낼 준비가 되면 결제에서 계정에 자금을 충전하세요.
2. 게이트웨이의 환경에 KUNAVO_API_KEY을 설정하세요. OpenClaw는 ~/.openclaw/.env도 읽으며, 여기에 KUNAVO_API_KEY=your-key를 추가할 수 있습니다. 기존 프로세스 변수가 우선합니다. 환경 참조 문서를 참조하세요. 실제 키를 프로젝트 파일에 저장하지 마세요.
3. 구성을 백업한 다음 아래 필드를 ~/.openclaw/openclaw.json에 병합하고 다른 프로바이더, 에이전트 및 채널은 유지하세요. 구성 가이드에서는 기본값이 아닌 파일 위치를 다룹니다.

{
  "models": {
    "mode": "merge",
    "providers": {
      "kunavo": {
        "baseUrl": "https://api.kunavo.com",
        "apiKey": "${KUNAVO_API_KEY}",
        "api": "anthropic-messages",
        "authHeader": true,
        "models": [
          {
            "id": "claude-haiku-4-5",
            "name": "Claude Haiku 4.5",
            "input": [
              "text"
            ],
            "contextWindow": 200000,
            "maxTokens": 1024
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "kunavo/claude-haiku-4-5"
      }
    }
  }
}

기본 URL은 오리진입니다. 이 어댑터가 /v1/messages을 추가합니다. kunavo/ 접두사는 OpenClaw 프로바이더를 식별하며 요청의 모델 ID는 claude-haiku-4-5로 유지됩니다. 여기서 1024는 첫 시험을 위한 의도적으로 작은 출력 상한이며 모델의 기본 최대값이 아닙니다. 이 예제는 텍스트 입력만 선언합니다.

openclaw config validate
openclaw gateway restart
openclaw models list --provider kunavo

구성 검증은 구성을 확인하고 모델 목록 조회는 로드된 카탈로그를 확인하지만 어느 쪽도 유료 작업이 작동한다는 것을 입증하지는 않습니다. 실행 중인 게이트웨이가 새 프로바이더를 로드하도록 목록을 조회하기 전에 재시작하세요. 새 세션을 열고 활성 모델을 확인하세요. 기존 세션이나 에이전트는 기본값 재정의를 유지할 수 있습니다.

첫 작업으로 시험용 작은 README를 읽고 요약하도록 요청한 다음 해당 파일에 관한 후속 질문을 하나 하세요. 예약된 작업을 이전하기 전에 도구 결과, 응답 스트리밍 및 Kunavo에 기록된 청구액을 확인하세요. 401 오류가 발생하면 게이트웨이 환경의 키를 확인하고, model-not-found 오류가 발생하면 프로바이더 접두사와 모델 ID를 확인하세요. 로컬 비용 메타데이터가 없으면 프로바이더가 요청에 요금을 부과했는데도 추정치가 0으로 표시될 수 있습니다.

자주 묻는 질문

공식 문서는 2026년 9월 17일에 확인했습니다. Kunavo 요금과 예시 총액은 실시간 모델 카탈로그에서 계산했습니다.