When to Use
- 用户要求进行系统自检
- 环境更新后验证配置
- 排查问题前的基础检查
- 定期健康检查
核心原则 ⚠️
只检查、汇报、建议，绝不主动修复
- ❌ 不自动安装任何包
- ❌ 不自动修改任何配置文件
- ❌ 不自动重启任何服务
- ✅ 只汇报发现的问题
- ✅ 只给出修复建议命令
- ✅ 等待用户确认后再执行修复
自检项目
1. Node.js 环境
- [ ] Node.js 版本（需 >= 22.12.0）
- [ ] nvm 是否可用
- [ ] npm 版本
2. OpenClaw 核心
- [ ] Gateway 状态
- [ ] Gateway 进程 node 版本
- [ ] 插件加载状态（acpx, qqbot, discord 等）
3. 配置文件
- [ ] openclaw.json 语法正确
- [ ] 必要的 channel 配置存在
4. Agent 文件
- [ ] SOUL.md 存在（必需）
- [ ] USER.md 存在（必需）
- [ ] AGENTS.md 存在（必需）
- [ ] MEMORY.md 存在（可选，用于长期记忆）
- [ ] memory/ 目录（每日记录）
- [ ] self-improving/ 目录（学习记忆）
5. Skills 详细检查
- [ ] skill 目录结构完整（SKILL.md, scripts/, config.json）
- [ ] Python 模块依赖是否安装
- [ ] 外部工具是否可用
6. MCP 检查
- [ ] acpx 插件版本
- [ ] acpx 二进制文件
- [ ] acpx 运行时后端状态
7. API Token
- [ ] 环境变量中的 API key
- [ ] 配置文件中的 API key（不显示值）
8. 权限
- [ ] workspace 目录权限
- [ ] .openclaw 目录权限
- [ ] skills 目录可写性
输出格式
# 🔍 自检报告
## ✅ 通过项
- Node.js (nvm): v22.22.1 ✅
- Gateway: 运行中 ✅
## ⚠️ 警告项
- telegram: 未启用（可选）
## ❌ 问题项
### 1. 🔴 Skill aliyun-stt: 缺少 Python 模块 'dashscope'
修复建议: pip3 install dashscope --break-system-packages
⚠️ 请手动执行上述命令，不要自动修复
执行方式
python3 ~/.openclaw/workspace-ptilopsis/skills/self-check/scripts/self_check.py
注意事项
- 绝不主动修复 - 只汇报问题和建议
- 所有修复命令需用户手动执行
- 敏感信息（如 token）只显示是否配置，不显示值
- 检查结果按严重程度排序（错误 > 警告 > 通过）