OpenClaw Windows全流程实操安装指南

OpenClaw Windows全流程实操安装指南（3种安装方案：一键绿色包/原生npm安装/WSL2推荐安装）

系统硬性要求：Win10 21H2及以上/Win11、内存≥8GB（优选16GB）、磁盘空余≥15GB，CPU支持虚拟化（WSL方案必需）

前置提醒：安装前临时关闭Windows Defender实时防护、火绒/360等杀毒，避免安装包被误拦截删除

方案一：绿色一键安装包（新手首选·免环境配置，推荐）

1.下载官方Windows一键ZIP安装包

国内社区包下载链接：https://pan.quark.cn/s/73c17f1bbcef

2.解压安装包

1. 右键zip压缩包→解压到当前文件夹（7Z/WinRAR，路径不能含中文、空格，例：D:\OpenClaw-Win，禁止桌面中文目录）
2. 进入解压文件夹，找到Openclaw Windows 一键启动.exe（龙虾图标）
3. 弹出Windows SmartScreen安全拦截：点【更多信息】→【仍要运行】

3.一键自动部署

1. 程序自动检测缺失依赖：自动下载安装Node.js22+、运行环境、内核文件，全程无需手动配置
2. 等待5~15分钟（取决于网速），完成后自动弹出配置向导页面

4.初始化配置&启动服务

1. 向导openclaw onboard：选择接入模型（GPT/DeepSeek/Claude/Ollama本地）→填入对应API Key→选定模型版本
2. 配置通讯通道（微信/飞书/钉钉可跳过，后续后台添加）
3. 启动网关：自动跳转Web管理页http://localhost:18789，安装完成

方案二：Windows原生手动安装（命令行npm/pnpm，自定义部署）

步骤1：管理员权限配置PowerShell策略

Win+X→选择Windows PowerShell(管理员)，执行：

Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSigned# 输入Y确认

步骤2：安装依赖三件套（Node22+Git+pnpm）

① Node.js v22.x LTS（必装，最低≥22.0.0）

1. 官网下载：https://nodejs.org/zh-cn/download → Windows .msi安装包
2. 安装向导：全程Next，勾选Add to PATH自动写入环境变量，安装路径无中文
3. 新开PowerShell验证：

node-v# 输出v22.x.x即成功npm-v

② Git安装

1. 官网：git-scm.com→下载64位exe安装包，默认下一步安装
2. 验证：git --version输出版本号

③ pnpm安装+国内镜像加速（官方推荐，避免npm依赖卡死）

npm install-g pnpm# 配置淘宝镜像（国内提速）pnpm configsetregistry https://registry.npmmirror.com/

步骤3：两种源码安装（原版/国内社区版）

A 全球原版openclaw

# Git Bash终端执行gitclone https://github.com/openclaw/openclaw.gitcdopenclawpnpminstallpnpmbuildpnpminstall-g.#本地全局安装

B 国内优化版openclaw-cn（适配国产大模型：通义千问/DeepSeek）

gitclone https://gitee.com/OpenClaw-CN/openclaw-cn.gitcdopenclaw-cnpnpminstallpnpmbuildpnpminstall-g.

步骤4：初始化+启动

# 配置向导openclaw onboard# 启动网关服务，浏览器打开18789端口openclaw gateway

快捷一键脚本（不想手动装环境）

管理员PowerShell直接运行一键脚本：

#国内社区一键脚本iwr-useb https://open-claw.org.cn/install-cn.ps1|iex#原版官方脚本iwr-useb https://openclaw.ai/install.ps1|iex

方案三：WSL2-Ubuntu安装（兼容性最优，开发首选，官方主推）

1.管理员PowerShell启用WSL2

wsl--install# 自动安装Ubuntu，执行后重启电脑wsl--set-default-version 2

重启后自动打开Ubuntu，设置用户名+密码

2.WSL启用systemd（OpenClaw后台服务必需）

Ubuntu终端执行：

sudotee/etc/wsl.conf>/dev/null<<'EOF' [boot] systemd=true [interop] enabled=true appendWindowsPath=true EOF

Windows端PowerShell：wsl --shutdown，重启WSL

3.WSL安装Node22

curl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoapt-getinstall-ynodejsnode-v#验证v22+

4.安装OpenClaw&启动

#全局安装npminstall-gopenclaw@latest#初始化配置openclaw onboard --install-daemon#启动网关，Windows浏览器访问localhost:18789openclaw gateway

常用运维命令汇总

常见报错解决

1. 端口18789被占用：openclaw gateway --port=18790修改端口启动
2. 依赖下载超时：已配置pnpm镜像，重装前执行pnpm cache clean
3. WSL安装失败：BIOS开启CPU虚拟化，控制面板→程序→启用Windows虚拟机平台+WSL