back
loading skill details...
AI-powered auto-repair system for OpenClaw with iflow integration. Automatically diagnose and fix crashes, config errors, model issues. Falls back to iflow-h...
---
id: openclaw-iflow-doctor
name: OpenClaw iFlow Doctor
version: 1.1.0
description: AI-powered auto-repair system for OpenClaw with iflow integration. Automatically diagnose and fix crashes, config errors, model issues. Falls back to iflow-helper when needed.
changelog: |
## [1.1.0] - 2026-03-01
### Bug Fixes
- Fix: watchdog.py --daemon not working (daemon thread exits with main)
- Fix: Tilde (~) path expansion in config files
- Fix: Desktop directory not found on servers
- Add: systemd service for auto-start on boot
- Add: install-systemd.sh script for easy installation
### Improvements
- Use absolute paths throughout the codebase
- Cross-platform support (Linux/Windows/macOS)
- Better error handling and logging
### Compatibility
- OpenClaw: 2026.2.x+
- Python: 3.8+
- OS: Linux (systemd), Windows, macOS
metadata:
{
"openclaw": {
"requires": {
"bins": ["python3", "openclaw"],
"skills": ["iflow-helper"]
},
"optional": {
"skills": ["iflow-helper"],
"description": "for complex repairs requiring manual intervention"
},
"triggers": ["error", "startup_failure", "health_check"]
}
}
---
# OpenClaw Self-Healing V2 - 智能自我修复系统
> **自动诊断和修复 OpenClaw 崩溃、配置错误、模型问题。当自动修复失败时，无缝调用 iflow-helper 协助。**
## 核心能力
### ✅ 自动修复能力
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. 双击"打开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,
"enable_bat_generation": true,
"enable_iflow_integration": true,
"similarity_threshold": 0.7,
"max_bat_files": 2,
"iflow_helper_skill": "iflow-helper",
"language": "auto"
}
```
### 配置项说明
| 配置项 | 默认值 | 说明 |
|--------|--------|------|
| auto_heal | true | 是否自动尝试修复 |
| enable_bat_generation | true | 无法修复时是否生成 BAT |
| enable_iflow_integration | true | 是否启用 iflow-helper 调用 |
| similarity_threshold | 0.7 | 案例匹配相似度阈值 |
| max_bat_files | 2 | 最多生成 BAT 文件数 |
| language | auto | 报告语言（auto/zh/en） |
## 案例库
### 预置案例 (10个)
1. **CASE-001**: Memory Search Function Broken
- 症状: 记忆搜索失败，身份识别损坏
- 自动修复: ✓ 重置记忆索引
2. **CASE-002**: Gateway Service Not Starting
- 症状: 网关无法启动或崩溃
- 自动修复: ✓ 重启服务
3. **CASE-003**: API Rate Limit Exceeded
- 症状: API 额度超限，429 错误
- 自动修复: ✗ 需手动充值/iflow 协助
4. **CASE-004**: Agent Spawn Failed
- 症状: Agent 调用失败
- 自动修复: ✓ 重新加载
5. **CASE-005**: Channel Configuration Error
- 症状: Channel 配置错误
- 自动修复: ✓ 重置配置
6. **CASE-006**: Model Provider Connection Failed
- 症状: 模型连接失败
- 自动修复: ✓ 切换到备用模型
7. **CASE-007**: Configuration File Corrupted
- 症状: 配置文件损坏
- 自动修复: ✓ 从备份恢复
8. **CASE-008**: Multiple Agents Conflict
- 症状: 多 Agent 冲突
- 自动修复: ✓ 重新加载配置
9. **CASE-009**: Permission Denied Errors
- 症状: 权限拒绝错误
- 自动修复: ✓ 修复权限
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-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 │
└──────────────────────────────────────────┘
```
## 故障排除
### 技能无法加载
```bash
# 检查 Python 版本
python3 --version # 需要 3.8+
# 检查文件权限
ls -la ~/.openclaw/skills/openclaw-iflow-doctor/
# 重新安装
openclaw skills reinstall openclaw-iflow-doctor
```
### 自动修复不触发
```bash
# 检查配置
openclaw skills config openclaw-iflow-doctor --get auto_heal
# 手动触发测试
openclaw skills run openclaw-iflow-doctor --test-trigger
```
### iflow-helper 调用失败
```bash
# 检查 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. 启用自动修复
首次安装后启用自动模式：
```bash
openclaw skills config openclaw-iflow-doctor --set auto_heal=true
```
### 2. 定期查看统计
每周查看修复统计，了解系统稳定性：
```bash
openclaw skills run openclaw-iflow-doctor --stats
```
### 3. 积累案例
遇到新问题并成功修复后，添加到案例库：
```bash
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 一起安装，获得最佳体验！don't have the plugin yet? install it then click "run inline in claude" again.