我给你整理**最清晰、最完整、一步不踩坑的手动安装 OpenClaw 教程**，全程纯手动，不依赖一键脚本，你跟着做就能成功。 # OpenClaw 手动安装完整步骤（2026最新版） ## 一、先检查/安装环境（必须） ### 1. 安装 Node.js（必须 ≥ 22.0.0） - 下载地址：https://nodejs.org/ - 安装时**全部默认下一步** - 安装完打开命令行检查： ```bash node -v npm -v ``` 出现版本号就说明成功。 --- ## 二、正式手动安装 OpenClaw ### 步骤1：打开终端（Windows用PowerShell，Mac/Linux用终端） ### 步骤2：执行全局安装命令 ```bash npm install -g openclaw@latest ``` ### 步骤3：安装完成后，执行初始化配置 ```bash openclaw onboard ``` ### 步骤4：按提示完成配置（非常简单） 1. 输入你的 **AI 模型 API Key**（OpenAI / 通义 / Kimi 等） 2. 确认工作区目录（直接回车用默认即可） 3. 确认端口（默认 18789） 4. 询问是否安装为**系统服务（开机自启）** → 输入 `y` 回车 --- ## 三、启动服务 ```bash openclaw start ``` 查看运行状态： ```bash openclaw status ``` 出现： `Gateway running` 表示安装成功！ --- ## 四、常用手动命令（你一定会用到） ```bash openclaw start       # 启动 openclaw stop        # 停止 openclaw restart     # 重启 openclaw status      # 查看状态 openclaw onboard     # 重新配置AI密钥 npm install -g openclaw@latest  # 升级版本 ``` --- ## 五、Windows 可能遇到的问题（90%的人卡在这里） ### 1. 提示“无法加载文件，因为在此系统上禁止运行脚本” 解决方法： 以**管理员身份**打开 PowerShell，执行： ```powershell Set-ExecutionPolicy RemoteSigned -Scope CurrentUser ``` 按 `Y` 确认即可。 ### 2. 安装慢 / 失败 使用淘宝镜像加速： ```bash npm config set registry https://registry.npmmirror.com npm install -g openclaw@latest ``` --- ## 六、安装成功标志 终端输入： ```bash openclaw ``` 能出现帮助菜单 = 安装成功 ✅ --- # 最简总结（3行命令搞定） ```bash npm install -g openclaw@latest openclaw onboard openclaw start ``` 你告诉我你用的是 **Windows / Mac / Linux**，我可以直接给你**对应系统的专属极简安装步骤**。