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.解压安装包
- 右键zip压缩包→解压到当前文件夹（7Z/WinRAR，路径不能含中文、空格，例：
D:\OpenClaw-Win，禁止桌面中文目录） - 进入解压文件夹，找到
Openclaw Windows 一键启动.exe（龙虾图标） - 弹出Windows SmartScreen安全拦截：点【更多信息】→【仍要运行】
3.一键自动部署
- 程序自动检测缺失依赖：自动下载安装Node.js22+、运行环境、内核文件，全程无需手动配置
- 等待5~15分钟（取决于网速），完成后自动弹出配置向导页面
4.初始化配置&启动服务
- 向导
openclaw onboard：选择接入模型（GPT/DeepSeek/Claude/Ollama本地）→填入对应API Key→选定模型版本 - 配置通讯通道（微信/飞书/钉钉可跳过，后续后台添加）
- 启动网关：自动跳转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）
- 官网下载：https://nodejs.org/zh-cn/download → Windows .msi安装包
- 安装向导：全程Next，勾选Add to PATH自动写入环境变量，安装路径无中文
- 新开PowerShell验证：
node-v# 输出v22.x.x即成功npm-v② Git安装
- 官网：git-scm.com→下载64位exe安装包，默认下一步安装
- 验证：
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 EOFWindows端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常用运维命令汇总
| 命令 | 作用 |
|---|---|
| openclaw --version | 查看当前安装版本 |
| openclaw stop | 关闭后台网关服务 |
| openclaw update | 在线静默升级 |
| openclaw clean | 清理缓存依赖 |
常见报错解决
- 端口18789被占用：
openclaw gateway --port=18790修改端口启动 - 依赖下载超时：已配置pnpm镜像，重装前执行
pnpm cache clean - WSL安装失败：BIOS开启CPU虚拟化，控制面板→程序→启用Windows虚拟机平台+WSL