为什么第一次安装会卡住
OpenClaw 的能力面很大，平台、provider、Gateway、聊天渠道、Tools、Skills 都能成为入口。问题在于，新手通常会同时尝试很多入口，结果是每一页都看了一点，但没有哪一条链路真正跑通。
第一次安装时，你不需要先理解所有能力。你只需要把“最小可用链路”跑通，也就是让命令行、认证、默认模型和基础状态检查先工作起来。
第一步先定平台，而不是先抄命令
先判断自己是在 macOS、本地 Linux、Windows 的 WSL2，还是远程主机上部署。不同平台决定了你后面如何处理路径、守护进程、日志位置和 Gateway 的常驻方式。
如果你还没做这个判断，就先回 平台说明。这一步比盲贴命令更重要，因为很多“安装失败”其实是平台选择不合适。
第二步只选一种安装方式
第一次尝试时，不要在脚本安装、npm 全局安装和源码构建之间来回切。选一种最短路径，把它跑通以后，再决定要不要切到更可控的方式。
对大多数新手，安装引导 是最稳的起点；如果你更熟悉命令行，可以直接看 快速开始。
openclaw onboard
openclaw doctor
openclaw health这组命令的意义不是“把所有东西都配完”，而是确认 CLI、认证和基础状态都已经进入可验证状态。
第三步先跑最小验证，不要急着上 Gateway 或 Channels
当你还没验证默认模型和基本健康状态时，过早进入 Gateway 配置或渠道接入，只会让排障面迅速膨胀。第一次部署建议先确认下面四件事：
- CLI 可以正常执行，版本和环境可见。
- 至少有一种可用的认证方式已经配置完成。
- 默认模型能响应一条最简单的请求。
openclaw health和基础状态检查没有明显报错。
什么时候再进入后续专题
只有在最小链路跑通以后，你才需要开始分流：
- 准备接多 provider，再去 模型提供商。
- 准备常驻运行或远程部署，再去 Gateway 手册。
- 准备接 Telegram、WhatsApp 或 Discord，再去 聊天渠道。
- 默认工具不够用，再去 Tools 与 Skills。
第一次安装最常见的三个误区
- 同时切多个平台和安装方式，导致你不知道问题到底出在哪一层。
- 还没验证最小链路，就开始调 Gateway、守护进程和远程访问。
- 出现报错后不保留命令输出和日志，后面只能靠猜。
如果你已经出现这三类情况，不要继续加新配置，先回 帮助中心 对照 FAQ、故障排除和调试工作流，把状态收敛下来再继续。