# Send Openclaw Iflow Doctor to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "openclaw-iflow-doctor", "name": "Openclaw Iflow Doctor", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/kosei-echo/openclaw-iflow-doctor", "canonicalUrl": "https://clawhub.ai/kosei-echo/openclaw-iflow-doctor", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/openclaw-iflow-doctor", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=openclaw-iflow-doctor", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "BUGFIX_STATUS.md", "DOCTOR_QUICK_START.md", "INSTALL_GUIDE.md", "PUBLISH_SUMMARY.md", "README.md", "RELEASE.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/openclaw-iflow-doctor" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/openclaw-iflow-doctor", "downloadUrl": "https://openagent3.xyz/downloads/openclaw-iflow-doctor", "agentUrl": "https://openagent3.xyz/skills/openclaw-iflow-doctor/agent", "manifestUrl": "https://openagent3.xyz/skills/openclaw-iflow-doctor/agent.json", "briefUrl": "https://openagent3.xyz/skills/openclaw-iflow-doctor/agent.md" } } ``` ## Documentation ### OpenClaw Self-Healing V2 - 智能自我修复系统 自动诊断和修复 OpenClaw 崩溃、配置错误、模型问题。当自动修复失败时，无缝调用 iflow-helper 协助。 ### ✅ 自动修复能力 智能问题分类 - 自动识别 8 种问题类型 案例库匹配 - 10+ 预置常见问题和解决方案 历史记录复用 - 自动应用成功的历史修复方案 配置自动检查 - 启动前自动验证配置有效性 进程监控 - 崩溃后自动重启并修复 ### 🔗 与 iflow-helper 集成 自动调用链: OpenClaw 错误 → Self-Healing 尝试修复 ├─ 成功 → 记录并恢复 └─ 失败 → 自动调用 iflow-helper → iflow CLI 协助 触发方式: 自动: 错误发生时自动触发 手动: openclaw heal "错误描述" 检查: openclaw skills run openclaw-iflow-doctor --check ### 问题类型覆盖 类型自动修复需 iflow 协助memory (记忆损坏)✓ 重置索引复杂数据恢复gateway (网关崩溃)✓ 重启服务配置损坏修复config (配置错误)✓ 自动修正手动配置指导network (网络问题)✓ 检查连接代理设置指导api (API 额度/密钥)✗ 额度检查充值/更新密钥agent (Agent 冲突)✓ 重新加载复杂配置调整permission (权限错误)✓ 修复权限系统权限指导install (安装损坏)✗ 备份重装完整重装指导 ### 前提条件 Python: 3.8+ OpenClaw: 已安装并配置 可选: iflow-helper (用于复杂修复) ### 安装步骤 # 方式 1: 从 GitHub 安装 openclaw skills install https://github.com/kosei-echo/openclaw-iflow-doctor # 方式 2: 本地安装 cd ~/.openclaw/skills/ git clone https://github.com/kosei-echo/openclaw-iflow-doctor.git openclaw skills enable openclaw-iflow-doctor ### 启用自动修复 # 启用自动模式（推荐） openclaw skills config openclaw-iflow-doctor --set auto_heal=true # 启用监控模式 openclaw skills run openclaw-iflow-doctor --watchdog ### 1. 全自动模式（推荐） 启用后无需干预，自动处理所有错误： # 启用自动修复 openclaw skills enable openclaw-iflow-doctor --auto # 后续所有错误自动处理 # 简单问题自动修复 # 复杂问题生成 BAT 文件并提示调用 iflow ### 2. 手动诊断 # 诊断特定问题 openclaw heal "Gateway service crashed" # 或完整命令 openclaw skills run openclaw-iflow-doctor --diagnose "错误描述" ### 3. 配置检查 # 启动前检查配置 openclaw skills run openclaw-iflow-doctor --check-config # 输出示例: # ✓ Config file exists # ✓ JSON syntax valid # ✓ Required fields present # ✓ Model connectivity OK ### 4. 查看统计 openclaw skills run openclaw-iflow-doctor --stats # 输出: # Total cases: 10 # Total records: 25 # Auto-fixed: 18 # Iflow-assisted: 7 # Success rate: 92% ### 流程 1: 自动修复成功 [系统] OpenClaw gateway crashed [系统] Self-Healing triggered [系统] Analyzing: Gateway crash detected [系统] Searching case library... Match found: CASE-002 [系统] Applying solution: Restart gateway service [系统] ✓ Gateway restarted successfully [系统] Report: openclaw修复报告_20240227.txt [系统] Record saved to memory 用户操作: 查看报告，无需干预 ### 流程 2: 自动修复失败 → 调用 iflow [系统] OpenClaw config error [系统] Self-Healing triggered [系统] Analyzing: Complex config corruption [系统] Searching case library... No match [系统] Searching records... No previous fix [系统] ✗ Cannot auto-fix [系统] Generated: openclaw诊断书_20240227.txt [系统] Generated: 重新安装openclaw.bat [系统] Generated: 打开iFlow寻求帮助.bat [系统] [系统] 💡 Suggestion: Double-click BAT files on desktop [系统] Or run: openclaw skills run iflow-helper 用户操作: 双击"打开iFlow寻求帮助.bat" 在 iflow 中描述问题 iflow 协助完成修复 修复记录自动同步 ### 流程 3: 启动配置检查 openclaw gateway start [系统] Config check running... [系统] ⚠ Missing field: models.default [系统] Attempting auto-fix... [系统] ✓ Fixed: Set default model to deepseek-chat [系统] Starting gateway... [系统] ✓ Gateway started ### 技能配置 位置: ~/.openclaw/skills/openclaw-iflow-doctor/config.json { "version": "2.0.0", "auto_heal": true, "enable_bat_generation": true, "enable_iflow_integration": true, "similarity_threshold": 0.7, "max_bat_files": 2, "iflow_helper_skill": "iflow-helper", "language": "auto" } ### 配置项说明 配置项默认值说明auto_healtrue是否自动尝试修复enable_bat_generationtrue无法修复时是否生成 BATenable_iflow_integrationtrue是否启用 iflow-helper 调用similarity_threshold0.7案例匹配相似度阈值max_bat_files2最多生成 BAT 文件数languageauto报告语言（auto/zh/en） ### 预置案例 (10个) CASE-001: Memory Search Function Broken 症状: 记忆搜索失败，身份识别损坏 自动修复: ✓ 重置记忆索引 CASE-002: Gateway Service Not Starting 症状: 网关无法启动或崩溃 自动修复: ✓ 重启服务 CASE-003: API Rate Limit Exceeded 症状: API 额度超限，429 错误 自动修复: ✗ 需手动充值/iflow 协助 CASE-004: Agent Spawn Failed 症状: Agent 调用失败 自动修复: ✓ 重新加载 CASE-005: Channel Configuration Error 症状: Channel 配置错误 自动修复: ✓ 重置配置 CASE-006: Model Provider Connection Failed 症状: 模型连接失败 自动修复: ✓ 切换到备用模型 CASE-007: Configuration File Corrupted 症状: 配置文件损坏 自动修复: ✓ 从备份恢复 CASE-008: Multiple Agents Conflict 症状: 多 Agent 冲突 自动修复: ✓ 重新加载配置 CASE-009: Permission Denied Errors 症状: 权限拒绝错误 自动修复: ✓ 修复权限 CASE-010: Log File Too Large 症状: 日志文件过大 自动修复: ✓ 清理日志 ### 调用关系 # openclaw-iflow-doctor 触发配置 triggers: on_error: steps: - step: 1 name: "Self heal attempt" action: "auto_repair" timeout: 30s - step: 2 name: "Call iflow-helper" condition: "step_1.failed" skill: "iflow-helper" args: task: "diagnose_and_repair" context: "{{error_description}}" use_multimodal: true ### 数据流 ┌─────────────────────────────────────────────────────────┐ │ OpenClaw Error │ └────────┬────────────────────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────────┐ │ Self-Healing Analysis │ │ - Search cases.json (10 built-in cases) │ │ - Search records.json (historical fixes) │ └────────┬────────────────────────────────────────────────┘ │ ┌────┴────┐ │ │ ▼ ▼ ┌──────┐ ┌──────────────────────────────────────────┐ │ Auto │ │ Generate Report + BAT │ │ Fix │ │ - 重新安装openclaw.bat │ │ │ │ - 打开iFlow寻求帮助.bat │ └──┬───┘ └──────────────┬───────────────────────────┘ │ │ ▼ ▼ ┌──────┐ ┌──────────────────────────────────────────┐ │Record│ │ Call iflow-helper │ │Success│ │ - Activate iflow CLI │ └──────┘ │ - User describes problem │ │ - iflow diagnoses │ │ - iflow fixes │ └──────────────┬───────────────────────────┘ │ ▼ ┌──────────────────────────────────────────┐ │ Sync to Memory │ │ - Save to records.json │ │ - Optional: sync to iflow memory │ │ - Update cases.json if reusable │ └──────────────────────────────────────────┘ ### 技能无法加载 # 检查 Python 版本 python3 --version # 需要 3.8+ # 检查文件权限 ls -la ~/.openclaw/skills/openclaw-iflow-doctor/ # 重新安装 openclaw skills reinstall openclaw-iflow-doctor ### 自动修复不触发 # 检查配置 openclaw skills config openclaw-iflow-doctor --get auto_heal # 手动触发测试 openclaw skills run openclaw-iflow-doctor --test-trigger ### iflow-helper 调用失败 # 检查 iflow-helper 是否安装 openclaw skills list | grep iflow-helper # 手动安装 openclaw skills install iflow-helper # 禁用 iflow 集成（纯本地模式） openclaw skills config openclaw-iflow-doctor --set enable_iflow_integration=false ### 1. 启用自动修复 首次安装后启用自动模式： openclaw skills config openclaw-iflow-doctor --set auto_heal=true ### 2. 定期查看统计 每周查看修复统计，了解系统稳定性： openclaw skills run openclaw-iflow-doctor --stats ### 3. 积累案例 遇到新问题并成功修复后，添加到案例库： openclaw skills run openclaw-iflow-doctor --add-case ### 4. 配合 iflow 使用 复杂问题不要硬抗，及时调用 iflow： 双击生成的 BAT 文件 或在终端运行 openclaw skills run iflow-helper ### 相关链接 iflow-helper: ~/.openclaw/workspace/skills/iflow-helper/ 案例库: ~/.openclaw/skills/openclaw-iflow-doctor/cases.json 配置: ~/.openclaw/skills/openclaw-iflow-doctor/config.json ### 总结 OpenClaw Self-Healing V2 提供： ✅ 自动修复 - 80% 常见问题自动解决 ✅ 智能降级 - 复杂问题无缝转交 iflow ✅ 记忆积累 - 修复经验自动沉淀 ✅ 零配置 - 安装即用，开箱即用 ✅ 双向集成 - 与 iflow-helper 完美配合 建议: 与 iflow-helper 一起安装，获得最佳体验！ ## Trust - Source: tencent - Verification: Indexed source record - Publisher: kosei-echo - Version: 1.1.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/openclaw-iflow-doctor) - [Send to Agent page](https://openagent3.xyz/skills/openclaw-iflow-doctor/agent) - [JSON manifest](https://openagent3.xyz/skills/openclaw-iflow-doctor/agent.json) - [Markdown brief](https://openagent3.xyz/skills/openclaw-iflow-doctor/agent.md) - [Download page](https://openagent3.xyz/downloads/openclaw-iflow-doctor)