Skills model-failover-guard

自动模型故障切换守护。当主模型连续失败时自动切换到可用兜底模型，稳定后自动尝试切回主模型。适用于保证 OpenClaw 服务连续性。

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bovmanth/model-failover-guard/skills/model-failover-guard" ~/.claude/skills/clawdbot-skills-model-failover-guard-4f9aed && rm -rf "$T"

manifest: skills/bovmanth/model-failover-guard/skills/model-failover-guard/SKILL.md

source content

Model Failover Guard

给 OpenClaw 提供"主模型故障自动切换 + 恢复自动切回"。

通用逻辑

从用户
```
~/.openclaw/openclaw.json
```
读取当前默认主模型（或使用
```
config.json
```
指定
```
primaryModel
```
）
主模型连续失败达到阈值后，从"所有已配置模型"里选择可用兜底
兜底候选按
```
preferredFallbackProvider
```
优先，其余模型按字典序
在兜底稳定运行达到阈值后，尝试切回主模型
切回失败则立即回退到兜底，避免抖动

配置文件

复制

config.example.json

为

config.json

并按需修改：

```
primaryModel
```
: 可空；空则自动使用 openclaw 当前默认主模型
```
preferredFallbackProvider
```
: 可空；可指定你偏好的 fallback provider
```
excludedProviders
```
: 不参与兜底的 provider 列表
```
failThreshold
```
: 故障切换阈值（默认 3）
```
recoverThreshold
```
: 切回阈值（默认 3）
```
checkIntervalSec
```
: 检查间隔（默认 300 秒）

文件

守护脚本：
```
{baseDir}/scripts/failover.py
```
示例配置：
```
{baseDir}/config.example.json
```
运行状态：
```
~/.openclaw/failover-state.json
```
日志：
```
~/.openclaw/failover.log
```

常用操作

单次检查（不常驻）

python3 {baseDir}/scripts/failover.py once

常驻运行（前台）

python3 {baseDir}/scripts/failover.py loop

查看日志

tail -n 50 ~/.openclaw/failover.log

安全边界

不会删除文件
仅在触发条件满足时改
```
agents.defaults.model.primary
```
并重启 gateway
所有切换行为写日志，便于审计