2026年6月8日，下面为你整理一份基于最新资料的 Windows 部署指南，涵盖环境准备、安装、配置到试运行全流程，帮你一次跑通！

---

一、安装前的准备工作

1. 系统要求

• 操作系统：Windows 10 或 11（64位）
• 内存：建议 8GB 以上
• 磁盘空间：至少 20GB 可用空间（用于存放 Skills 等组件）
• 网络：能够正常访问 GitHub 和 Node.js 官网

2. ⚠️ 重要安全提醒

OpenClaw 拥有操作文件系统、执行自动化任务的权限，强烈建议：

• 使用一台干净的备用电脑，或租用云端虚拟机进行安装测试
• 不要在存有重要资产的主力工作电脑上安装
• 给 API Key 设置月度使用限额，防止泄露导致超额扣费

3. 关闭安全防护软件

安装前请暂时关闭以下安全工具，否则可能拦截或删除关键文件：

• 360 安全卫士 / 360 杀毒
• 腾讯电脑管家
• 火绒安全
• Windows Defender 实时防护

OpenClaw 运行时会执行键鼠模拟、文件读写、浏览器控制等操作，易被安全软件判定为风险行为，这属于正常机制。

---

二、安装 Node.js 环境

OpenClaw 基于 Node.js 运行，要求 版本 ≥ 22，推荐使用 nvm 管理版本。

方式一：使用 nvm（推荐，方便切换版本）

1. 访问 nvm-windows Releases 下载 nvm-setup.exe 并安装
2. 以管理员身份打开 PowerShell（右键点击开始菜单 → Windows PowerShell（管理员））
3. 执行以下命令：

# 安装 Node.js 22 最新版本
nvm install 22

# 使用刚安装的版本
nvm use 22.22.0

# 验证安装
node -v    # 应输出 v22.x.x
npm -v     # 应输出对应 npm 版本
```[7](@ref)

### 方式二：直接安装（新手友好）
访问 [Node.js 官网](https://nodejs.org/) 下载 **LTS 版本（22.x）** 的 Windows 安装包（.msi），一路 Next 即可。

### 3. 配置国内镜像源（可选但推荐，大幅提升下载速度）
```powershell
npm config set registry https://registry.npmmirror.com
```[4](@ref)

### 4. 安装 Git（部分组件需要）
```powershell
winget install git.git
# 或手动从 Git官网 下载安装
git --version   # 验证安装

---

三、安装 OpenClaw

方法一：官方一键脚本（推荐新手）

在管理员 PowerShell 中执行：

iwr -useb https://openclaw.ai/install.ps1 | iex
```[7](@ref)

> 💡 若遇到执行策略报错，先运行：`Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`[7](@ref)

### 方法二：npm 全局安装（更可控）
```powershell
# 先清理缓存（如果之前安装失败）
npm cache clean --force

# 全局安装最新版
npm install -g openclaw@latest

# 验证安装
openclaw --version   # 应输出 3.x.x 版本号
```[4](@ref)

---

## 四、初始化配置（关键步骤）

### 1. 运行初始化向导
```powershell
openclaw onboard --flow quickstart
```[7](@ref)

### 2. 按提示完成配置

| 配置项 | 推荐选择 | 说明 |
|--------|---------|------|
| **风险提示** | Yes | 确认了解工具的风险[7](@ref) |
| **安装模式** | QuickStart | 新手快速模式[7](@ref) |
| **AI 模型** | 可选 Gemini、Qwen、DeepSeek 等 | 国内建议选 Gemini 或通义千问[7](@ref) |
| **API Key** | 输入对应平台的 Key | 需提前注册获取[7](@ref) |
| **通讯渠道** | Skip for now（暂不配置） | 后续可补充[7](@ref) |
| **技能（Skills）** | Yes | 安装推荐技能包[7](@ref) |
| **守护进程（Daemon）** | Yes | 实现后台运行[7](@ref) |

### 📌 接入 DeepSeek 模型（热门配置）
由于 DeepSeek 兼容 OpenAI 接口，在配置时选择 **OpenAI** 或 **Custom (OpenAI Compatible)**，然后填入：
- **API Key**：从 DeepSeek 开放平台获取的 `sk-xxx`
- **Base URL**：`https://api.deepseek.com`（末尾不要加 `/v1`）
- **Model Name**：`deepseek-chat` 或 `deepseek-reasoner`

### 📌 接入 Kimi 模型
- **Auth Method**：选择 `Kimi Code API key (subscription)`
- **Model**：推荐 `kimi-coding/k2p5`（旗舰模型，响应最快）

---

## 五、启动服务并验证

### 1. 启动 Gateway 网关
```powershell
# 方式一：先设置本地模式（重要！）
openclaw config set gateway.mode local

# 启动网关
openclaw gateway start
```[4](@ref)[7](@ref)

### 2. 打开 Web 控制台
访问 **http://127.0.0.1:18789/**，或运行：
```powershell
openclaw dashboard
```[4](@ref)

### 3. 发送消息试运行
在聊天框中输入 **“你好”**，如果能收到回复，说明安装成功！🎉[7](@ref)

### 4. 验证守护进程（关掉终端仍能运行）
```powershell
openclaw daemon status

---

六、常见问题排查

❌ 问题1：code 128 错误

原因：网络波动或 SSH 访问失败。

解决：

npm cache clean --force
npm install -g openclaw@latest   # 重试
```[4](@ref)

### ❌ 问题2：`'openclaw' 不是内部或外部命令`
**原因**：环境变量未刷新或 npm 全局目录未加入 PATH。
**解决**：关闭当前 PowerShell，重新以管理员身份打开；或手动将 `C:\Users\<用户名>\AppData\Roaming\npm` 加入系统 PATH。

### ❌ 问题3：网关启动失败（Gateway 离线）
**可能原因与解决**：
- 安全软件拦截 → 关闭后重试[9](@ref)
- 安装路径含中文 → 改为纯英文路径，如 `D:\OpenClaw`[9](@ref)
- Gateway token 不匹配 → 运行 `openclaw doctor --fix` 自动修复

### ❌ 问题4：首次启动加载慢
**正常现象**，首次需初始化依赖与环境，等待 **1-3 分钟** 即可，后续启动会加快[9](@ref)。

---

## 七、进阶方向

### 接入飞书机器人
```powershell
openclaw plugins install @m1heng-clawd/feishu

然后在飞书开放平台创建应用，配置 App ID、App Secret 及相应权限即可。

常用管理指令

指令	作用
openclaw status	查看当前所有通道和状态
openclaw doctor --fix	自动扫描并修复配置问题
openclaw daemon restart	修改配置后重启服务
openclaw onboard	重新初始化配置（换模型、换 Key）

---

八、总结

阶段	关键操作	预计耗时
环境准备	安装 Node.js 22+、Git	10分钟
安装本体	一键脚本或 npm 安装	5分钟
初始化配置	运行 onboard 向导	10分钟
启动验证	访问 Dashboard 发消息	5分钟

OpenClaw 是一款功能强大的本地 AI 智能体工具，数据存储在本地，隐私更有保障。安装过程中最需要注意的是：管理员权限、纯英文路径、关闭安全软件 这三点。祝你的“小龙虾”顺利跑起来！🦞✨