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 支持非常多的模型提供商，常见的有：

⚙️ 三、配置步骤

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 命令切换模型，无需重启：

💡 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" }
  }
}

❓ 八、常见问题

📌 九、总结

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

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

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

👉 立即参与：