智能配置诊断工具，帮助排查配置问题、环境变量、服务状态、文件搜索等。触发词：为什么不能、找不到配置、排查问题、诊断一下。
一句话描述：当用户遇到「为什么不能」「找不到配置」「不工作」等问题时，自动诊断并给出解决建议。
用户问题描述 → 关键词识别 → 执行诊断 → 返回结果 + 建议
L1: 快速检查（环境变量、文件存在性）
L2: 深度检查（网络连接、权限验证）
L3: 修复建议（具体操作步骤）
| 诊断类型 | 检查项 | 触发关键词 |
|---|---|---|
| 邮件诊断 | EMAIL_* 环境变量、IMAP/SMTP 连接 | 邮件、邮箱、mail、email |
| API 诊断 |
config-diagnose/
├── SKILL.md # 本文件
├── scripts/
│ ├── diagnose.sh # 主诊断脚本
│ └── full-diagnose.sh # 完整系统诊断
└── templates/
└── report.md # 诊断报告模板
用户：为什么我的邮件读取不了？
AI：让我诊断一下邮件配置...
[调用 diagnose.sh email]
结果：EMAIL_PASSWORD 未设置
建议：请设置应用专用密码...
用户：为什么找不到 outlook-cli 的 token.json？
AI：让我帮你搜索...
[调用 diagnose.sh file token.json]
结果：文件不存在
建议：需要先运行 outlook-cli login 进行授权
用户描述问题
│
▼
┌────────────────┐
│ 关键词识别 │
│ 确定诊断类型 │
└────────────────┘
│
▼
┌────────────────┐
│ 执行检查脚本 │
│ - 环境变量 │
│ - 文件搜索 │
│ - 网络测试 │
│ - 服务状态 │
└────────────────┘
│
▼
┌────────────────┐
│ 分析结果 │
│ 生成诊断报告 │
└────────────────┘
│
▼
┌────────────────┐
│ 提供解决建议 │
│ 可执行命令 │
└────────────────┘
| 问题 | 诊断结果 | 解决建议 |
|---|---|---|
| EMAILADDRESS 未设置 | ✗ 未设置 | export EMAILADDRESS=your@email.com |
| EMAIL_PASSWORD 未设置 |
| 问题 | 诊断结果 | 解决建议 |
|---|---|---|
| 端口被占用 | ✓ 已使用 | kill $(lsof -t -i:PORT) |
| 服务未启动 |
| 问题 | 诊断结果 | 解决建议 |
|---|---|---|
| 文件不存在 | 未找到文件 | 检查是否需要先安装/创建 |
| 权限不足 |
✓ 配置完整
✓ 服务运行中
✓ 文件存在
⚠ 未设置（使用默认值）
⚠ 服务未启动
⚠ 文件权限不完整
✗ 未设置（必须配置）
✗ 服务异常
✗ 文件缺失
| 配合技能 | 场景 |
|---|---|
| openclaw-email | 诊断邮件配置后配置邮箱 |
| deploy |
用户：为什么我的邮件读取不了？
AI：让我诊断一下... [调用诊断]
检查项（仅关键问题）：
触发条件：
bash
用户：帮我发封邮件
AI：[检测到邮件配置问题]
⚠️ 检测到邮件配置不完整，让我先诊断一下...
[自动执行邮件诊断]
| 级别 | 问题类型 | 是否主动提醒 |
|---|---|---|
| 🔴 严重 | Gateway 崩溃、配置丢失 | ✅ 立即提醒 |
| 🟡 警告 |
bash
# 检查配置文件
if [ ! -f /root/.openclaw/openclaw.json ]; then
echo 🔴 严重：配置文件丢失
return 1
fi
return 0
}
小帽 (OpenClaw)
2026-03-19
MIT
该技能支持在以下平台通过对话安装：
帮我安装 SkillHub 和 config-diagnose-1776106143 技能
设置 SkillHub 为我的优先技能安装源，然后帮我安装 config-diagnose-1776106143 技能
skillhub install config-diagnose-1776106143
文件大小: 9 KB | 发布时间: 2026-4-17 14:28
