ClawBot遇AI失效时启动四层兜底：一、CLI本地故障转移；二、双Provider容错链路；三、Skill级本地响应；四、自愈看门狗修复。各机制按优先级协同保障服务连续性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当ClawBot在执行任务过程中遇到AI模型无法生成有效回复的情况，例如返回空内容、格式错误、超时或触发安全拦截，系统需立即启动预设的失败兜底机制。以下是应对该问题的具体操作路径：
一、启用CLI后端自动故障转移
该方法利用本地已安装的AI命令行工具作为云API失效时的备用通道，不依赖网络、无需API Key，确保文本类任务持续可用。
1、确认本地已安装Claude Code CLI或Codex CLI，并可通过终端直接调用。
2、编辑OpenClaw配置文件~/.openclaw/config.json，在agents.defaults.model节点下设置fallbacks数组。
3、将云端模型设为primary，例如"anthropic/claude-opus-4-6"，并在fallbacks中填入"claude-cli/opus-4.6"等本地CLI模型标识。
4、配置fallbackTriggers，明确指定触发条件为"timeout"、"rate_limit"或"empty_response"。
5、执行openclaw gateway restart使配置生效。
二、配置双Provider容错链路
通过在同一请求链中串联多个服务商Provider，实现跨平台级失败接管，避免单点依赖导致的永久性中断。
1、使用clawdbot config set命令为不同服务商分别配置独立的API Key与baseUrl，例如MiniMax国内区与OpenAI。
2、在模型引用处采用provider/model格式，如minimax/abab6.5s和openai/gpt-5.4。
3、在config.json中定义model.fallbacks列表，按优先级顺序排列多个provider/model组合。
4、确保各Provider插件均已启用并完成认证，可通过openclaw provider list验证状态。
5、发送测试请求，观察日志中是否出现"failover triggered to openai/gpt-5.4"类提示。
OpenClaw 部署前安全检查清单：聚焦合规导向的部署前检查，覆盖防火墙、SSH、API 密钥管理、数据出境合规及多场景验证。清单式检查，逐项打勾并生成报告，适用于个人 Mac、VPS、Docker及企业部署。
三、注入本地Skill级响应兜底
当AI层完全不可用时，由预注册的本地Skill接管输出控制权，返回结构化提示、历史缓存摘要或静态应答模板，防止界面卡死或空白。
1、编写一个Python Skill脚本，命名为fallback_responder.py，内容包含默认回复逻辑与上下文检查函数。
2、将该脚本放入ClawBot的skills目录，并在skills.yaml中声明其触发条件为on_ai_failure: true。
3、在Skill内调用clawbot.memory.get_recent(3)获取最近三条对话记录，用于生成连贯的过渡回应。
4、使用clawbot.ui.notify()向Dashboard推送状态提示，例如"AI暂不可用，已切换至本地响应模式"。
5、重启网关服务，验证在模拟AI断连场景下是否能稳定输出Skill定义的兜底内容。
四、激活自愈看门狗修复流程
针对因底层服务异常（如gateway进程僵死、RPC接口无响应）引发的AI不可用，需调用fix-my-claw自愈模块执行诊断与恢复。
1、确认系统已安装fix-my-claw工具，并具备执行openclaw doctor和openclaw gateway restart权限。
2、运行fix-my-claw --watch --interval 30启动守护进程，监听gateway health与status --require-rpc返回结果。
3、当连续两次探测失败时，自动执行官方修复命令序列，包括--repair --non-interactive参数强制跳过交互。
4、若官方命令返回非零退出码，则启动AI兜底诊断流程，调用本地vLLM模型分析/var/log/openclaw/gateway.log最新片段。
5、所有操作记录被归档至/var/lib/fix-my-claw/incidents/下的时间戳命名事故包中。
