← 返回 Skills 市场
halfmoon82

Model Failover Doctor

作者 halfmoon82 · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install model-failover-doctor
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /model-failover-doctor 触发
  4. 根据 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.
元数据
Slug model-failover-doctor
版本 1.0.0
许可证
累计安装 4
当前安装数 3
历史版本数 1
常见问题

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。

💬 留言讨论