OpenClaw fallback配置需通过YAML静态定义主备模型链并加入白名单，或用JSON实现Agent级独立fallback，命令行动态添加仅追加至openclaw.json；验证须模拟主模型宕机并观察日志切换记录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当OpenClaw调用主模型时遭遇超时、HTTP 5xx错误或连续三次内容校验失败，服务会立即中断——你必须提前配置fallback策略，否则所有AI任务将卡死在空白响应里。
用YAML文件静态定义fallback链
这是最稳定、最易审计的配置方式，适用于生产环境长期运行的网关实例。
1、打开配置文件：~/.openclaw/config.yaml
2、定位到agents.defaults.model节点，在其下设置primary字段，例如："qwen3:32b"；同时添加fallbacks列表，按优先级从高到低填写备用模型ID，如：
- "qwen2.5:14b"
- "glm5.0:7b"
- "gpt-4-turbo"
3、在agents.defaults.models节点下显式声明白名单，确保所有fallback模型都在其中。系统只会尝试已部署且在白名单里的模型，其他条目直接跳过。
4、保存后执行openclaw gateway restart --verbose，观察日志中是否出现[Fallback] primary model timeout, switching to backup字样——没有这行输出，说明配置未加载成功。
通过命令行动态添加降级模型
适合快速验证或临时补充备用选项，不修改任何配置文件，操作后立即生效。
方法一：为默认文本模型添加fallbackopenclaw models fallbacks add zhipu/glm-5
方法二：指定完整厂商前缀避免歧义（推荐）openclaw models fallbacks add alibaba-cloud/qwen3-coder-plus
注意：该命令仅向openclaw.json的models.fallbackModels数组追加项，不会覆盖已有配置。若需清空重置，须手动编辑JSON文件。
用JSON配置实现Agent级独立fallback
当你有多个Agent并行运行，且每个都需要专属主备链时，全局fallback会互相干扰，此时必须使用此方式。
第一步：打开~/.openclaw/openclaw.json
第二步：找到目标Agent（如"id": "report-gen"），在其model对象内写入："primary": "moonshot/kimi-k2.5","fallbacks": ["zhipu/glm-5", "ollama/llama3-8b"]
第三步：确认该Agent的"default": true，否则fallback逻辑不会激活。
第四步：【必须执行】openclaw agent reload report-gen，仅重启该实例，不影响其他Agent运行。
命令行触发fallback机制验证
不改配置、不重启服务，用一次真实故障模拟检验fallback是否真正就绪。
1、运行ollama ps查出主模型进程PID
2、执行kill -9 [PID]强制终止服务
3、立刻向OpenClaw发送一条测试消息，比如“今天天气如何”
4、若3秒内收到正常回复，且日志显示切换到了备用模型ID，说明fallback链通路完整；若超时或报错，则检查白名单与网络连通性。
