📌 前置要求
✅ 系统要求: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
从 nodejs.org 下载并安装LTS版本 安装过程中勾选「Add to PATH」选项 验证安装:打开命令提示符,运行以下命令
node --version npm --version1.2 安装OpenClaw
以管理员身份打开命令提示符/PowerShell 安装OpenClaw全局包
npm install -g openclaw验证安装
openclaw --version1.3 配置环境
初始化OpenClaw配置
openclaw onboard启动Gateway服务
openclaw gateway start访问控制面板:浏览器打开 http://127.0.0.1:18789
⬇️ 方法二:直接安装(预编译版本)
2.1 下载预编译版本
访问 GitHub Releases 下载Windows版本的zip/msi安装包 解压zip文件或运行msi安装程序
2.2 配置环境变量
找到OpenClaw的bin目录(例:C:\Program Files\OpenClaw\bin) 打开「系统属性」→「高级」→「环境变量」 在「系统变量」的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 registry3.2 安装OpenClaw
npm cache clean --force npm install -g openclaw🐙 方法四:GitHub源码安装
4.1 克隆源码
git clone https://github.com/openclaw/openclaw.git cd openclaw4.2 安装依赖
npm install npm run build4.3 全局链接
npm link openclaw --version🐧 方法五:WSL安装
5.1 安装WSL
wsl --install5.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 nodejs5.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
❓ 常见问题
🗑️ 卸载指南
7.1 卸载npm安装的版本
npm uninstall -g openclaw7.2 卸载直接安装的版本
1. 运行msi卸载程序
2. 删除安装目录
3. 移除环境变量
夜雨聆风