メインコンテンツへスキップ

モデルプロバイダー

このページでは LLM/モデルプロバイダー を扱います(WhatsApp/Telegram などのチャットチャンネルではありません)。 モデル選択のルールについては /concepts/models を参照してください。 モデル選択ルールについては、/concepts/models を参照してください。

クイックルール

  • モデル参照は provider/model を使用します(例: opencode/claude-opus-4-6)。
  • agents.defaults.models を設定すると、許可リストになります。
  • CLI ヘルパー: openclaw onboardopenclaw models listopenclaw models set <provider/model>

組み込みプロバイダー(pi-ai カタログ)

pi-aiカタログを持つOpenClaw船。 OpenClaw には pi‑ai カタログが同梱されています。これらのプロバイダーは models.providers の設定を 必要としません。認証を設定してモデルを選択するだけです。

OpenAI

  • プロバイダー: openai
  • 認証: OPENAI_API_KEY
  • 例のモデル: openai/gpt-5.1-codex
  • CLI: openclaw onboard --auth-choice openai-api-key
{
  agents: { defaults: { model: { primary: "openai/gpt-5.1-codex" } } },
}

Anthropic

  • プロバイダー: anthropic
  • 認証: ANTHROPIC_API_KEY または claude setup-token
  • 例のモデル: anthropic/claude-opus-4-6
  • CLI: openclaw onboard --auth-choice token(setup-token を貼り付け)または openclaw models auth paste-token --provider anthropic
{
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

OpenAI Code(Codex)

  • プロバイダー: openai-codex
  • 認証: OAuth(ChatGPT)
  • 例のモデル: openai-codex/gpt-5.3-codex
  • CLI: openclaw onboard --auth-choice openai-codex または openclaw models auth login --provider openai-codex
{
  agents: { defaults: { model: { primary: "openai-codex/gpt-5.3-codex" } } },
}

OpenCode Zen

  • プロバイダー: opencode
  • 認証: OPENCODE_API_KEY(または OPENCODE_ZEN_API_KEY
  • 例のモデル: opencode/claude-opus-4-6
  • CLI: openclaw onboard --auth-choice opencode-zen
{
  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },
}

Google Gemini(API キー)

  • プロバイダー: google
  • 認証: GEMINI_API_KEY
  • 例のモデル: google/gemini-3-pro-preview
  • CLI: openclaw onboard --auth-choice gemini-api-key

Google Vertex、Antigravity、および Gemini CLI

  • プロバイダー: google-vertexgoogle-antigravitygoogle-gemini-cli
  • 認証: Vertex は gcloud ADC を使用します。Antigravity/Gemini CLI はそれぞれの認証フローを使用します。
  • Antigravity OAuth はバンドルされたプラグインとして提供されます(google-antigravity-auth、既定では無効)。
    • 有効化: openclaw plugins enable google-antigravity-auth
    • ログイン: openclaw models auth login --provider google-antigravity --set-default
  • Gemini CLI OAuth はバンドルされたプラグインとして提供されます(google-gemini-cli-auth、既定では無効)。
    • 有効化: openclaw plugins enable google-gemini-cli-auth
    • ログイン: openclaw models auth login --provider google-gemini-cli --set-default
    • 注記: openclaw.json にクライアント ID やシークレットを 貼り付けません。CLI のログインフローは、 トークンをゲートウェイ ホスト上の認証プロファイルに保存します。 CLIログインフローは、ゲートウェイホストの認証プロファイルに トークンを格納します。 CLIログインフローは、ゲートウェイホストの認証プロファイルに トークンを格納します。

Z.AI(GLM)

  • プロバイダー: zai
  • 認証: ZAI_API_KEY
  • 例のモデル: zai/glm-4.7
  • CLI: openclaw onboard --auth-choice zai-api-key
    • エイリアス: z.ai/*z-ai/*zai/* に正規化されます

Vercel AI Gateway

  • プロバイダー: vercel-ai-gateway
  • 認証: AI_GATEWAY_API_KEY
  • 例のモデル: vercel-ai-gateway/anthropic/claude-opus-4.6
  • CLI: openclaw onboard --auth-choice ai-gateway-api-key

その他の組み込みプロバイダー

  • OpenRouter: openrouterOPENROUTER_API_KEY
  • 例のモデル: openrouter/anthropic/claude-sonnet-4-5
  • xAI: xaiXAI_API_KEY
  • Groq: groqGROQ_API_KEY
  • Cerebras: cerebrasCEREBRAS_API_KEY
    • Cerebras 上の GLM モデルは ID zai-glm-4.7 および zai-glm-4.6 を使用します。
    • OpenAI 互換のベース URL: https://api.cerebras.ai/v1
  • Mistral: mistralMISTRAL_API_KEY
  • GitHub Copilot: github-copilotCOPILOT_GITHUB_TOKENGH_TOKENGITHUB_TOKEN
  • Hugging Face Inference: huggingfaceHUGGINGFACE_HUB_TOKEN または HF_TOKEN)— OpenAI 互換ルーター;例のモデル: huggingface/deepseek-ai/DeepSeek-R1;CLI: openclaw onboard --auth-choice huggingface-api-keyHugging Face (Inference) を参照してください。

models.providers 経由のプロバイダー(カスタム/ベース URL)

models.providers(または models.json)を使用して カスタム プロバイダーや OpenAI/Anthropic 互換のプロキシを追加します。

Moonshot AI(Kimi)

Moonshot は OpenAI 互換エンドポイントを使用するため、カスタムプロバイダーとして設定します。
  • プロバイダー: moonshot
  • 認証: 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
  • 認証: 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
  • 認証: 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(Anthropic 互換): --auth-choice minimax-api
  • 認証: MINIMAX_API_KEY
セットアップの詳細、モデルオプション、設定スニペットについては /providers/minimax を参照してください。

Ollama

Ollama は OpenAI 互換 API を提供するローカル LLM ランタイムです。
  • プロバイダー: ollama
  • 認証: 不要(ローカルサーバー)
  • 例のモデル: ollama/llama3.3
  • インストール: https://ollama.ai
# Install Ollama, then pull a model:
ollama pull llama3.3
{
  agents: {
    defaults: { model: { primary: "ollama/llama3.3" } },
  },
}
Ollama は、http://127.0.0.1:11434/v1 でローカル実行している場合に自動検出されます。モデルの推奨事項やカスタム設定については /providers/ollama を参照してください。 モデルの推奨とカスタム設定については、/providers/ollamaを参照してください。

vLLM

vLLM はローカル(またはセルフホスト型)の OpenAI 互換サーバーです:
  • プロバイダー: vllm
  • 認証: 任意(サーバー設定によります)
  • デフォルトのベース URL: http://127.0.0.1:8000/v1
ローカルで自動検出を有効にするには(サーバーが認証を強制しない場合は任意の値で可):
export VLLM_API_KEY="vllm-local"
次にモデルを設定します(/v1/models が返す ID のいずれかに置き換えてください):
{
  agents: {
    defaults: { model: { primary: "vllm/your-model-id" } },
  },
}
詳細は /providers/vllm を参照してください。

ローカルプロキシ(LM Studio、vLLM、LiteLLM など)

例(OpenAI 互換):
{
  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,
          },
        ],
      },
    },
  },
}
注記:
  • カスタムプロバイダーの場合、reasoninginputcostcontextWindow、および maxTokens は任意です。 省略した場合、OpenClaw は次の既定値を使用します。 省略された場合、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-6
openclaw models list
完全な設定例については、/gateway/configuration も参照してください。