모델 제공자

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

빠른 규칙

​

Plugin 소유 제공자 동작

​

API 키 순환

​

기본 제공자(pi-ai 카탈로그)

​

OpenAI

• 제공자: openai
• 인증: OPENAI_API_KEY
• 선택적 순환: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, 그리고 OPENCLAW_LIVE_OPENAI_KEY(단일 재정의)
• 예시 모델: openai/gpt-5.5, openai/gpt-5.4-mini
• 특정 설치 또는 API 키가 다르게 동작하면 openclaw models list --provider openai로 계정/모델 사용 가능 여부를 확인하세요.
• CLI: openclaw onboard --auth-choice openai-api-key
• 기본 전송은 auto입니다. OpenClaw는 전송 선택을 pi-ai에 전달합니다.
• 모델별 재정의는 agents.defaults.models["openai/<model>"].params.transport("sse", "websocket", 또는 "auto")를 통해 수행합니다.
• OpenAI 우선순위 처리는 agents.defaults.models["openai/<model>"].params.serviceTier를 통해 활성화할 수 있습니다.
• /fast 및 params.fastMode는 직접 openai/* Responses 요청을 api.openai.com의 service_tier=priority에 매핑합니다.
• 공유 /fast 토글 대신 명시적 티어를 원할 때는 params.serviceTier를 사용하세요.
• 숨겨진 OpenClaw 기여도 헤더(originator, version, User-Agent)는 api.openai.com으로 가는 네이티브 OpenAI 트래픽에만 적용되며, 일반 OpenAI 호환 프록시에는 적용되지 않습니다.
• 네이티브 OpenAI 경로는 Responses store, 프롬프트 캐시 힌트, OpenAI 추론 호환 페이로드 형성도 유지합니다. 프록시 경로는 그렇지 않습니다.
• openai/gpt-5.3-codex-spark는 라이브 OpenAI API 요청이 이를 거부하고 현재 Codex 카탈로그가 이를 노출하지 않기 때문에 OpenClaw에서 의도적으로 숨겨져 있습니다.

{
  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },
}

​

Anthropic

• 제공자: anthropic
• 인증: ANTHROPIC_API_KEY
• 선택적 순환: ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2, 그리고 OPENCLAW_LIVE_ANTHROPIC_KEY(단일 재정의)
• 예시 모델: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• 직접 공개 Anthropic 요청은 공유 /fast 토글과 params.fastMode를 지원하며, 여기에는 api.anthropic.com으로 전송되는 API 키 및 OAuth 인증 트래픽이 포함됩니다. OpenClaw는 이를 Anthropic service_tier(auto 대 standard_only)에 매핑합니다.
• 선호 Claude CLI 구성은 모델 참조를 표준으로 유지하고 CLI 백엔드를 별도로 선택합니다. 모델 범위 agentRuntime.id: "claude-cli"와 함께 anthropic/claude-opus-4-7을 사용하세요. 레거시 claude-cli/claude-opus-4-7 참조도 호환성을 위해 계속 작동합니다.

{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

​

OpenAI Codex OAuth

• 제공자: openai-codex
• 인증: OAuth(ChatGPT)
• 레거시 PI 모델 참조: openai-codex/gpt-5.5
• 네이티브 Codex 앱 서버 하네스 참조: openai/gpt-5.5
• 네이티브 Codex 앱 서버 하네스 문서: Codex 하네스
• 레거시 모델 참조: codex/gpt-*
• Plugin 경계: openai-codex/*는 OpenAI Plugin을 로드합니다. 네이티브 Codex 앱 서버 Plugin은 Codex 하네스 런타임 또는 레거시 codex/* 참조로만 선택됩니다.
• CLI: openclaw onboard --auth-choice openai-codex 또는 openclaw models auth login --provider openai-codex
• 기본 전송은 auto입니다(WebSocket 우선, SSE 폴백).
• PI 모델별 재정의는 agents.defaults.models["openai-codex/<model>"].params.transport("sse", "websocket", 또는 "auto")를 통해 수행합니다.
• params.serviceTier는 네이티브 Codex Responses 요청(chatgpt.com/backend-api)에도 전달됩니다.
• 숨겨진 OpenClaw 기여도 헤더(originator, version, User-Agent)는 chatgpt.com/backend-api로 가는 네이티브 Codex 트래픽에만 첨부되며, 일반 OpenAI 호환 프록시에는 첨부되지 않습니다.
• 직접 openai/*와 같은 /fast 토글 및 params.fastMode 구성을 공유합니다. OpenClaw는 이를 service_tier=priority에 매핑합니다.
• openai-codex/gpt-5.5는 Codex 카탈로그 네이티브 contextWindow = 400000과 기본 런타임 contextTokens = 272000을 사용합니다. 런타임 한도는 models.providers.openai-codex.models[].contextTokens로 재정의하세요.
• 정책 참고: OpenAI Codex OAuth는 OpenClaw 같은 외부 도구/워크플로에 명시적으로 지원됩니다.
• 일반적인 구독과 네이티브 Codex 런타임 경로의 경우 openai-codex 인증으로 로그인하되 openai/gpt-5.5를 구성하세요. OpenAI 에이전트 턴은 기본적으로 Codex를 선택합니다.
• PI를 통한 호환성 경로를 원할 때만 제공자/모델 agentRuntime.id: "pi"를 사용하세요. 그렇지 않으면 openai/gpt-5.5를 기본 Codex 하네스에 유지하세요.
• 이전 openai-codex/gpt-5.1*, openai-codex/gpt-5.2*, openai-codex/gpt-5.3* 참조는 ChatGPT/Codex OAuth 계정이 이를 거부하기 때문에 숨겨져 있습니다. 대신 openai-codex/gpt-5.5 또는 네이티브 Codex 런타임 경로를 사용하세요.

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.5" },
    },
  },
}

{
  models: {
    providers: {
      "openai-codex": {
        models: [{ id: "gpt-5.5", contextTokens: 160000 }],
      },
    },
  },
}

​

기타 구독형 호스팅 옵션

​

OpenCode

• 인증: OPENCODE_API_KEY(또는 OPENCODE_ZEN_API_KEY)
• Zen 런타임 제공자: opencode
• Go 런타임 제공자: opencode-go
• 예시 모델: opencode/claude-opus-4-6, opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen 또는 openclaw onboard --auth-choice opencode-go

{
  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },
}

​

Google Gemini(API 키)

• 제공자: google
• 인증: GEMINI_API_KEY
• 선택적 순환: GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, GOOGLE_API_KEY 대체, 및 OPENCLAW_LIVE_GEMINI_KEY(단일 재정의)
• 예시 모델: google/gemini-3.1-pro-preview, google/gemini-3-flash-preview
• 호환성: google/gemini-3.1-flash-preview를 사용하는 기존 OpenClaw 구성은 google/gemini-3-flash-preview로 정규화됩니다.
• 별칭: google/gemini-3.1-pro는 허용되며 Google의 라이브 Gemini API ID인 google/gemini-3.1-pro-preview로 정규화됩니다.
• CLI: openclaw onboard --auth-choice gemini-api-key
• 사고: /think adaptive는 Google 동적 사고를 사용합니다. Gemini 3/3.1은 고정 thinkingLevel을 생략합니다. Gemini 2.5는 thinkingBudget: -1을 전송합니다.
• 직접 Gemini 실행은 제공자 네이티브 cachedContents/... 핸들을 전달하기 위해 agents.defaults.models["google/<model>"].params.cachedContent(또는 기존 cached_content)도 허용합니다. Gemini 캐시 적중은 OpenClaw cacheRead로 표시됩니다.

​

Google Vertex 및 Gemini CLI

• 제공자: google-vertex, google-gemini-cli
• 인증: Vertex는 gcloud ADC를 사용합니다. Gemini CLI는 자체 OAuth 흐름을 사용합니다.

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

openclaw models auth login --provider google-gemini-cli --set-default

​

Z.AI (GLM)

• 제공자: zai
• 인증: ZAI_API_KEY
• 예시 모델: zai/glm-5.1
• CLI: openclaw onboard --auth-choice zai-api-key
  • 별칭: z.ai/* 및 z-ai/*는 zai/*로 정규화됩니다.
  • zai-api-key는 일치하는 Z.AI 엔드포인트를 자동 감지합니다. zai-coding-global, zai-coding-cn, zai-global, 및 zai-cn은 특정 표면을 강제합니다.

​

Vercel AI Gateway

• 제공자: vercel-ai-gateway
• 인증: AI_GATEWAY_API_KEY
• 예시 모델: vercel-ai-gateway/anthropic/claude-opus-4.6, vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

​

Kilo Gateway

• 제공자: kilocode
• 인증: KILOCODE_API_KEY
• 예시 모델: kilocode/kilo/auto
• CLI: openclaw onboard --auth-choice kilocode-api-key
• 기본 URL: https://api.kilo.ai/api/gateway/
• 정적 대체 카탈로그는 kilocode/kilo/auto를 제공합니다. 라이브 https://api.kilo.ai/api/gateway/models 검색은 런타임 카탈로그를 더 확장할 수 있습니다.
• kilocode/kilo/auto 뒤의 정확한 업스트림 라우팅은 Kilo Gateway가 소유하며, OpenClaw에 하드코딩되어 있지 않습니다.

​

기타 번들 제공자 Plugin

​

알아두면 좋은 특이 사항

​

models.providers를 통한 제공자(사용자 지정/base URL)

​

Moonshot AI (Kimi)

• 제공자: moonshot
• 인증: MOONSHOT_API_KEY
• 예시 모델: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key 또는 openclaw onboard --auth-choice moonshot-api-key-cn

• moonshot/kimi-k2.6
• moonshot/kimi-k2.5
• moonshot/kimi-k2-thinking
• moonshot/kimi-k2-thinking-turbo
• moonshot/kimi-k2-turbo

{
  agents: {
    defaults: { model: { primary: "moonshot/kimi-k2.6" } },
  },
  models: {
    mode: "merge",
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "${MOONSHOT_API_KEY}",
        api: "openai-completions",
        models: [{ id: "kimi-k2.6", name: "Kimi K2.6" }],
      },
    },
  },
}

​

Kimi 코딩

• Provider: kimi
• Auth: KIMI_API_KEY
• 예시 모델: kimi/kimi-for-coding

{
  env: { KIMI_API_KEY: "sk-..." },
  agents: {
    defaults: { model: { primary: "kimi/kimi-for-coding" } },
  },
}

​

Volcano Engine (Doubao)

• Provider: volcengine (코딩: volcengine-plan)
• Auth: VOLCANO_ENGINE_API_KEY
• 예시 모델: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

{
  agents: {
    defaults: { model: { primary: "volcengine-plan/ark-code-latest" } },
  },
}

​

BytePlus(국제)

• Provider: byteplus (코딩: byteplus-plan)
• Auth: BYTEPLUS_API_KEY
• 예시 모델: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

{
  agents: {
    defaults: { model: { primary: "byteplus-plan/ark-code-latest" } },
  },
}

​

Synthetic

• Provider: synthetic
• Auth: SYNTHETIC_API_KEY
• 예시 모델: synthetic/hf:MiniMaxAI/MiniMax-M2.5
• CLI: openclaw onboard --auth-choice synthetic-api-key

{
  agents: {
    defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" } },
  },
  models: {
    mode: "merge",
    providers: {
      synthetic: {
        baseUrl: "https://api.synthetic.new/anthropic",
        apiKey: "${SYNTHETIC_API_KEY}",
        api: "anthropic-messages",
        models: [{ id: "hf:MiniMaxAI/MiniMax-M2.5", name: "MiniMax M2.5" }],
      },
    },
  },
}

​

MiniMax

• MiniMax OAuth(글로벌): --auth-choice minimax-global-oauth
• MiniMax OAuth(CN): --auth-choice minimax-cn-oauth
• MiniMax API 키(글로벌): --auth-choice minimax-global-api
• MiniMax API 키(CN): --auth-choice minimax-cn-api
• Auth: minimax에는 MINIMAX_API_KEY; minimax-portal에는 MINIMAX_OAUTH_TOKEN 또는 MINIMAX_API_KEY

• 텍스트/채팅 기본값은 minimax/MiniMax-M2.7에 유지됩니다
• 이미지 생성은 minimax/image-01 또는 minimax-portal/image-01입니다
• 이미지 이해는 두 MiniMax 인증 경로 모두에서 Plugin 소유 MiniMax-VL-01입니다
• 웹 검색은 공급자 ID minimax에 유지됩니다

​

LM Studio

• Provider: lmstudio
• Auth: LM_API_TOKEN
• 기본 추론 기본 URL: http://localhost:1234/v1

{
  agents: {
    defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },
  },
}

​

Ollama

• Provider: ollama
• Auth: 필요 없음(로컬 서버)
• 예시 모델: ollama/llama3.3
• 설치: https://ollama.com/download

# Ollama를 설치한 다음 모델을 가져옵니다:
ollama pull llama3.3

{
  agents: {
    defaults: { model: { primary: "ollama/llama3.3" } },
  },
}

​

vLLM

• Provider: vllm
• Auth: 선택 사항(서버에 따라 다름)
• 기본 기본 URL: http://127.0.0.1:8000/v1

export VLLM_API_KEY="vllm-local"

{
  agents: {
    defaults: { model: { primary: "vllm/your-model-id" } },
  },
}

​

SGLang

• Provider: sglang
• Auth: 선택 사항(서버에 따라 다름)
• 기본 기본 URL: http://127.0.0.1:30000/v1

export SGLANG_API_KEY="sglang-local"

{
  agents: {
    defaults: { model: { primary: "sglang/your-model-id" } },
  },
}

​

로컬 프록시(LM Studio, vLLM, LiteLLM 등)

{
  agents: {
    defaults: {
      model: { primary: "lmstudio/my-local-model" },
      models: { "lmstudio/my-local-model": { alias: "Local" } },
    },
  },
  models: {
    providers: {
      lmstudio: {
        baseUrl: "http://localhost:1234/v1",
        apiKey: "${LM_API_TOKEN}",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [
          {
            id: "my-local-model",
            name: "Local Model",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 200000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

​

CLI 예시

openclaw onboard --auth-choice opencode-zen
openclaw models set opencode/claude-opus-4-6
openclaw models list

​

관련 항목

• 구성 참조 - 모델 구성 키
• 모델 장애 조치 - 폴백 체인 및 재시도 동작
• 모델 - 모델 구성 및 별칭
• 공급자 - 공급자별 설정 가이드