---
title: "Model Fallback"
type: concept
last_updated: 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」错误排查-我以为是小问题-结果踩了大坑]]