我给你整理**最清晰、最完整、一步不踩坑的手动安装 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**，我可以直接给你**对应系统的专属极简安装步骤**。
