← 返回 Skills 市场
Model Failover Doctor
作者
halfmoon82
· GitHub ↗
· v1.0.0
387
总下载
0
收藏
3
当前安装
1
版本数
在 OpenClaw 中安装
/install model-failover-doctor
功能描述
Diagnose and fix OpenClaw "All models failed" errors by detecting invalid model IDs, provider mismatches, and session fallback issues with optional auto-repair.
安全使用建议
This tool appears to do what it says: diagnose and optionally auto-fix failover config problems by reading/writing OpenClaw config files and restarting the gateway. Before running with --fix (or --restart): 1) run the script with --dry-run first to preview changes; 2) inspect the generated backups under ~/.openclaw/workspace/.lib/.mfd_backups/ so you can restore if needed; 3) manually review the proposed edits to message-injector/index.ts and pools/session files to ensure they match your intended routing/overrides; 4) run fixes during a maintenance window since the gateway restart will affect availability. If you have concerns, you can open the script (model_failover_doctor.py) and the referenced files to verify behavior—there are no network calls or credential exfiltration signs in the provided code.
功能分析
Type: OpenClaw Skill
Name: model-failover-doctor
Version: 1.0.0
The 'model-failover-doctor' skill performs high-risk administrative tasks, including automated patching of TypeScript source code (message-injector/index.ts) using regular expressions and the modification of core configuration files (pools.json, session_model_state.json). It also executes system commands via subprocess to restart the OpenClaw gateway. While these actions are aligned with the stated purpose of fixing model failover issues and the script includes a local backup mechanism, the automated modification of executable code and broad file system access constitute significant operational risks.
能力评估
Purpose & Capability
The name/description match what the code and SKILL.md do: detect and repair failover issues by reading/writing OpenClaw config files (message-injector, pools.json, session_model_state.json) and creating backups. No unrelated credentials or binaries are requested.
Instruction Scope
SKILL.md and the script instruct reading and modifying files under ~/.openclaw (openclaw.json, .lib/pools.json, .lib/session_model_state.json and a message-injector index.ts). It also supports --dry-run, --fix, and --restart. These actions are in-scope for a failover repair tool, but note the script will read potentially sensitive configuration files and will write changes to these files when --fix is used (it creates timestamped backups first).
Install Mechanism
No install spec; the skill is instruction+script only. Nothing is downloaded from external URLs and no new binaries are installed.
Credentials
The skill requests no environment variables or external credentials. It operates on config files within ~/.openclaw, which is appropriate for a tool that repairs gateway/session configuration. Access to those files is necessary for its stated purpose.
Persistence & Privilege
The skill is not always-on and does not request elevated platform privileges. It modifies OpenClaw config/extension files (message-injector, pools/session state) and writes backups in its workspace area; this is expected for a repair tool. Autonomous invocation is allowed by default, but that is the platform norm and not a unique concern here.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install model-failover-doctor - 安装完成后,直接呼叫该 Skill 的名称或使用
/model-failover-doctor触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of "model-failover-doctor" skill:
- Diagnoses and fixes the "All models failed" error in OpenClaw.
- Provides clear trigger conditions for when to use the tool (e.g., identical model ID failures across providers, post-restart message failures, improper manual edits).
- Supports diagnosis-only, auto-fix with gateway restart, and dry-run preview modes.
- Includes a root cause quick reference table for common issues and auto-fix availability.
- Details most frequent root cause (MI-1) and its resolution.
- Ensures all auto-fixes are backed up for safety and manual recovery.
元数据
常见问题
Model Failover Doctor 是什么?
Diagnose and fix OpenClaw "All models failed" errors by detecting invalid model IDs, provider mismatches, and session fallback issues with optional auto-repair. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 387 次。
如何安装 Model Failover Doctor?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install model-failover-doctor」即可一键安装,无需额外配置。
Model Failover Doctor 是免费的吗?
是的,Model Failover Doctor 完全免费(开源免费),可自由下载、安装和使用。
Model Failover Doctor 支持哪些平台?
Model Failover Doctor 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Model Failover Doctor?
由 halfmoon82(@halfmoon82)开发并维护,当前版本 v1.0.0。
推荐 Skills