이 페이지는 LLM/모델 프로바이더를 다룹니다 (WhatsApp/Telegram 같은 채팅 채널이 아닙니다). 모델 선택 규칙은 모델을 참조하십시오.

간단한 규칙

모델 참조는 provider/model을 사용합니다 (예: opencode/claude-opus-4-6).
agents.defaults.models는 설정되면 허용 목록(allowlist)으로 작동합니다.
CLI 헬퍼: openclaw onboard, openclaw models list, openclaw models set <provider/model>.
models.providers.*.models[].contextWindow는 네이티브 모델 메타데이터이며, contextTokens는 유효 런타임 상한입니다.
폴백 규칙, 쿨다운 프로브, 세션 오버라이드 지속성은 모델 페일오버를 참조하십시오.
OpenAI 계열 경로는 접두사별로 다릅니다. openai/<model>은 PI에서 직접 OpenAI API 키 프로바이더를 사용하고, openai-codex/<model>은 PI에서 Codex OAuth를 사용하며, openai/<model>에 agents.defaults.embeddedHarness.runtime: "codex"를 더하면 네이티브 Codex 앱 서버 하네스를 사용합니다. OpenAI와 Codex 하네스를 참조하십시오.
GPT-5.5는 현재 구독/OAuth 경로를 통해 사용할 수 있습니다. PI에서 openai-codex/gpt-5.5를 사용하거나, Codex 앱 서버 하네스와 함께 openai/gpt-5.5를 사용합니다. openai/gpt-5.5에 대한 직접 API 키 경로는 OpenAI가 공개 API에서 GPT-5.5를 활성화하면 지원됩니다. 그때까지는 OPENAI_API_KEY 설정에 openai/gpt-5.4 같은 API 지원 모델을 사용하십시오.

플러그인 소유 프로바이더 동작

대부분의 프로바이더별 로직은 프로바이더 플러그인(registerProvider(...))에 있고, OpenClaw는 일반 추론 루프만 유지합니다. 플러그인은 온보딩, 모델 카탈로그, 인증 환경 변수 매핑, 전송/구성 정규화, 도구 스키마 정리, 페일오버 분류, OAuth 갱신, 사용량 보고, 사고/추론 프로파일 등을 소유합니다.

프로바이더 SDK 훅과 번들 플러그인 예시의 전체 목록은 프로바이더 플러그인에 있습니다. 완전히 커스텀 요청 실행기가 필요한 프로바이더는 별개의 더 심층적인 확장 서피스입니다.

NOTE

프로바이더 런타임 capabilities는 공유 러너 메타데이터(프로바이더 계열, 트랜스크립트/도구 사용 특성, 전송/캐시 힌트)입니다. 이는 공개 기능 모델과 같지 않습니다. 공개 기능 모델은 플러그인이 무엇을 등록하는지(텍스트 추론, 음성 등)를 설명합니다.

API 키 로테이션

선택된 프로바이더에 대해 일반 프로바이더 로테이션을 지원합니다.
다음을 통해 여러 키를 구성합니다:
- OPENCLAW_LIVE_<PROVIDER>_KEY (단일 라이브 오버라이드, 최고 우선순위)
- <PROVIDER>_API_KEYS (쉼표 또는 세미콜론 목록)
- <PROVIDER>_API_KEY (기본 키)
- <PROVIDER>_API_KEY_* (번호 목록, 예: <PROVIDER>_API_KEY_1)
Google 프로바이더의 경우 GOOGLE_API_KEY도 폴백으로 포함됩니다.
키 선택 순서는 우선순위를 유지하고 값을 중복 제거합니다.
요청은 레이트 리밋 응답(예: 429, rate_limit, quota, resource exhausted, Too many concurrent requests, ThrottlingException, concurrency limit reached, workers_ai ... quota limit exceeded, 또는 주기적 사용량 제한 메시지)에서만 다음 키로 재시도됩니다.
레이트 리밋이 아닌 실패는 즉시 실패하며 키 로테이션이 시도되지 않습니다.
모든 후보 키가 실패하면 마지막 시도의 최종 오류가 반환됩니다.

내장 프로바이더 (pi-ai 카탈로그)

OpenClaw는 pi-ai 카탈로그와 함께 제공됩니다. 이 프로바이더들은 models.providers 구성이 필요하지 않습니다. 인증을 설정하고 모델을 선택하기만 하면 됩니다.

