OpenClawSkills
GitHub
コア概念 • 5分で読める

モデルプロバイダー

モデルプロバイダー概要と、サンプル設定 + CLI フロー。

このページは LLM/モデルプロバイダー(WhatsApp/Telegram などのチャットチャネルではない)について説明します。

モデル選択ルールについては、''/concepts/models'' を参照してください。

Tutorial.step

クイックルール

- モデル参照は ''provider/model'' を使用します(例:''opencode/claude-opus-4-5'')。

- ''agents.defaults.models'' を設定すると、ホワイトリストになります。

- CLI helpers: ''openclaw onboard'', ''openclaw models list'', ''openclaw models set <provider/model>''.

Tutorial.step

組み込みプロバイダー(pi-ai ディレクトリ)

OpenClaw には pi‑ai ディレクトリが含まれています。これらのプロバイダーは不要

''models.providers'' 設定;認証を設定してモデルを選択するだけです。

#

Tutorial.step

OpenAI

- プロバイダー:''openai''

- Auth: ''OPENAI_API_KEY''

- モデル例:''openai/gpt-5.2''

- CLI:''openclaw onboard --auth-choice openai-api-key''

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

#

Tutorial.step

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''

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

#

Tutorial.step

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''

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

#

Tutorial.step

OpenCode Zen

- プロバイダー:''opencode''

- 認証:''OPENCODE_API_KEY''(または ''OPENCODE_ZEN_API_KEY'')

- モデル例:''opencode/claude-opus-4-5''

- CLI:''openclaw onboard --auth-choice opencode-zen''

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

#

Tutorial.step

Google Gemini(API キー)

- プロバイダー:''google''

- Auth: ''GEMINI_API_KEY''

- モデル例:''google/gemini-3-pro-preview''

- CLI:''openclaw onboard --auth-choice gemini-api-key''

#

Tutorial.step

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 ログインフローは

ゲートウェイホスト上の認証プロファイルにトークンを保存します。

-

#

Tutorial.step

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/*'' に正規化されます

#

Tutorial.step

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''

#

Tutorial.step

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

- 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'')

Tutorial.step

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

''models.providers'' (または ''models.json'')を使用して ''カスタム'' プロバイダーまたは

OpenAI/Anthropic 互換プロキシを追加します。

#

Tutorial.step

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''

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

#

Tutorial.step

Kimi Coding

Kimi Coding は Moonshot AI の Anthropic 互換エンドポイントを使用します:

- プロバイダー:''kimi-coding''

- Auth: ''KIMI_API_KEY''

- モデル例:''kimi-coding/k2p5''

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

#

Tutorial.step

Qwen OAuth(無料ティア)

Qwen はデバイスコードフローを通じて Qwen Coder + Vision への OAuth アクセスを提供します。

バンドルプラグインを有効にしてからログインします:

Bash
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'' を参照してください。

#

Tutorial.step

Synthetic

Synthetic は ''synthetic'' プロバイダーの背後に Anthropic 互換モデルを提供します:

- プロバイダー:''synthetic''

- Auth: ''SYNTHETIC_API_KEY''

- モデル例:''synthetic/hf:MiniMaxAI/MiniMax-M2.1''

- CLI:''openclaw onboard --auth-choice synthetic-api-key''

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

#

Tutorial.step

MiniMax

MiniMax はカスタムエンドポイントを使用するため、''models.providers'' 経由で設定されます:

- MiniMax (human-compatible): ''--auth-choice minimax-api''

- Auth: ''MINIMAX_API_KEY''

設定の詳細、モデルオプション、構成スニペットについては、''/providers/minimax'' を参照してください。

#

Tutorial.step

Ollama

Ollama は OpenAI 互換 API を提供するローカル LLM ランタイムです:

- プロバイダー:''ollama''

- 認証:なし(ローカルサーバー)

- モデル例:''ollama/llama3.3''

- インストール:https://ollama.ai

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

Ollama は ''http://127.0.0.1:11434/v1'' でローカルに実行されている場合、自動検出されます。モデルの推奨事項とカスタム構成については、''/providers/ollama'' を参照してください。

#

Tutorial.step

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

Example (OpenAI-compatible):

Json5
{
  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''

- 推奨事項:エージェント/モデルの制限に一致する明示的な値を設定します。

Tutorial.step

CLI の例

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

完全な構成例については、''/gateway/configuration'' も参照してください。