Model providers Provider
기준일: 2026-07-26
난이도: 중급
공식 기준: Model provider quickstart
개요
이 페이지는 OpenClaw Model providers provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.
공식 요약: Model providers (LLMs) supported by OpenClaw
model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.
공식 문서 기반 상세
아래는 공식 providers/models 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.
Pick a provider, authenticate, then set the default model as provider/model.
Quick start (two steps)
- Authenticate with the provider (usually via
openclaw onboard). - Set the default model:
{
agents: { defaults: { model: { primary: "anthropic/claude-opus-4" } } },
}
Supported providers (starter set)
- Alibaba Model Studio
- Amazon Bedrock
- Anthropic (API + Claude CLI)
- Baseten (Inkling + Model APIs)
- BytePlus (International)
- Chutes
- Cloudflare AI Gateway
- Cohere
- ComfyUI
- DeepInfra
- fal
- Fireworks
- MiniMax
- Mistral
- Moonshot AI (Kimi + Kimi Coding)
- NovitaAI
- OpenAI (API + Codex)
- OpenCode (Zen + Go)
- OpenRouter
- Qianfan
- Qwen
- Runway
- StepFun
- Synthetic
- Venice (Venice AI)
- Vercel AI Gateway
- xAI
- Z.AI (GLM)
For the full provider catalog and advanced configuration, see Provider directory and Model providers.
Additional provider variants
anthropic-vertex- install@openclaw/anthropic-vertex-providerfor implicit Anthropic on Google Vertex support when Vertex credentials are available; no separate onboarding auth choicecopilot-proxy- local VS Code Copilot Proxy bridge; useopenclaw onboard --auth-choice copilot-proxygoogle-gemini-cli- unofficial Gemini CLI OAuth flow; requires a localgeminiinstall (brew install gemini-cliornpm install -g @google/gemini-cli); default modelgoogle-gemini-cli/gemini-3-flash-preview; useopenclaw onboard --auth-choice google-gemini-clioropenclaw models auth login --provider google-gemini-cli --set-default
관련 문서
검증 체크리스트
-
openclaw models list --provider <id>로 모델이 보이는지 확인 - 기본 model alias를
agents.defaults.model.primary에 설정했는지 확인 - API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
- failover 시 데이터가 다른 provider로 이동할 수 있는지 검토