文档
模型提供商
故障转移

故障转移

故障转移（Failover）是“让工作持续运行”的兜底能力：当当前 provider 的某个凭据失效/被限流时，OpenClaw 会先在同一 provider 内轮换认证配置；如果仍失败，再按顺序切到下一条模型回退。

1) 配置模型回退（最小可用） 

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

2) 运行时规则（记住两件事）

  • 先做“同 provider 的 auth profile 轮换”，再做“跨模型回退”。
  • 回退顺序来自 agents.defaults.model.fallbacks（有序数组）。

3) 验证与排障 

openclaw models status
openclaw models status --probe
openclaw doctor

4) 可选：用 CLI 管理回退列表 

openclaw models fallbacks list
openclaw models fallbacks add <provider/model>
openclaw models fallbacks remove <provider/model>
openclaw models fallbacks clear

相关链接

本地模型配置国产模型