写在前面
如果 OpenClaw 还没装起来，现在先不要猜业务配置、平台接入或复杂行为。
安装阶段的目标只有一个：先确认这台机器能不能把 OpenClaw 装好，并且至少进入最小可读状态。
第一步：先确认是不是环境前提没满足
安装失败时，先看环境，不要先看字段。
最常见的环境类问题包括：
- 运行时版本不对；
- 当前用户或目录权限不合适；
- shell 环境和命令执行上下文不一致；
- 这台机器本身就不满足当前安装条件。
如果你连“这台机器适不适合当前安装方式”都还没答清楚，就不要继续往后叠加命令。
第二步：确认你跟的是不是同一套资料
第一次安装时，最容易踩的坑之一就是混用了不同版本、不同来源的命令和截图。
如果你出现下面这些情况，先停下来收束：
- 文档里的命令和你实际看到的行为对不上；
- 截图、字段名、提示信息彼此矛盾；
- 你自己也说不清刚才到底跟的是哪篇教程。
这一步的目标不是继续试新命令，而是先把资料来源统一。
第三步：确认安装路径有没有混用
安装路径一旦混用，后面很多现象都会变得不可靠。
常见情况：
- 刚跑一套 CLI 安装，又去套另一套旧脚本；
- 图形化路径和命令行路径交替执行；
- 本地有旧残留，但你按全新安装去理解当前结果。
如果你已经混用了路径，现在最该做的不是继续安装，而是先回答清楚：我当前到底走的是哪条安装路线。
第四步：补一轮最小启动检查
如果安装命令已经执行过，但你不确定是否算成功，就先跑最小检查：
openclaw --version
openclaw status
openclaw gateway status判断标准：
- 如果
openclaw --version都不能返回，说明安装还没成立； - 如果命令能执行，但状态读不出来，问题已经开始从安装转向启动；
- 如果状态可读但不稳定，不要继续停留在安装页，要转去启动排查。
一个够用的排查顺序
大多数安装问题，按这个顺序查就够了：
- 先看环境前提；
- 再看资料是否混用；
- 再看安装路径是否混用；
- 最后补最小启动检查。
这个顺序的意义是，先排掉前提问题，再判断是否已经进入运行层问题。
常见错误或风险
- 还没装好，就开始排平台接入；
- 一次切换多种安装方案；
- 没记录当前报错位置，就直接重装；
- 明明还停留在安装前提层，却开始研究复杂配置。
下一步
如果你发现问题还停留在安装阶段，回 安装失败先看什么。
如果命令已经能执行，但程序始终起不来或状态不稳定，继续看 启动失败排查。