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

- 身份验证：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''

- 授权：''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''

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

- 注意：您''不要''将客户端 ID 或机密粘贴到 ''openclaw.json'' 中。 CLI 登录流程存储

网关主机上的身份验证配置文件中的令牌。

-

#

Tutorial.step

Z.AI (GLM)

- 提供商：''zai''

- 授权：''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''

- 授权：''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_API_KEY'')

- 型号示例：''openrouter/anthropic/claude-sonnet-4-5''

- xAI：''xai'' (''XAI_API_KEY'')

- 格罗克：''groq'' (''GROQ_API_KEY'')

- 大脑：''cerebras'' (''CEREBRAS_API_KEY'')

- Cerebras 上的 GLM 模型使用 ID ''zai-glm-4.7'' 和 ''zai-glm-4.6''。

- OpenAI 兼容的基本 URL：''https://api.cerebras.ai/v1''。

- 米斯特拉尔：''mistral'' (''MISTRAL_API_KEY'')

- GitHub 副驾驶：''github-copilot'' (''COPILOT_GITHUB_TOKEN'' / ''GH_TOKEN'' / ''GITHUB_TOKEN'')

Tutorial.step

通过 `models.providers` 提供者（自定义/基本 URL）

使用 ''models.providers'' （或 ''models.json''）添加 ''自定义'' 提供程序或

OpenAI/Anthropic 兼容代理。

#

Tutorial.step

登月人工智能（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''

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 使用 Moonshot AI 的 Anthropic 兼容端点：

- 提供商：''kimi-coding''

- 授权：''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'' 提供者背后提供了与 Anthropic 兼容的模型：

- 提供商：''synthetic''

- 授权：''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 通过 ''models.providers'' 配置，因为它使用自定义端点：

- MiniMax（人类兼容）：''--auth-choice minimax-api''

- 授权：''MINIMAX_API_KEY''

请参阅 ''/providers/minimax'' 了解设置详细信息、模型选项和配置片段。

#

Tutorial.step

奥拉马

Ollama 是一个本地 LLM 运行时，提供 OpenAI 兼容的 API：

- 提供商：''ollama''

- 身份验证：不需要（本地服务器）

- 型号示例：''ollama/llama3.3''

- 安装：https://ollama.ai

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

在 ''http://127.0.0.1:11434/v1'' 本地运行时会自动检测 Ollama。请参阅 ''/providers/ollama'' 了解模型建议和自定义配置。

#

Tutorial.step

本地代理（LM Studio、vLLM、LiteLLM 等）

示例（OpenAI 兼容）：

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

注意事项：

- 对于自定义提供程序，''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'' 了解完整配置示例。