SkillHub

model-failover-guard

v1.0.0

自动监控模型健康状态，智能切换主备模型以维持稳定性，并在可能时自动恢复。

Sourced from ClawHub, Authored by BovmantH

Installation

Please help me install the skill `model-failover-guard` from SkillHub official store. npx skills add BovmantH/model-failover-guard

OpenClaw Model Failover Guard

Automatic model failover + failback guard for OpenClaw.

Description

When your primary model becomes unstable, this guard can switch to an available fallback model automatically, then switch back to the primary after stability is restored.

Features

  • Monitor model health on an interval
  • If primary fails N times consecutively → failover
  • Fallback is selected from all configured models
  • Supports preferred fallback provider
  • After fallback is stable for N checks → try failback
  • If failback test fails → revert to fallback immediately

Install

npx skills add BovmantH/openclaw-model-failover-guard --skill model-failover-guard

Usage

# Run once
python3 skills/model-failover-guard/scripts/failover.py once

# Run as daemon
python3 skills/model-failover-guard/scripts/failover.py loop

Configuration

Copy skills/model-failover-guard/config.example.json to config.json and adjust settings.

Key Description
primaryModel Primary model to monitor
failThreshold Consecutive failures before failover
recoverThreshold Stable checks before failback
checkIntervalSec Health check interval (seconds)

Author

  • Owner: BovmantH
  • Version: 1.0.0

License

MIT