实践openclaw-concepts
Model failover · OpenClaw — OpenClaw 的模型故障转移机制：如何优雅处理 LLM 调用失败
OpenClaw 的模型故障转移机制：如何优雅处理 LLM 调用失败
2026-07-27原文
本文为要点摘要，完整细节以原文为准。
- 分层故障处理：先在同一提供商内轮换认证凭据，再按 fallbacks 列表切换到备用模型。含义：Agent harness 应区分凭据级和模型级故障，避免过早切换提供商。
- 用户显式选择不触发 fallback：用户通过 /model 等设置的模型是严格选择，失败时报错而非静默回退。含义：prompt 设计需明确区分“用户指定”与“系统自动选择”，尊重用户意图。
- 可选认证失败跳过缓存：通过
OPENCLAW_FALLBACK_SKIP_TTL_MS启用后，非主候选模型因认证失败会被临时跳过，避免重复重试。含义：为减少延迟和成本，可引入带 TTL 的失败缓存，但主模型永不跳过以暴露真实错误。