OpenAI

프로바이더: openai
인증: OPENAI_API_KEY
선택적 로테이션: OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, 그리고 OPENCLAW_LIVE_OPENAI_KEY (단일 오버라이드)
예시 모델: openai/gpt-5.4, openai/gpt-5.4-mini
GPT-5.5 직접 API 지원은 OpenAI가 API에서 GPT-5.5를 노출하는 즉시 사용 가능합니다
CLI: openclaw onboard --auth-choice openai-api-key
기본 전송은 auto입니다 (WebSocket 우선, SSE 폴백)
모델별 오버라이드는 agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket", 또는 "auto")로 설정합니다
OpenAI Responses WebSocket 웜업은 params.openaiWsWarmup (true/false)을 통해 기본적으로 활성화됩니다
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에서 의도적으로 억제됩니다

json5

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

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)로 매핑합니다
Anthropic 참고: Anthropic 직원이 OpenClaw 스타일의 Claude CLI 사용이 다시 허용된다고 알려왔으므로, OpenClaw는 Anthropic이 새 정책을 공개하지 않는 한 이 통합에서 Claude CLI 재사용과 claude -p 사용을 허가된 것으로 취급합니다.
Anthropic setup-token은 지원되는 OpenClaw 토큰 경로로 계속 사용 가능하지만, 이제 OpenClaw는 가능할 때 Claude CLI 재사용과 claude -p를 선호합니다.

json5

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

OpenAI Codex OAuth

프로바이더: openai-codex
인증: OAuth (ChatGPT)
PI 모델 참조: openai-codex/gpt-5.5
네이티브 Codex 앱 서버 하네스 참조: agents.defaults.embeddedHarness.runtime: "codex"와 함께 openai/gpt-5.5
레거시 모델 참조: codex/gpt-*
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는 네이티브 contextWindow = 1000000과 기본 런타임 contextTokens = 272000을 유지합니다. 런타임 상한은 models.providers.openai-codex.models[].contextTokens로 오버라이드하십시오
정책 참고: OpenAI Codex OAuth는 OpenClaw 같은 외부 도구/워크플로우에 대해 명시적으로 지원됩니다.
현재 GPT-5.5 액세스는 OpenAI가 공개 API에서 GPT-5.5를 활성화할 때까지 이 OAuth/구독 경로를 사용합니다.

json5

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

json5

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

기타 구독형 호스팅 옵션

Qwen Cloud: Qwen Cloud 프로바이더 서피스에 Alibaba DashScope 및 Coding Plan 엔드포인트 매핑 포함
MiniMax: MiniMax Coding Plan OAuth 또는 API 키 액세스
GLM 모델: Z.AI Coding Plan 또는 일반 API 엔드포인트

OpenCode

인증: OPENCODE_API_KEY (또는 OPENCODE_ZEN_API_KEY)
Zen 런타임 프로바이더: opencode
Go 런타임 프로바이더: opencode-go
예시 모델: opencode/claude-opus-4-6, opencode-go/kimi-k2.5
CLI: openclaw onboard --auth-choice opencode-zen 또는 openclaw onboard --auth-choice opencode-go

json5

