OpenClaw 安装与首次运行 FAQ：常见卡点逐条答
以下是社区与官方 FAQ 里出现频率最高的首次运行问题，按流程顺序排列。
装 Node 还是装不了 OpenClaw？
- Node 版本不在支持列表：只认 22.22.3+、24.15+、25.9+ 三个版本段，官方推荐 24。用 node --version 核对。
- 不想管 Node：官方安装脚本会按需自动装 Node；Windows 用户用 Windows Hub 或 PowerShell 脚本，别自己手搓环境。
提示找不到 openclaw 命令
几乎总是 PATH 问题：npm 的全局二进制目录不在 shell 的 PATH 里。官方给的三连排查：node -v（Node 在吗）、npm prefix -g（全局包装哪了）、echo PATH（那个目录进 PATH 了吗）。Windows 用户重点看 PowerShell 配置文件里的 PATH 设置。
引导跑到一半失败/超时
引导的耗时来源：提供商登录、渠道配对、守护进程安装、下载、技能与插件。官方明确这些都是可跳过项——先跳过全部可选项跑通主链路，之后用 openclaw configure 回头补。网络受限环境先配好代理再重跑。
网关起了，第一条消息没回复
按顺序查：
- openclaw models status ——提供商验证与额度正常吗？
- openclaw doctor ——配置有没有结构性问题？
- openclaw logs --follow ——发消息时日志里有入站记录吗？没有 = 渠道层问题（令牌、白名单、配对）；有入站没回复 = 模型层问题。
- 私信配对流程走了吗？陌生发送者要先收配对码、网关侧批准才放行（见 私信配对）。
手机/第二台设备想接入
那不是新装一套，而是给现有网关加节点或渠道：手机走节点应用配对（见 Android 配对），其他电脑走浏览器控制界面远程访问（见 远程访问）。
官方 FAQ 在哪看
官方文档站的帮助分区维护着常规故障排除、首次运行、模型与验证三个 FAQ 分册，本站收录的是截至整理时的要点；细节以官方最新版为准。