モデルプロバイダー
モデルプロバイダー概要と、サンプル設定 + CLI フロー。
このページは LLM/モデルプロバイダー(WhatsApp/Telegram などのチャットチャネルではない)について説明します。
モデル選択ルールについては、''/concepts/models'' を参照してください。
クイックルール
- モデル参照は ''provider/model'' を使用します(例:''opencode/claude-opus-4-5'')。
- ''agents.defaults.models'' を設定すると、ホワイトリストになります。
- CLI helpers: ''openclaw onboard'', ''openclaw models list'', ''openclaw models set <provider/model>''.
組み込みプロバイダー(pi-ai ディレクトリ)
OpenClaw には pi‑ai ディレクトリが含まれています。これらのプロバイダーは不要
''models.providers'' 設定;認証を設定してモデルを選択するだけです。
#
OpenAI
- プロバイダー:''openai''
- Auth: ''OPENAI_API_KEY''
- モデル例:''openai/gpt-5.2''
- CLI:''openclaw onboard --auth-choice openai-api-key''
{
agents: { defaults: { model: { primary: "openai/gpt-5.2" } } },
}#
Anthropic
- プロバイダー:''anthropic''
- 認証:''ANTHROPIC_API_KEY'' または ''claude setup-token''
- モデル例:''anthropic/claude-opus-4-5''
- CLI:''openclaw onboard --auth-choice token''(セットアップトークンを貼り付け)または ''openclaw models auth paste-token --provider anthropic''
{
agents: { defaults: { model: { primary: "anthropic/claude-opus-4-5" } } },
}#
OpenAI Codex
- プロバイダー:''openai-codex''
- Auth: OAuth (ChatGPT)
- モデル例:''openai-codex/gpt-5.2''
- CLI:''openclaw onboard --auth-choice openai-codex'' または ''openclaw models auth login --provider openai-codex''
{
agents: { defaults: { model: { primary: "openai-codex/gpt-5.2" } } },
}#
OpenCode Zen
- プロバイダー:''opencode''
- 認証:''OPENCODE_API_KEY''(または ''OPENCODE_ZEN_API_KEY'')
- モデル例:''opencode/claude-opus-4-5''
- CLI:''openclaw onboard --auth-choice opencode-zen''
{
agents: { defaults: { model: { primary: "opencode/claude-opus-4-5" } } },
}#
Google Gemini(API キー)
- プロバイダー:''google''
- Auth: ''GEMINI_API_KEY''
- モデル例:''google/gemini-3-pro-preview''
- CLI:''openclaw onboard --auth-choice gemini-api-key''
#
Google Vertex、Antigravity、Gemini CLI
- プロバイダー:''google-vertex''、''google-antigravity''、''google-gemini-cli''
- 認証:Vertex は gcloud ADC を使用;Antigravity/Gemini CLI はそれぞれの認証フローを使用
- Antigravity OAuth はバンドルプラグインとして提供されます(''google-antigravity-auth''、デフォルトで無効)。
- Enable: ''openclaw plugins enable google-antigravity-auth''
- ログイン:''openclaw models auth login --provider google-antigravity --set-default''
- Gemini CLI OAuth はバンドルプラグインとして提供されます(''google-gemini-cli-auth''、デフォルトで無効)。
- Enable: ''openclaw plugins enable google-gemini-cli-auth''
- ログイン:''openclaw models auth login --provider google-gemini-cli --set-default''
- 注意:クライアント ID またはシークレットを ''openclaw.json'' に貼り付け''しないでください''。CLI ログインフローは
ゲートウェイホスト上の認証プロファイルにトークンを保存します。
-
#
Z.AI (GLM)
- プロバイダー:''zai''
- Auth: ''ZAI_API_KEY''
- モデル例:''zai/glm-4.7''
- CLI:''openclaw onboard --auth-choice zai-api-key''
- エイリアス:''z.ai/*'' と ''z-ai/*'' は ''zai/*'' に正規化されます
#
Vercel AI ゲートウェイ
- プロバイダー:''vercel-ai-gateway''
- Auth: ''AI_GATEWAY_API_KEY''
- モデル例:''vercel-ai-gateway/anthropic/claude-opus-4.5''
- CLI:''openclaw onboard --auth-choice ai-gateway-api-key''
#
その他の組み込みプロバイダー
- OpenRouter:''openrouter'' (''OPENROUTER_API_KEY'')
- モデル例:''openrouter/anthropic/claude-sonnet-4-5''
- xAI:''xai'' (''XAI_API_KEY'')
- Groq:''groq'' (''GROQ_API_KEY'')
- Cerebras:''cerebras'' (''CEREBRAS_API_KEY'')
- Cerebras 上の GLM モデルは ID ''zai-glm-4.7'' と ''zai-glm-4.6'' を使用します。
- OpenAI 互換のベース URL:''https://api.cerebras.ai/v1''。
- Mistral:''mistral'' (''MISTRAL_API_KEY'')
- GitHub Copilot:''github-copilot'' (''COPILOT_GITHUB_TOKEN'' / ''GH_TOKEN'' / ''GITHUB_TOKEN'')
`models.providers` 経由のプロバイダー(カスタム/ベース URL)
''models.providers'' (または ''models.json'')を使用して ''カスタム'' プロバイダーまたは
OpenAI/Anthropic 互換プロキシを追加します。
#
Moonshot AI (Kimi)
Moonshot は OpenAI 互換のエンドポイントを使用するため、カスタムプロバイダーとして設定します:
- プロバイダー:''moonshot''
- Auth: ''MOONSHOT_API_KEY''
- モデル例:''moonshot/kimi-k2.5''
Kimi K2 モデル ID:
- ''moonshot/kimi-k2.5''
- ''moonshot/kimi-k2-0905-preview''
- ''moonshot/kimi-k2-turbo-preview''
- ''moonshot/kimi-k2-thinking''
- ''moonshot/kimi-k2-thinking-turbo''
{
agents: {
defaults: { model: { primary: "moonshot/kimi-k2.5" } },
},
models: {
mode: "merge",
providers: {
moonshot: {
baseUrl: "https://api.moonshot.ai/v1",
apiKey: "${MOONSHOT_API_KEY}",
api: "openai-completions",
models: [{ id: "kimi-k2.5", name: "Kimi K2.5" }],
},
},
},
}#
Kimi Coding
Kimi Coding は Moonshot AI の Anthropic 互換エンドポイントを使用します:
- プロバイダー:''kimi-coding''
- Auth: ''KIMI_API_KEY''
- モデル例:''kimi-coding/k2p5''
{
env: { KIMI_API_KEY: "sk-..." },
agents: {
defaults: { model: { primary: "kimi-coding/k2p5" } },
},
}#
Qwen OAuth(無料ティア)
Qwen はデバイスコードフローを通じて Qwen Coder + Vision への OAuth アクセスを提供します。
バンドルプラグインを有効にしてからログインします:
openclaw plugins enable qwen-portal-auth openclaw models auth login --provider qwen-portal --set-default
モデル参照:
- ''qwen-portal/coder-model''
- ''qwen-portal/vision-model''
設定の詳細とメモについては、''/providers/qwen'' を参照してください。
#
Synthetic
Synthetic は ''synthetic'' プロバイダーの背後に Anthropic 互換モデルを提供します:
- プロバイダー:''synthetic''
- Auth: ''SYNTHETIC_API_KEY''
- モデル例:''synthetic/hf:MiniMaxAI/MiniMax-M2.1''
- CLI:''openclaw onboard --auth-choice synthetic-api-key''
{
agents: {
defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.1" } },
},
models: {
mode: "merge",
providers: {
synthetic: {
baseUrl: "https://api.synthetic.new/anthropic",
apiKey: "${SYNTHETIC_API_KEY}",
api: "anthropic-messages",
models: [{ id: "hf:MiniMaxAI/MiniMax-M2.1", name: "MiniMax M2.1" }],
},
},
},
}#
MiniMax
MiniMax はカスタムエンドポイントを使用するため、''models.providers'' 経由で設定されます:
- MiniMax (human-compatible): ''--auth-choice minimax-api''
- Auth: ''MINIMAX_API_KEY''
設定の詳細、モデルオプション、構成スニペットについては、''/providers/minimax'' を参照してください。
#
Ollama
Ollama は OpenAI 互換 API を提供するローカル LLM ランタイムです:
- プロバイダー:''ollama''
- 認証:なし(ローカルサーバー)
- モデル例:''ollama/llama3.3''
- インストール:https://ollama.ai
ollama pull llama3.3
{
agents: {
defaults: { model: { primary: "ollama/llama3.3" } },
},
}Ollama は ''http://127.0.0.1:11434/v1'' でローカルに実行されている場合、自動検出されます。モデルの推奨事項とカスタム構成については、''/providers/ollama'' を参照してください。
#
ローカルプロキシ(LM Studio、vLLM、LiteLLM など)
Example (OpenAI-compatible):
{
agents: {
defaults: {
model: { primary: "lmstudio/minimax-m2.1-gs32" },
models: { "lmstudio/minimax-m2.1-gs32": { alias: "Minimax" } },
},
},
models: {
providers: {
lmstudio: {
baseUrl: "http://localhost:1234/v1",
apiKey: "LMSTUDIO_KEY",
api: "openai-completions",
models: [
{
id: "minimax-m2.1-gs32",
name: "MiniMax M2.1",
reasoning: false,
input: ["text"],
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
contextWindow: 200000,
maxTokens: 8192,
},
],
},
},
},
}Notes:
- カスタムプロバイダーの場合、''reasoning''、''input''、''cost''、''contextWindow''、''maxTokens'' はオプションです。
省略すると、OpenClaw はデフォルトで次のようになります:
- ''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-5 openclaw models list
完全な構成例については、''/gateway/configuration'' も参照してください。