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）只显示是否配置，不显示值
• 检查结果按严重程度排序（错误 > 警告 > 通过）