深度

OpenClaw 多模型路由完全指南:30+ 模型提供商接入、智能切换与故障转移

OpenClaw 多模型路由系统完整教程:支持的 30+ 模型提供商全览(Anthropic/OpenAI/Gemini/Ollama/OpenRouter/DeepSeek/Qwen/GLM 等)、provider/model 格式的模型指定方式、按渠道/Agent/任务类型设置不同默认模型、Model Failover 故障转移配置(主模型失败自动切换备用模型)、Claude Max API Proxy 接入方式、本地模型(Ollama/vLLM)与云端模型混用策略,以及 Token 限制和费用控制实践。

2026/3/243分钟 阅读ClaudeEagle

OpenClaw 最大的差异化能力之一: 不绑死单一模型,30+ 模型提供商随意切换, 还能配置故障转移、按场景用不同模型。

支持的模型提供商(2026)

云端 API: Anthropic Claude 4/3.5 系列 OpenAI GPT-4o、o3、o4-mini Google Gemini 2.5 Pro/Flash DeepSeek DeepSeek V3/R1 xAI Grok 3 MistralAI Mistral Large/Small Groq Llama 3.3 超快推理 Together AI Llama/Qwen/Mistral OpenRouter 200+ 模型统一接口 Perplexity 搜索增强模型 国内云端: Moonshot AI Kimi K1.5 MiniMax abab6.5 GLM 智谱 GLM-4 Qwen 通义千问 Doubao 字节跳动火山引擎 Qianfan 百度文心一言 Xiaomi MiMo 小米 本地部署: Ollama 本地运行任意开源模型 vLLM 高性能本地推理 LiteLLM 本地模型代理 SGLang 结构化生成框架 企业/特殊: Amazon Bedrock AWS 托管模型 GitHub Copilot Copilot 订阅用户 Cloudflare AI CF Workers AI Vercel AI Vercel AI Gateway Claude Max Proxy Claude Max 拼车

模型指定格式

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

格式:provider/model-name

常用组合:

anthropic/claude-opus-4-6 最强,复杂推理 anthropic/claude-sonnet-4-6 能力/成本平衡(推荐日常) anthropic/claude-haiku-4-5 最快最便宜(简单任务) openai/gpt-4o OpenAI 旗舰 google/gemini-2.5-pro Google 最强 deepseek/deepseek-chat 国产高性价比 ollama/llama3.3 本地运行,免费 groq/llama-3.3-70b-versatile Groq 超快推理

按 Agent 设置不同模型

不同 Agent 用不同模型,精细控制成本和能力:

json
{
  "agents": {
    "personal-assistant": {
      "model": { "primary": "anthropic/claude-opus-4-6" }
    },
    "work-assistant": {
      "model": { "primary": "anthropic/claude-sonnet-4-6" }
    },
    "quick-helper": {
      "model": { "primary": "anthropic/claude-haiku-4-5" }
    },
    "local-coder": {
      "model": { "primary": "ollama/qwen2.5-coder:32b" }
    }
  }
}

故障转移(Model Failover)

主模型失败时自动切换备用模型:

json
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6",
        "fallback": [
          "openai/gpt-4o",
          "google/gemini-2.5-flash",
          "deepseek/deepseek-chat"
        ]
      }
    }
  }
}

触发 Failover 的场景:

  • API 限流(429 Too Many Requests)
  • 服务暂时不可用(503)
  • 超时(30s 内无响应)
  • 余额不足

Claude Max API Proxy 接入

如果你有 Claude Max 订阅,可以通过 API Proxy 接入:

json
{
  "providers": {
    "claude-max-proxy": {
      "baseUrl": "https://your-crs-server.com/api",
      "apiKey": "your-proxy-key"
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "claude-max-proxy/claude-sonnet-4-6" }
    }
  }
}

详见:CRS(Claude Relay Service)系列文章

Ollama 本地模型

完全本地运行,0 API 成本,保护隐私:

bash
# 先安装 Ollama 并下载模型
brew install ollama
ollama pull qwen2.5:14b
ollama pull llama3.3:70b
json
{
  "providers": {
    "ollama": {
      "baseUrl": "http://localhost:11434"
    }
  },
  "agents": {
    "local-agent": {
      "model": { "primary": "ollama/qwen2.5:14b" }
    }
  }
}

混用策略:敏感数据 → 本地 Ollama,普通任务 → 云端 Claude

国内模型接入(中国用户)

无法稳定访问 Anthropic 的用户可接入国内提供商:

json
{
  "providers": {
    "moonshot": {
      "apiKey": "sk-moonshot-xxx"
    },
    "deepseek": {
      "apiKey": "sk-deepseek-xxx"
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat",
        "fallback": ["moonshot/moonshot-v1-8k"]
      }
    }
  }
}

Token 限制与费用控制

json
{
  "agents": {
    "defaults": {
      "maxTokensPerRequest": 8192,
      "maxTokensPerDay": 100000,
      "budgetAlert": {
        "dailyUsdLimit": 5.0,
        "alertChannel": "telegram"
      }
    }
  }
}

超出限制时:

  • 拒绝新请求并通知用户
  • 发送告警到指定渠道
  • 自动切换到更便宜的 Fallback 模型

来源:OpenClaw 官方文档 - docs.openclaw.ai/providers/models

相关文章推荐

深度OpenClaw Session ID 生命周期规则:什么时候会开新会话,什么时候延续旧会话详解 OpenClaw sessionKey 与 sessionId 的区别,以及触发新会话的四种情形:手动重置、每日重置、空闲过期、父级分叉保护,附 Session Store 字段说明和 Cron 会话保留策略。2026/8/13深度OpenClaw 计费故障处理机制:余额不足时系统怎么办,Backoff 退避策略详解详解 OpenClaw 账单/额度类故障处理机制:与普通限流超时不同,计费故障采用更长的指数退避(5小时起步翻倍至24小时封顶)并标记禁用,附三类故障处理力度对比表和多账号部署实战建议。2026/8/13深度OpenClaw Model Failover 完全解析:Auth Profile 怎么轮换,为什么你的 OAuth 账号会"莫名其妙"被切走详解 OpenClaw Model Failover 机制:Auth Profile 轮换顺序、Session Stickiness 会话粘性、指数退避冷却规则,解释多账号场景下 OAuth 与 API Key 切换的常见困惑及固定账号的配置方法。2026/8/13深度OpenClaw Context Engine 完全指南:四个生命周期钩子如何决定模型看到什么详解 OpenClaw 可插拔上下文引擎架构:Ingest/Assemble/Compact/After turn 四个生命周期钩子的工作原理,systemPromptAddition 动态注入机制,以及如何安装和配置自定义 Context Engine 插件。2026/8/12深度OpenClaw Delegate 架构详解:让 Agent 以组织身份代表你行动,而不是冒充你详解 OpenClaw Delegate 代表架构:Agent 如何拥有独立身份代表组织成员行动而不冒充人类,三级能力分层(只读起草/代表发送/主动式)及硬性阻断规则、Gateway工具限制、沙箱隔离等安全配置。2026/8/12深度OpenClaw Capability 架构指南:插件边界、共享运行时和供应商解耦OpenClaw Capability Cookbook 官方文档中文整理:什么时候创建 capability、标准开发顺序、core/vendor plugin/feature plugin 分工、provider registry、runtime helper、image generation 示例和架构审查清单。2026/6/4