1. 先排环境前提
先执行：
node -v
which node
npm -v
pwd如果你怀疑目录权限有问题，再补一条：
touch .write-test && rm .write-test这一轮主要确认：
- Node.js 版本是否符合要求；
- 当前终端是不是你真正要使用的环境；
- 当前目录是否可写；
- 问题是不是还停留在环境层。
2. 再确认安装路径有没有混用
先回想并记录：
- 你刚才到底走的是脚本安装、CLI 安装，还是别的入口；
- 中途有没有切换过另一套教程；
- 有没有把旧文章、旧截图、旧命令混进来。
如果你连“这台机器现在到底按哪条路径在装”都说不清，就不要继续往下试别的新命令。
3. 检查是不是资料版本混了
第一次安装最常见的问题之一，不是命令写错，而是资料混用。
如果你现在看到的命令、字段、截图、向导和实际行为彼此对不上，先不要急着判定程序坏了，先怀疑是不是资料来源跨版本了。
4. 最后看最小启动有没有做过
如果你还没做过最小启动验证，就先执行：
openclaw --version
openclaw status
openclaw gateway status如果需要继续看运行信息，再补：
openclaw logs --follow这一轮的目标不是把所有日志都看懂，而是先分清：
- 命令能不能执行；
- 程序有没有启动；
- 状态能不能读；
- 日志里有没有持续性的阻塞错误。
什么情况应该直接升级到故障排查总页
如果你符合下面任一类情况，就不要继续停留在安装页：
- 你已经装过多次，旧状态目录和新安装可能混在一起；
- 你分不清现在卡在安装、启动还是配置；
- 你已经开始需要系统看 doctor、status、logs 这些信号；
- 问题范围已经超出“第一次安装”的边界。
这时直接去故障排查总页更合适。
一个够用的第一轮排查顺序
如果你现在只想先把局面理清，按这个顺序来：
node -v
which node
npm -v
pwd
openclaw --version
openclaw status
openclaw gateway status
openclaw logs --follow然后只回答这 4 个问题：
- 环境有没有问题；
- 路径有没有混用；
- 资料有没有混版本；
- 最小启动到底有没有成功。
把这 4 个问题答出来，再决定下一跳，效率会高很多。
常见错误或风险
- 没记录当前报错位置就开始重装；
- 还没做前置核对，就误判成配置问题；
- 明明还停留在安装阶段，却开始改复杂字段；
- 把“平台没连通”误当成安装失败。
分诊后去哪
如果问题还停留在前置条件，先回 安装页。
如果安装路径本身选得不稳，回 第一次安装该选哪条路径。
如果你已经需要统一分诊，直接进入 故障排查总页。