🤖 模型配置进阶

支持的模型列表

OpenClaw 支持主流 LLM 提供商，通过内置 Provider 或自定义 OpenAI 兼容接口接入。

内置 Provider（直接使用）

Provider	模型示例	环境变量
`anthropic`	claude-opus-4-6, claude-sonnet-4-5	`ANTHROPIC_API_KEY`
`openai`	gpt-5.2, gpt-5-mini	`OPENAI_API_KEY`
`openrouter`	各种模型（中转）	`OPENROUTER_API_KEY`
`minimax`	MiniMax-M2.1	`MINIMAX_API_KEY`
`zai`	glm-4.7 (智谱)	`ZAI_API_KEY`
`moonshot`	kimi-k2.5	`MOONSHOT_API_KEY` / `KIMI_API_KEY`
`ollama`	本地模型	无需 Key
`opencode`	多模型代理	`OPENCODE_API_KEY`

通过自定义 Provider 接入

模型	API 兼容	说明
DeepSeek	OpenAI	国内直连
通义千问 (Qwen)	OpenAI	阿里云百炼
Kimi	OpenAI / Anthropic	Moonshot
零一万物 (Yi)	OpenAI	国内可用
Cerebras GLM	OpenAI	高速推理

多模型配置和切换

配置多个模型

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "anthropic/claude-sonnet-4-5": { alias: "sonnet" },
        "openai/gpt-5.2": { alias: "gpt" },
        "deepseek/deepseek-chat": { alias: "ds" },
        "minimax/MiniMax-M2.1": { alias: "minimax" },
      },
      model: {
        primary: "anthropic/claude-sonnet-4-5",
      },
    },
  },
}

运行时切换

在聊天中使用 /model 命令：

/model opus          # 切换到 Claude Opus
/model gpt           # 切换到 GPT
/model ds            # 切换到 DeepSeek
/model sonnet        # 切回 Sonnet

💡 别名（alias）就是 /model 命令的快捷方式，取短一点好记。

备用模型（Fallback）设置

当主模型 API 出错或限速时，自动切换到备用模型：

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: [
          "minimax/MiniMax-M2.1",
          "openrouter/deepseek/deepseek-r1:free",
        ],
      },
    },
  },
}

Fallback 触发条件：认证失败、限速（429）、服务不可用（5xx）、超时等。

<aside> 💡

相关教程：OpenClaw 模型挂了怎么办？快速切换的方法必须码住

</aside>