5.27 模型故障转移

OpenClaw 通过认证配置文件轮换和模型回退来处理故障。

认证配置文件

认证配置文件（API 密钥/OAuth）存储在：

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

配置文件按类型排序（OAuth 优先），然后按 lastUsed，冷却/禁用配置文件排在最后。

会话粘性

会话粘性将配置文件固定到每个会话，除非重置。

冷却机制

冷却使用指数退避：

• 1分钟 → 5分钟 → 25分钟 → 1小时上限
• 账单失败禁用配置文件 5-24 小时

模型回退

仅在所有提供商配置文件失败后触发模型回退，使用 agents.defaults.model.fallbacks。

配置

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-3-5-sonnet-20241022",
        fallbacks: ["openai/gpt-4o", "openai/gpt-4o-mini"]
      },
      auth: {
        order: ["oauth", "api-key"],
        cooldowns: {
          billingBackoffHours: [5, 12, 24]
        }
      }
    }
  }
}