OpenClaw 多模型配置指南:如何自由切换大模型

🧩 一、前置概念：Provider / Model / Alias

在开始之前，先搞懂三个核心概念：

Provider — 模型提供方
如 anthropic、openai、deepseek

Model — 具体模型名称
如 claude-opus-4-6、gpt-5.2

Alias — 自定义快捷名
如 opus、sonnet、gpt

📌 完整格式：provider/model — 例如 anthropic/claude-opus-4-6

🏢 二、支持的模型提供商

OpenClaw 支持非常多的模型提供商，常见的有：

Anthropic · Claude 系列

OpenAI · GPT-4/5 系列

DeepSeek · DeepSeek 系列

Google · Gemini 系列

Moonshot · Kimi 系列

MiniMax · M2 系列

Mistral · Mistral 系列

Groq · LPU 推理加速

Ollama · 本地模型

OpenRouter · 聚合多模型

Qwen · 通义千问

GLM · 智谱

Z.AI · Z.AI 平台

Venice · 隐私优先

vLLM / SGLang · 本地部署

⚙️ 三、配置步骤

Step 1 — 配置文件位置

OpenClaw 的配置文件位于：
~/.openclaw/openclaw.json

💡 配置文件使用 JSON5 格式，支持注释和尾逗号，比普通 JSON 更好编辑。

Step 2 — 配置模型认证

方式 A：交互式认证（推荐）

openclaw onboard

方式 B：环境变量配置 API Key（更安全）

env: {
  vars: {
    ANTHROPIC_API_KEY: "sk-ant-...",
    OPENAI_API_KEY: "sk-...",
    DEEPSEEK_API_KEY: "sk-..."
  }
}

Step 3 — 配置默认模型

在 agents.defaults.model 中设置默认模型：

agents: {
  defaults: {
    model: {
      primary: "anthropic/claude-opus-4-6"
    }
  }
}

Step 4 — 配置多模型 + 回退机制 ⭐

配置主模型 + 多个备用模型，主模型不可用时自动切换：

agents: {
  defaults: {
    model: {
      primary: "anthropic/claude-opus-4-6",
      fallbacks: [
        "anthropic/claude-sonnet-4-6",
        "openai/gpt-5.2"
      ]
    }
  }
}

💡 主模型是 Claude Opus，如果 Opus 不可用，自动切换到 Sonnet，再不行就切到 GPT-5.2。

Step 5 — 配置模型别名

给常用模型起短名字，用 /sonnet 就能直接切换：

agents: {
  defaults: {
    models: {
      "anthropic/claude-opus-4-6": { alias: "opus" },
      "anthropic/claude-sonnet-4-6": { alias: "sonnet" },
      "openai/gpt-5.2": { alias: "gpt" },
      "deepseek/deepseek-chat": { alias: "deep" }
    }
  }
}

Step 6 — 按渠道指定不同模型

通过 channels.modelByChannel 为不同渠道配置专属模型：

channels: {
  modelByChannel: {
    telegram: { "123456789": "openai/gpt-5.2" },
    discord: { "987654321": "anthropic/claude-opus-4-6" }
  }
}

🎮 四、运行时切换：/model 命令

配置好后，在对话中可以随时用 /model 命令切换模型，无需重启：

/model 或 /model list — 显示可用模型列表（数字选择）

/model 3 — 通过数字选择模型

/model openai/gpt-5.2 — 直接指定完整模型名

/model sonnet — 使用别名快速切换

/model status — 查看模型详细状态

💡 Discord 平台还支持交互式下拉菜单，Provider + Model 两级选择。

📋 五、完整配置示例

{ // 🔑 环境变量 env: { vars: { ANTHROPIC_API_KEY: "sk-ant-...", OPENAI_API_KEY: "sk-...", DEEPSEEK_API_KEY: "sk-...", GROQ_API_KEY: "gsk-..." } }, // 👤 身份设置 identity: { name: "小Claw", emoji: "🦞" }, // 🤖 Agent 配置 agents: { defaults: { workspace: "~/.openclaw/workspace", model: { primary: "anthropic/claude-opus-4-6", fallbacks: [ "anthropic/claude-sonnet-4-6", "openai/gpt-5.2", "deepseek/deepseek-chat" ] }, models: { "anthropic/claude-opus-4-6": { alias: "opus" }, "anthropic/claude-sonnet-4-6": { alias: "sonnet" }, "openai/gpt-5.2": { alias: "gpt" }, "deepseek/deepseek-chat": { alias: "deep" } } } } }

🔐 六、多账号认证配置

同一个 Provider 有多个账号时，用 Auth Profiles 配置优先级：

auth: {
  profiles: {
    "anthropic:subscription": { provider: "anthropic", mode: "oauth", email: "me@example.com" },
    "anthropic:api": { provider: "anthropic", mode: "api_key" }
  },
  order: { anthropic: ["anthropic:subscription", "anthropic:api"] }
}

🖼️ 七、图片 / 音频 / PDF 专用模型

OpenClaw 支持单独配置各类专用模型：

agents: {
  defaults: {
    imageModel: { primary: "openrouter/anthropic/claude-sonnet-4-6" },
    imageGenerationModel: { primary: "openai/dall-e-3" },
    pdfModel: { primary: "anthropic/claude-opus-4-6" }
  }
}

❓ 八、常见问题

Q1: 模型切换后多久生效？

立即生效，下一轮对话就会使用新模型。

Q2: 配置了 fallback 但没有自动切换？

Fallback 只在模型完全不可用时触发（如 API 返回错误）。临时切换用 /model 命令即可。

Q3: 模型优先级顺序？

/model 命令 > 渠道配置 > 默认模型

Q4: 如何查看当前配置了哪些模型？

发送 /model status 查看详细配置信息。

📌 九、总结

配置默认模型agents.defaults.model.primary

配置备用模型agents.defaults.model.fallbacks[]

配置模型别名agents.defaults.models["..."].alias

按渠道指定模型channels.modelByChannel

运行时切换/model <别名或模型名>

查看模型状态/model status

搞定这些配置之后，你就可以在不同的对话场景下自由切换不同的 AI 模型了
日常闲聊用 Sonnet · 写代码用 Opus · 节省成本用 DeepSeek
非常灵活 🚀

🚀 MiniMax Token Plan 惊喜上线！新增语音、音乐、视频和图片生成权益。邀请好友享双重好礼，助力开发体验！

好友立享 9折专属优惠 + Builder 权益，你赢返利 + 社区特权！

👉 立即参与：