← Back to Skills Marketplace
369
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install model-failover-guard
Description
Automatically monitors model health and switches between primary and fallback models to maintain stability and recover when possible.
Usage Guidance
This skill appears to do what it claims, but review and take these precautions before enabling it: 1) Backup your OpenClaw config (~/.openclaw/openclaw.json) so you can restore the primary model if needed. 2) Verify the 'openclaw' CLI is the expected binary on PATH (the script calls it to test models and restart the gateway). 3) Inspect config.json (copy of config.example.json) to confirm preferred/excluded providers and candidate models — ensure no unexpected provider IDs appear that could point to untrusted endpoints. 4) Run the script once in a non-production environment (python3 .../failover.py once) to observe behavior and logs (~/.openclaw/failover.log) before enabling a loop or systemd service. 5) If you have strict process-control policies, note the script restarts the gateway; plan for maintenance windows. Overall the code is coherent and limited to the stated purpose; use the normal operational precautions above.
Capability Analysis
Type: OpenClaw Skill
Name: model-failover-guard
Version: 1.0.0
The skill bundle provides an automatic model failover and failback guard for OpenClaw. The core Python script (`failover.py`) uses `subprocess.run` to execute `openclaw` commands with fixed arguments, preventing shell injection. It modifies the `~/.openclaw/openclaw.json` configuration and logs to `~/.openclaw/failover.log`, which is consistent with its stated purpose. While paths for configuration, state, and logs are configurable via `config.json`, this is a design feature for flexibility rather than an inherent vulnerability, as it requires prior compromise of the local `config.json`. The markdown files (`SKILL.md`, `README.md`) clearly describe the skill's functionality and do not contain any prompt injection attempts or instructions for malicious behavior. The '安全边界' section in `skills/model-failover-guard/SKILL.md` explicitly states benign actions.
Capability Assessment
Purpose & Capability
Name/description (model failover) align with required actions: reading/writing ~/.openclaw/openclaw.json, enumerating configured models, testing models via the 'openclaw' CLI, and restarting the gateway. All requested resources and behaviors are coherent with implementing a failover guard.
Instruction Scope
SKILL.md and the runtime script limit actions to model health checking, switching the primary model in OpenClaw config, saving state/logs under ~/.openclaw, and restarting the gateway. The script does not access unrelated system paths, environment secrets, or external network endpoints beyond invoking the local 'openclaw' CLI.
Install Mechanism
This is instruction-only in the registry (no automated install spec). README suggests installing via 'npx skills add ...' from GitHub, but nothing is downloaded/installed automatically by the skill itself in the package contents. Included Python script is local and executed by the user. No high-risk external downloads or obscure URLs are used in the provided files.
Credentials
The skill requests no environment variables, credentials, or unrelated config paths. It reads/writes OpenClaw's config and state/log files under the user's home directory — appropriate and necessary for its function. No broad or unrelated secrets are requested.
Persistence & Privilege
The skill will modify the OpenClaw config (~/.openclaw/openclaw.json), write state and logs (~/.openclaw/*), and restart the OpenClaw gateway via 'openclaw gateway restart'. These behaviors are expected for a failover tool but do require filesystem and process-control privileges (ability to write the config and restart the service). 'always' is false and the skill does not attempt to alter other skills' configs.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install model-failover-guard - After installation, invoke the skill by name or use
/model-failover-guard - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Automatic model switching when primary fails
Metadata
Frequently Asked Questions
What is Model Failover Guard?
Automatically monitors model health and switches between primary and fallback models to maintain stability and recover when possible. It is an AI Agent Skill for Claude Code / OpenClaw, with 369 downloads so far.
How do I install Model Failover Guard?
Run "/install model-failover-guard" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Model Failover Guard free?
Yes, Model Failover Guard is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Model Failover Guard support?
Model Failover Guard is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Model Failover Guard?
It is built and maintained by BovmantH (@bovmanth); the current version is v1.0.0.
More Skills