OpenClaw Self-Healing V2 - 智能自我修复系统

自动诊断和修复 OpenClaw 崩溃、配置错误、模型问题。当自动修复失败时，无缝调用 iflow-helper 协助。

核心能力

✅ 自动修复能力

1. 1. 智能问题分类 - 自动识别 8 种问题类型
2. 案例库匹配 - 10+ 预置常见问题和解决方案
3. 历史记录复用 - 自动应用成功的历史修复方案
4. 配置自动检查 - 启动前自动验证配置有效性
5. 进程监控 - 崩溃后自动重启并修复

🔗 与 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 (用于复杂修复)

安装步骤

bash

方式 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

启用自动修复

bash

启用自动模式（推荐）

openclaw skills config openclaw-iflow-doctor --set auto_heal=true

启用监控模式

openclaw skills run openclaw-iflow-doctor --watchdog

使用方法

1. 全自动模式（推荐）

启用后无需干预，自动处理所有错误：

bash

启用自动修复

openclaw skills enable openclaw-iflow-doctor --auto

后续所有错误自动处理

简单问题自动修复

复杂问题生成 BAT 文件并提示调用 iflow

2. 手动诊断

bash

诊断特定问题

openclaw heal Gateway service crashed

或完整命令

openclaw skills run openclaw-iflow-doctor --diagnose 错误描述

3. 配置检查

bash

启动前检查配置

openclaw skills run openclaw-iflow-doctor --check-config

输出示例:

✓ Config file exists

✓ JSON syntax valid

✓ Required fields present

✓ Model connectivity OK

4. 查看统计

bash
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

用户操作:

1. 1. 双击打开iFlow寻求帮助.bat
2. 在 iflow 中描述问题
3. iflow 协助完成修复
4. 修复记录自动同步

流程 3: 启动配置检查

bash
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

json
{
version: 2.0.0,
auto_heal: true,
enablebatgeneration: true,
enableiflowintegration: true,
similarity_threshold: 0.7,
maxbatfiles: 2,
iflowhelperskill: iflow-helper,
language: auto
}

配置项说明

配置项	默认值	说明
autoheal	true	是否自动尝试修复
enablebat_generation

true | 无法修复时是否生成 BAT | | enableiflowintegration | true | 是否启用 iflow-helper 调用 | | similarity_threshold | 0.7 | 案例匹配相似度阈值 | | maxbatfiles | 2 | 最多生成 BAT 文件数 | | language | auto | 报告语言（auto/zh/en） |

案例库

预置案例 (10个)

1. 1. CASE-001: Memory Search Function Broken

- 症状: 记忆搜索失败，身份识别损坏 - 自动修复: ✓ 重置记忆索引

1. 2. CASE-002: Gateway Service Not Starting

- 症状: 网关无法启动或崩溃 - 自动修复: ✓ 重启服务

1. 3. CASE-003: API Rate Limit Exceeded

- 症状: API 额度超限，429 错误 - 自动修复: ✗ 需手动充值/iflow 协助

1. 4. CASE-004: Agent Spawn Failed

- 症状: Agent 调用失败 - 自动修复: ✓ 重新加载

1. 5. CASE-005: Channel Configuration Error

- 症状: Channel 配置错误 - 自动修复: ✓ 重置配置

1. 6. CASE-006: Model Provider Connection Failed

- 症状: 模型连接失败 - 自动修复: ✓ 切换到备用模型

1. 7. CASE-007: Configuration File Corrupted

- 症状: 配置文件损坏 - 自动修复: ✓ 从备份恢复

1. 8. CASE-008: Multiple Agents Conflict

- 症状: 多 Agent 冲突 - 自动修复: ✓ 重新加载配置

1. 9. CASE-009: Permission Denied Errors

- 症状: 权限拒绝错误 - 自动修复: ✓ 修复权限

1. 10. CASE-010: Log File Too Large

- 症状: 日志文件过大 - 自动修复: ✓ 清理日志

与 iflow-helper 协同

调用关系

yaml

openclaw-iflow-doctor 触发配置

triggers:
on_error:
steps:
- step: 1
name: Self heal attempt
action: auto_repair
timeout: 30s

- step: 2
name: Call iflow-