实践openclaw-concepts
Model failover · OpenClaw — OpenClaw 的模型故障转移机制:如何优雅处理 LLM 调用失败
OpenClaw 的模型故障转移机制:如何优雅处理 LLM 调用失败
2026-07-27原文
本文为要点摘要,完整细节以原文为准。
🧭 一图看懂
由原文自动提炼 · 以原文为准点击任一分支,查看这一点的一句话解读
OpenClaw 模型故障转移机制
先在同 provider 内轮换 auth-profile,再按 fallbacks 列表切换模型
- 阶段一:Auth-profile rotation
- 阶段二:Model fallback 到下一模型
- 切换前先做有界同模型恢复
⚙️ 流程拆解
STEP 1解析会话状态
STEP 2构建候选链
STEP 3试当前 provider
STEP 4失败推进候选
STEP 5用 fallback 应答
STEP 6耗尽报终态失败
🔗 涉及的概念与玩家
- OpenClaw产品
- OpenAI公司
- Daybreak Blue模型
- Codex产品
- auth-profile rotation方法
- model fallback方法
- cyber-policy refusal概念
- ChatGPT产品
- OpenClaw—实现→auth-profile rotation
- OpenClaw—实现→model fallback
- OpenClaw—重试→Daybreak Blue
- Daybreak Blue—属于→OpenAI
- OpenClaw—兼容→Codex
- cyber-policy refusal—来自→OpenAI
- 分层故障处理:先在同一提供商内轮换认证凭据,再按 fallbacks 列表切换到备用模型。含义:Agent harness 应区分凭据级和模型级故障,避免过早切换提供商。
- 用户显式选择不触发 fallback:用户通过 /model 等设置的模型是严格选择,失败时报错而非静默回退。含义:prompt 设计需明确区分“用户指定”与“系统自动选择”,尊重用户意图。
- 可选认证失败跳过缓存:通过
OPENCLAW_FALLBACK_SKIP_TTL_MS启用后,非主候选模型因认证失败会被临时跳过,避免重复重试。含义:为减少延迟和成本,可引入带 TTL 的失败缓存,但主模型永不跳过以暴露真实错误。
🕸 顺着图谱继续读
- openclaw v2026.9.2 — GPT2026-09-05 · 共同涉及 OpenClaw、OpenAI、ChatGPT
- Retry policy · OpenClaw — 重试策略如何避免重复操作并保证消息顺序?2026-08-17 · 共同涉及 OpenClaw、OpenAI、ChatGPT
- Claude Cowork and chat are now one Claude — Anthropic 把 Claude Cowork 与聊天合并为单一 Claud2026-09-16 · 共同涉及 OpenAI、Codex、ChatGPT
- opencode v1.18.19 — 新增 AI Gateway 直连,修复多项兼容性与计费问题2026-08-20 · 共同涉及 OpenAI、Codex、ChatGPT