Skip to content

模型故障转移

配置主模型和备用模型,主模型不可用时自动切换。

基本配置

json5
{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-5",
        fallbacks: [
          "openai/gpt-5.4",
          "openrouter/anthropic/claude-sonnet-4-5"
        ]
      }
    }
  }
}

执行顺序:primary → fallbacks[0] → fallbacks[1] → ...

高可用生产配置

json5
{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: [
          "openai/gpt-5.4",
          "openrouter/anthropic/claude-opus-4-6",
          "bailian/qwen3.5-plus"
        ]
      }
    }
  }
}

触发条件

故障转移在以下情况触发:

  • API 返回 5xx 错误
  • 请求超时
  • 认证失败 (401/403)
  • 速率限制 (429)

基于 OpenClaw 开源项目