nexus/wiki/concepts/Model-Fallback.md

title, type, last_updated

title	type	last_updated
Model Fallback	concept	2026-04-10

Definition

Model Fallback 是 OpenClaw 在默认模型不可用时，按优先级自动切换到 fallback 列表中下一个模型的机制。

Triggers

1. 显式 API 不可用: HTTP 503/502（服务宕机）、429（频率限制）、Connection Timeout
2. 隐性 Token 溢出预判: 路由权重配置错误导致切换到更小 context 的模型
3. 配置文件优先级覆盖: Agent/Channel 级别配置覆盖全局配置
4. 负载均衡算法: 随机或轮询分发请求

Sources

• 养虾日记4-一次「context-limit-exceeded」错误排查-我以为是小问题-结果踩了大坑