{
  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로 정규화됩니다
CLI: openclaw onboard --auth-choice gemini-api-key
직접 Gemini 실행은 agents.defaults.models["google/<model>"].params.cachedContent (또는 레거시 cached_content)도 허용하여 프로바이더 네이티브 cachedContents/... 핸들을 전달합니다. Gemini 캐시 히트는 OpenClaw cacheRead로 표시됩니다

Google Vertex 및 Gemini CLI

프로바이더: google-vertex, google-gemini-cli
인증: Vertex는 gcloud ADC를 사용하고, Gemini CLI는 자체 OAuth 흐름을 사용합니다
주의: OpenClaw의 Gemini CLI OAuth는 비공식 통합입니다. 일부 사용자가 서드파티 클라이언트 사용 후 Google 계정 제한을 보고했습니다. Google 약관을 검토하고 진행하기로 결정했다면 중요하지 않은 계정을 사용하십시오.
Gemini CLI OAuth는 번들된 google 플러그인의 일부로 제공됩니다.
- 먼저 Gemini CLI를 설치하십시오:
  - brew install gemini-cli
  - 또는 npm install -g @google/gemini-cli
- 활성화: openclaw plugins enable google
- 로그인: openclaw models auth login --provider google-gemini-cli --set-default
- 기본 모델: google-gemini-cli/gemini-3-flash-preview
- 참고: openclaw.json에 클라이언트 ID나 시크릿을 붙여넣지 않습니다. CLI 로그인 흐름은 게이트웨이 호스트의 인증 프로파일에 토큰을 저장합니다.
- 로그인 후 요청이 실패하면 게이트웨이 호스트에 GOOGLE_CLOUD_PROJECT 또는 GOOGLE_CLOUD_PROJECT_ID를 설정하십시오.
- Gemini CLI JSON 응답은 response에서 파싱됩니다. 사용량은 stats로 폴백되며, stats.cached는 OpenClaw cacheRead로 정규화됩니다.

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 뒤의 정확한 업스트림 라우팅은 OpenClaw에 하드코딩되지 않고 Kilo Gateway가 소유합니다.

설정 세부 사항은 /providers/kilocode를 참조하십시오.

기타 번들 프로바이더 플러그인

프로바이더	ID	인증 환경 변수	예시 모델
BytePlus	`byteplus` / `byteplus-plan`	`BYTEPLUS_API_KEY`	`byteplus-plan/ark-code-latest`
Cerebras	`cerebras`	`CEREBRAS_API_KEY`	`cerebras/zai-glm-4.7`
Cloudflare AI Gateway	`cloudflare-ai-gateway`	`CLOUDFLARE_AI_GATEWAY_API_KEY`	—
GitHub Copilot	`github-copilot`	`COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN`	—
Groq	`groq`	`GROQ_API_KEY`	—
Hugging Face Inference	`huggingface`	`HUGGINGFACE_HUB_TOKEN` 또는 `HF_TOKEN`	`huggingface/deepseek-ai/DeepSeek-R1`
Kilo Gateway	`kilocode`	`KILOCODE_API_KEY`	`kilocode/kilo/auto`
Kimi Coding	`kimi`	`KIMI_API_KEY` 또는 `KIMICODE_API_KEY`	`kimi/kimi-code`
MiniMax	`minimax` / `minimax-portal`	`MINIMAX_API_KEY` / `MINIMAX_OAUTH_TOKEN`	`minimax/MiniMax-M2.7`
Mistral	`mistral`	`MISTRAL_API_KEY`	`mistral/mistral-large-latest`
Moonshot	`moonshot`	`MOONSHOT_API_KEY`	`moonshot/kimi-k2.6`
NVIDIA	`nvidia`	`NVIDIA_API_KEY`	`nvidia/nvidia/llama-3.1-nemotron-70b-instruct`
OpenRouter	`openrouter`	`OPENROUTER_API_KEY`	`openrouter/auto`
Qianfan	`qianfan`	`QIANFAN_API_KEY`	`qianfan/deepseek-v3.2`
Qwen Cloud	`qwen`	`QWEN_API_KEY` / `MODELSTUDIO_API_KEY` / `DASHSCOPE_API_KEY`	`qwen/qwen3.5-plus`
StepFun	`stepfun` / `stepfun-plan`	`STEPFUN_API_KEY`	`stepfun/step-3.5-flash`
Together	`together`	`TOGETHER_API_KEY`	`together/moonshotai/Kimi-K2.5`
Venice	`venice`	`VENICE_API_KEY`	—
Vercel AI Gateway	`vercel-ai-gateway`	`AI_GATEWAY_API_KEY`	`vercel-ai-gateway/anthropic/claude-opus-4.6`
Volcano Engine (Doubao)	`volcengine` / `volcengine-plan`	`VOLCANO_ENGINE_API_KEY`	`volcengine-plan/ark-code-latest`
xAI	`xai`	`XAI_API_KEY`	`xai/grok-4`
Xiaomi	`xiaomi`	`XIAOMI_API_KEY`	`xiaomi/mimo-v2-flash`

알아둘 특이사항:

OpenRouter는 앱 귀속 헤더와 Anthropic cache_control 마커를 검증된 openrouter.ai 경로에만 적용합니다. 프록시 스타일 OpenAI 호환 경로이므로 네이티브 OpenAI 전용 셰이핑(serviceTier, Responses store, 프롬프트 캐시 힌트, OpenAI 추론 호환성)을 건너뜁니다. Gemini 기반 참조는 프록시 Gemini 사고 서명 세니타이즈만 유지합니다.
Kilo Gateway Gemini 기반 참조는 동일한 프록시 Gemini 세니타이즈 경로를 따릅니다. kilocode/kilo/auto 및 기타 프록시 추론 미지원 참조는 프록시 추론 주입을 건너뜁니다.
MiniMax API 키 온보딩은 input: ["text", "image"]를 갖는 명시적 M2.7 모델 정의를 씁니다. 번들된 카탈로그는 해당 구성이 구체화될 때까지 채팅 참조를 텍스트 전용으로 유지합니다.
xAI는 xAI Responses 경로를 사용합니다. /fast 또는 params.fastMode: true는 grok-3, grok-3-mini, grok-4, grok-4-0709를 *-fast 변형으로 재작성합니다. tool_stream은 기본적으로 켜져 있습니다. agents.defaults.models["xai/<model>"].params.tool_stream=false로 비활성화하십시오.
Cerebras GLM 모델은 zai-glm-4.7 / zai-glm-4.6을 사용합니다. OpenAI 호환 베이스 URL은 https://api.cerebras.ai/v1입니다.

`models.providers`를 통한 프로바이더 (커스텀/베이스 URL)

커스텀 프로바이더나 OpenAI/Anthropic 호환 프록시를 추가하려면 models.providers (또는 models.json)를 사용하십시오.

아래 번들 프로바이더 플러그인 다수가 이미 기본 카탈로그를 제공합니다. 기본 베이스 URL, 헤더, 또는 모델 목록을 오버라이드하고 싶을 때만 명시적 models.providers.<id> 항목을 사용하십시오.

Moonshot AI (Kimi)

Moonshot은 번들 프로바이더 플러그인으로 제공됩니다. 기본적으로 내장 프로바이더를 사용하고, 베이스 URL이나 모델 메타데이터를 오버라이드해야 할 때만 명시적 models.providers.moonshot 항목을 추가하십시오:

프로바이더: moonshot
인증: MOONSHOT_API_KEY
예시 모델: moonshot/kimi-k2.6
CLI: openclaw onboard --auth-choice moonshot-api-key 또는 openclaw onboard --auth-choice moonshot-api-key-cn

Kimi K2 모델 ID:

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

json5

{
  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 Coding

Kimi Coding은 Moonshot AI의 Anthropic 호환 엔드포인트를 사용합니다:

프로바이더: kimi
인증: KIMI_API_KEY
예시 모델: kimi/kimi-code

json5

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

레거시 kimi/k2p5는 호환성 모델 ID로 계속 허용됩니다.

Volcano Engine (Doubao)

Volcano Engine (火山引擎)은 중국에서 Doubao 및 기타 모델에 대한 액세스를 제공합니다.

프로바이더: volcengine (코딩: volcengine-plan)
인증: VOLCANO_ENGINE_API_KEY
예시 모델: volcengine-plan/ark-code-latest
CLI: openclaw onboard --auth-choice volcengine-api-key

json5

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

온보딩은 기본적으로 코딩 서피스를 사용하지만, 일반 volcengine/* 카탈로그도 동시에 등록됩니다.

온보딩/구성 모델 선택기에서 Volcengine 인증 선택은 volcengine/*와 volcengine-plan/* 행을 모두 선호합니다. 해당 모델이 아직 로드되지 않은 경우, OpenClaw는 빈 프로바이더 범위 선택기를 표시하는 대신 필터링되지 않은 카탈로그로 폴백합니다.

사용 가능한 모델:

volcengine/doubao-seed-1-8-251228 (Doubao Seed 1.8)
volcengine/doubao-seed-code-preview-251028
volcengine/kimi-k2-5-260127 (Kimi K2.5)
volcengine/glm-4-7-251222 (GLM 4.7)
volcengine/deepseek-v3-2-251201 (DeepSeek V3.2 128K)

코딩 모델 (volcengine-plan):

volcengine-plan/ark-code-latest
volcengine-plan/doubao-seed-code
volcengine-plan/kimi-k2.5
volcengine-plan/kimi-k2-thinking
volcengine-plan/glm-4.7

BytePlus (국제)

BytePlus ARK는 국제 사용자를 위해 Volcano Engine과 동일한 모델에 대한 액세스를 제공합니다.

프로바이더: byteplus (코딩: byteplus-plan)
인증: BYTEPLUS_API_KEY
예시 모델: byteplus-plan/ark-code-latest
CLI: openclaw onboard --auth-choice byteplus-api-key

json5

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

온보딩은 기본적으로 코딩 서피스를 사용하지만, 일반 byteplus/* 카탈로그도 동시에 등록됩니다.

온보딩/구성 모델 선택기에서 BytePlus 인증 선택은 byteplus/*와 byteplus-plan/* 행을 모두 선호합니다. 해당 모델이 아직 로드되지 않은 경우, OpenClaw는 빈 프로바이더 범위 선택기를 표시하는 대신 필터링되지 않은 카탈로그로 폴백합니다.

사용 가능한 모델:

byteplus/seed-1-8-251228 (Seed 1.8)
byteplus/kimi-k2-5-260127 (Kimi K2.5)
byteplus/glm-4-7-251222 (GLM 4.7)

코딩 모델 (byteplus-plan):

byteplus-plan/ark-code-latest
byteplus-plan/doubao-seed-code
byteplus-plan/kimi-k2.5
byteplus-plan/kimi-k2-thinking
byteplus-plan/glm-4.7

Synthetic

Synthetic은 synthetic 프로바이더 뒤에 Anthropic 호환 모델을 제공합니다:

프로바이더: synthetic
인증: SYNTHETIC_API_KEY
예시 모델: synthetic/hf:MiniMaxAI/MiniMax-M2.5
CLI: openclaw onboard --auth-choice synthetic-api-key

json5

{
  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는 커스텀 엔드포인트를 사용하므로 models.providers를 통해 구성됩니다:

MiniMax OAuth (Global): --auth-choice minimax-global-oauth
MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
MiniMax API 키 (Global): --auth-choice minimax-global-api
MiniMax API 키 (CN): --auth-choice minimax-cn-api
인증: minimax는 MINIMAX_API_KEY, minimax-portal은 MINIMAX_OAUTH_TOKEN 또는 MINIMAX_API_KEY

설정 세부 사항, 모델 옵션, 구성 스니펫은 /providers/minimax를 참조하십시오.

MiniMax의 Anthropic 호환 스트리밍 경로에서 OpenClaw는 명시적으로 설정하지 않는 한 기본적으로 thinking을 비활성화하며, /fast on은 MiniMax-M2.7을 MiniMax-M2.7-highspeed로 재작성합니다.

플러그인 소유 기능 분할:

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

LM Studio

LM Studio는 네이티브 API를 사용하는 번들 프로바이더 플러그인으로 제공됩니다:

프로바이더: lmstudio
인증: LM_API_TOKEN
기본 추론 베이스 URL: http://localhost:1234/v1

그런 다음 모델을 설정하십시오 (http://localhost:1234/api/v1/models가 반환한 ID 중 하나로 교체):

json5

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

OpenClaw는 디스커버리 + 자동 로드에 LM Studio의 네이티브 /api/v1/models와 /api/v1/models/load를 사용하며, 기본적으로 추론에는 /v1/chat/completions를 사용합니다. 설정 및 문제 해결은 /providers/lmstudio를 참조하십시오.

Ollama

Ollama는 번들 프로바이더 플러그인으로 제공되며 Ollama의 네이티브 API를 사용합니다:

프로바이더: ollama
인증: 불필요 (로컬 서버)
예시 모델: ollama/llama3.3
설치: https://ollama.com/download

bash

# Ollama 설치 후 모델을 pull:
ollama pull llama3.3

json5

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

Ollama는 OLLAMA_API_KEY로 옵트인하면 http://127.0.0.1:11434에서 로컬로 감지되며, 번들 프로바이더 플러그인이 Ollama를 openclaw onboard와 모델 선택기에 직접 추가합니다. 온보딩, 클라우드/로컬 모드, 커스텀 구성은 /providers/ollama를 참조하십시오.

vLLM

vLLM은 로컬/자체 호스팅 OpenAI 호환 서버를 위한 번들 프로바이더 플러그인으로 제공됩니다:

프로바이더: vllm
인증: 선택 사항 (서버에 따라 다름)
기본 베이스 URL: http://127.0.0.1:8000/v1

로컬에서 자동 디스커버리를 옵트인하려면 (서버가 인증을 강제하지 않으면 어떤 값이든 작동):

bash

export VLLM_API_KEY="vllm-local"

그런 다음 모델을 설정하십시오 (/v1/models가 반환한 ID 중 하나로 교체):

json5

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

자세한 내용은 /providers/vllm을 참조하십시오.

SGLang

SGLang은 빠른 자체 호스팅 OpenAI 호환 서버를 위한 번들 프로바이더 플러그인으로 제공됩니다:

프로바이더: sglang
인증: 선택 사항 (서버에 따라 다름)
기본 베이스 URL: http://127.0.0.1:30000/v1

로컬에서 자동 디스커버리를 옵트인하려면 (서버가 인증을 강제하지 않으면 어떤 값이든 작동):

bash

export SGLANG_API_KEY="sglang-local"

그런 다음 모델을 설정하십시오 (/v1/models가 반환한 ID 중 하나로 교체):

json5

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

자세한 내용은 /providers/sglang을 참조하십시오.

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

예시 (OpenAI 호환):

json5

{
  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",
        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,
          },
        ],
      },
    },
  },
}

참고 사항:

커스텀 프로바이더의 경우 reasoning, input, cost, contextWindow, maxTokens는 선택 사항입니다. 생략하면 OpenClaw는 다음으로 기본 설정됩니다:
- reasoning: false
- input: ["text"]
- cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }
- contextWindow: 200000
- maxTokens: 8192
권장: 프록시/모델 제한에 맞는 명시적 값을 설정하십시오.
네이티브가 아닌 엔드포인트(호스트가 api.openai.com이 아닌 비어있지 않은 baseUrl)의 api: "openai-completions"의 경우, OpenClaw는 지원되지 않는 developer 역할에 대한 프로바이더 400 오류를 피하기 위해 compat.supportsDeveloperRole: false를 강제합니다.
프록시 스타일 OpenAI 호환 경로는 네이티브 OpenAI 전용 요청 셰이핑도 건너뜁니다. service_tier 없음, Responses store 없음, 프롬프트 캐시 힌트 없음, OpenAI 추론 호환 페이로드 셰이핑 없음, 숨겨진 OpenClaw 귀속 헤더 없음.
baseUrl이 비어있거나 생략되면 OpenClaw는 기본 OpenAI 동작(api.openai.com으로 해석됨)을 유지합니다.
안전을 위해 명시적 compat.supportsDeveloperRole: true는 네이티브가 아닌 openai-completions 엔드포인트에서 여전히 오버라이드됩니다.

CLI 예시

bash

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

참고: 전체 구성 예시는 /gateway/configuration을 참조하십시오.

간단한 규칙 ​

플러그인 소유 프로바이더 동작 ​

API 키 로테이션 ​

내장 프로바이더 (pi-ai 카탈로그) ​

OpenAI ​

Anthropic ​

OpenAI Codex OAuth ​

기타 구독형 호스팅 옵션 ​

OpenCode ​

Google Gemini (API 키) ​

Google Vertex 및 Gemini CLI ​

Z.AI (GLM) ​

Vercel AI Gateway ​

Kilo Gateway ​

기타 번들 프로바이더 플러그인 ​

models.providers를 통한 프로바이더 (커스텀/베이스 URL) ​

Moonshot AI (Kimi) ​

Kimi Coding ​

Volcano Engine (Doubao) ​

BytePlus (국제) ​

Synthetic ​

MiniMax ​

LM Studio ​

Ollama ​

vLLM ​

SGLang ​

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

CLI 예시 ​

관련 문서 ​

간단한 규칙

플러그인 소유 프로바이더 동작

API 키 로테이션

내장 프로바이더 (pi-ai 카탈로그)

OpenAI

Anthropic

OpenAI Codex OAuth

기타 구독형 호스팅 옵션

OpenCode

Google Gemini (API 키)

Google Vertex 및 Gemini CLI

Z.AI (GLM)

Vercel AI Gateway

Kilo Gateway

기타 번들 프로바이더 플러그인

`models.providers`를 통한 프로바이더 (커스텀/베이스 URL)

Moonshot AI (Kimi)

Kimi Coding

Volcano Engine (Doubao)

BytePlus (국제)

Synthetic

MiniMax

LM Studio

Ollama

vLLM

SGLang

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

CLI 예시

관련 문서