openclaw-auto-doctor

# OpenClaw Auto-Doctor

作为 OpenClaw 的智能运维助手，本 skill 能够自动监控 OpenClaw 日志、诊断错误、搜索解决方案并尝试自动修复。

## 触发条件

当用户请求以下操作时使用此 skill：
- "监控 OpenClaw 日志"
- "启动 OpenClaw 医生"
- "分析 OpenClaw 错误"
- "诊断 OpenClaw 问题"
- "检查 OpenClaw 状态"
- 或者直接提及 OpenClaw 相关的错误/问题

## 核心功能

### 1. 日志监控

**启动监控**：
```
使用 tail -f 命令实时监控指定的 OpenClaw 日志文件
```

**配置日志路径**：
首次使用时，需要用户指定 OpenClaw 的日志文件路径，例如：
- `~/openclaw/logs/claude-code.log`
- `~/openclaw/logs/error.log`
- 或其他用户指定的路径

### 2. 错误识别与解析

能够识别以下类型的错误：
- JavaScript/TypeScript 异常（Error, TypeError, ReferenceError 等）
- Python 异常（Traceback）
- Go panic
- 系统错误（ENOENT, EACCES, ECONNREFUSED 等）
- HTTP 错误（4xx, 5xx）
- 自定义 OpenClaw 错误码

**提取信息**：
- 错误类型和消息
- 错误堆栈跟踪
- 发生位置（文件、行号、列号）
- 时间戳
- 上下文代码

### 3. 智能搜索解决方案

按优先级搜索以下渠道：

1. **本地解决方案库** - 已知的错误和修复方案
2. **GitHub Issues** - 使用 GitHub API 搜索相关 issues
   ```
   搜索关键词：错误消息 + OpenClaw
   筛选：state:closed（已解决）
   ```
3. **GitHub Pull Requests** - 搜索已合并的修复
4. **OpenClaw 社区** - 搜索社区讨论
5. **官方文档** - 搜索故障排除文档

### 4. 自动修复

**修复策略**：

| 错误类型 | 修复方式 |
|---------|---------|
| 依赖缺失 | 执行 npm install / pip install 等 |
| 配置错误 | 修改配置文件 |
| 权限问题 | 修复文件/目录权限 |
| 服务未启动 | 启动相关服务 |
| 代码 bug | 生成补丁文件 |

**安全机制**：
- 修复前创建备份
- 修复后验证结果
- 失败时回滚

### 5. 自动创建 Pull Request

当无法自动修复时：
1. 分析错误根因
2. 生成修复代码
3. Fork OpenClaw 仓库
4. 创建分支并提交更改
5. 创建 Pull Request 并关联相关 Issue

## 工作流程

### 完整工作流

```
1. 接收用户请求或检测到新错误
         │
         ▼
2. 解析错误信息（类型、消息、堆栈）
         │
         ▼
3. 检查本地解决方案库
    ├── 找到方案 → 应用修复 → 验证 → 通知用户
    │...

# OpenClaw Auto-Doctor

自动监控 OpenClaw 日志、诊断错误、搜索解决方案并自动修复问题的智能运维助手。

## 功能特性

- **实时日志监控** - 自动监控 OpenClaw 运行日志，实时捕获错误
- **智能错误解析** - 识别 JavaScript、Python、Go 等多种错误类型
- **多渠道搜索** - 在 GitHub Issues、社区论坛、官方文档中搜索解决方案
- **自动修复** - 对已知错误自动应用修复方案
- **自动创建 PR** - 无法自动修复时，自动生成修复代码并提交 Pull Request

## 安装

```bash
clawhub install openclaw-auto-doctor
```

## 配置

首次使用需要指定 OpenClaw 日志路径：

```yaml
# ~/.claude/openclaw-doctor.yaml
openclaw:
  log_paths:
    - ~/.openclaw/logs/gateway.log
    - ~/.openclaw/logs/gateway.err.log
```

## 使用方法

### 启动日志监控

```
请监控 OpenClaw 日志
```

### 分析错误

```
分析 OpenClaw 错误
```

### 检查状态

```
检查 OpenClaw 状态
```

## 支持的错误类型

| 错误类型 | 说明 |
|---------|------|
| MODULE_NOT_FOUND | 依赖模块缺失 |
| API Key 错误 | 认证配置问题 |
| JSON 解析错误 | 配置文件语法错误 |
| 连接错误 | 服务无法访问 |
| TypeError | JavaScript 类型错误 |
| Traceback | Python 异常 |

## 工作流程

```
检测错误 → 解析错误信息 → 搜索解决方案 → 应用修复 → 创建 PR
```

## 安全机制

- 修复前自动创建备份
- 不确定时请求用户确认
- 所有操作记录详细日志

## 相关链接

- [OpenClaw 官网](https://openclaude.ai)
- [OpenClaw GitHub](https://github.com/openclaudeai/openclaude)
- [ClawHub](https://clawhub.dev)

## 许可证

MIT License