乐于分享
好东西不私藏

OpenClaw在Windows环境下完全安装指南

OpenClaw在Windows环境下完全安装指南
Windows 环境下安装OpenClaw是一件麻烦事,本文整理了Windows环境能有效安装OpenClaw的相关方法与步骤,供大家安装过程中参考。

📌 前置要求

  • ✅ 系统要求:Windows 10 或 Windows 11(64位)
  • ✅ 环境要求:Node.js 14.0 或更高版本、npm 6.0 或更高版本
  • ✅ 资源要求:至少 2GB 可用磁盘空间
  • ✅ 权限要求:管理员权限(部分步骤需要)

💡 小提示:建议使用最新稳定版本的Node.js和npm,可通过 nodejs.org 下载LTS版本。


📦 方法一:npm全局安装(推荐)

1.1 安装Node.js和npm

  1. 从 nodejs.org 下载并安装LTS版本
  2. 安装过程中勾选「Add to PATH」选项
  3. 验证安装:打开命令提示符,运行以下命令
node --version 
npm --version

1.2 安装OpenClaw

  1. 以管理员身份打开命令提示符/PowerShell
  2. 安装OpenClaw全局包
npm install -g openclaw
  1. 验证安装
openclaw --version

1.3 配置环境

  1. 初始化OpenClaw配置
openclaw onboard
  1. 启动Gateway服务
openclaw gateway start

访问控制面板:浏览器打开 http://127.0.0.1:18789


⬇️ 方法二:直接安装(预编译版本)

2.1 下载预编译版本

  1. 访问 GitHub Releases
  2. 下载Windows版本的zip/msi安装包
  3. 解压zip文件或运行msi安装程序

2.2 配置环境变量

  1. 找到OpenClaw的bin目录(例:C:\Program Files\OpenClaw\bin)
  2. 打开「系统属性」→「高级」→「环境变量」
  3. 在「系统变量」的PATH中添加上述路径

2.3 验证和启动

openclaw --version openclaw init openclaw gateway start

🔗 方法三:镜像安装(加速下载)

3.1 配置npm镜像

 淘宝镜像: npm config set registry https://registry.npmmirror.com   
恢复官方镜像(如需): npm config set registry https://registry.npmjs.org

验证镜像设置:

npm config get registry

3.2 安装OpenClaw

npm cache clean --force 
npm install -g openclaw

🐙 方法四:GitHub源码安装

4.1 克隆源码

git clone https://github.com/openclaw/openclaw.git cd openclaw

4.2 安装依赖

npm install npm run build

4.3 全局链接

npm link openclaw --version

🐧 方法五:WSL安装

5.1 安装WSL

wsl --install

5.2 在WSL中安装Node.js

sudo apt update && sudo apt upgrade curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs

5.3 在WSL中安装OpenClaw

sudo npm install -g openclaw openclaw --version openclaw gateway start

✅ 验证安装

6.1 基本验证

openclaw --version 
或 openclaw status
启动openclaw :openclaw gateway

浏览器访问:http://127.0.0.1:18789

安装完之后,第一次需要配置
openclaw onboard

❓ 常见问题

问题
解决方案
npm命令不存在
将Node.js路径添加到PATH环境变量
权限错误
以管理员身份运行命令提示符
端口被占用
修改配置文件端口,或停止占用进程
安装缓慢
使用镜像安装,或检查网络连接

🗑️ 卸载指南

7.1 卸载npm安装的版本

npm uninstall -g openclaw

7.2 卸载直接安装的版本

1. 运行msi卸载程序 

2. 删除安装目录

 3. 移除环境变量