模型故障转移

Moltbot 在两个阶段处理失败：

1. 认证配置轮换：在当前提供商内轮换认证配置。
2. 模型故障转移：切换到 agents.defaults.model.fallbacks 中的下一个模型。

本文说明运行时规则及背后数据。

认证存储（密钥 + OAuth）

Moltbot 对 API 密钥与 OAuth 令牌均使用认证配置。密钥存储在 ~/.clawdbot/agents/<agentId>/agent/auth-profiles.json（旧版：~/.clawdbot/agent/auth-profiles.json）。配置中的 auth.profiles / auth.order 仅作元数据与路由（不含密钥）。旧版仅导入用 OAuth 文件：~/.clawdbot/credentials/oauth.json（首次使用时导入到 auth-profiles.json）。更多见 OAuth。凭证类型：type: "api_key"、type: "oauth"。

配置 ID

OAuth 登录会创建独立配置，以便多账户共存。默认：无邮箱时为 provider:default。带邮箱的 OAuth：provider:<email>（如 google-antigravity:user@gmail.com）。配置存储在 auth-profiles.json 的 profiles 下。

轮换顺序

当提供商有多个配置时，Moltbot 按：1）显式配置 auth.order[provider]；2）配置中的 auth.profiles 按提供商过滤；3）存储中的 auth-profiles.json 该提供商条目。若未配置显式顺序，使用轮询：主键为配置类型（OAuth 优先于 API 密钥）；次键为 usageStats.lastUsed（同类型内最旧优先）；冷却/禁用配置移到最后，按最早过期排序。

会话粘性

Moltbot 按会话固定所选认证配置以保持提供商缓存热度。不会每次请求都轮换。固定配置会一直复用直到：会话重置（/new//reset）、完成一次压缩、或配置处于冷却/禁用。通过 /model …@<profileId> 的手动选择为该会话的用户覆盖，在新会话开始前不会自动轮换。

冷却

当配置因认证/限流错误（或类似限流的超时）失败时，Moltbot 会将其标记为冷却并切换到下一配置。格式/无效请求错误（如 Cloud Code Assist 工具调用 ID 校验失败）同样触发故障转移并使用相同冷却。冷却使用指数退避。详见英文文档。