OpenClaw在Windows上的五种安装方法:一、一键脚本(新手推荐,含国内镜像);二、npm全局安装(需Node.js v22+及管理员权限);三、手动源码安装(适合开发者调试);四、nvm-windows多版本管理(支持Node多版本共存);五、离线安装(适用于内网环境)。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您尝试在Windows系统上安装OpenClaw但遇到命令失败、依赖缺失或权限报错等问题,则可能是由于Node.js版本不兼容、PowerShell执行策略限制或环境变量未生效所致。以下是多种可行的安装方法,覆盖不同网络条件与用户技术背景:
一、一键脚本安装(推荐新手)
该方式自动检测并安装Node.js、Git及OpenClaw核心,全程交互式引导,适合无开发经验用户。脚本已适配国内网络,避免GitHub直连超时。
1、按下Win + S,搜索“PowerShell”,右键选择「以管理员身份运行」。
2、在打开的PowerShell窗口中,逐行执行以下两条命令(注意复制完整,不含空格):
3、执行国内镜像安装脚本:iwr -useb https://clawd.org.cn/install.ps1 | iex
4、等待脚本自动下载、解压、安装,过程中会提示选择模型(如阿里云百炼、MiniMax等),按需输入API Key或选择「暂时跳过」。
5、安装完成后,输入openclaw-cn --version验证,输出类似2026.2.24即表示成功。
二、npm全局安装(推荐熟悉命令行用户)
此方法绕过脚本依赖,直接通过npm包管理器安装,便于排查错误、切换版本或使用汉化版。
1、确保已安装Node.js v22或更高版本:在PowerShell中运行node -v,输出必须为v22.x.x或v24.x.x;若低于v18,请卸载后重装官网LTS版。
2、设置国内npm镜像源以加速下载:npm config set registry https://registry.npmmirror.com
3、安装OpenClaw中文版(稳定、适配Windows):npm install -g openclaw-cn@latest
4、若提示权限错误,再次确认PowerShell为「管理员身份」;若提示git未找到,请先安装Git并勾选「Add Git to PATH」。
5、验证安装:openclaw-cn -v,成功后将显示版本号。
三、手动源码安装(推荐开发者或需调试用户)
该方式克隆官方仓库,可修改配置、启用调试日志、查看本地构建过程,适用于需深度定制或排查特定技能异常的场景。
1、安装Git并配置HTTPS镜像加速:git config --global url."https://github.com/".insteadOf ssh://git@github.com/
2、创建安装目录并克隆仓库:mkdir C:\openclaw && cd C:\openclaw && git clone https://github.com/jiulingyun/openclaw-cn.git .
3、安装依赖并构建:npm install && npm run build
4、链接为全局命令:npm link
5、验证是否注册成功:openclaw-cn --help应列出全部可用子命令。
四、nvm-windows多版本管理安装(推荐需共存多个Node环境用户)
当系统已存在旧版Node.js(如v16),或需同时测试OpenClaw不同分支时,nvm-windows可安全隔离版本,避免全局污染。
1、下载nvm-windows安装包:https://github.com/coreybutler/nvm-windows/releases,运行nvm-setup.exe,全程默认安装。
2、重启PowerShell(使nvm命令生效),执行:nvm list available查看可安装版本。
3、安装并切换至v24 LTS:nvm install 24.14.0 && nvm use 24.14.0
4、验证Node与npm版本:node -v && npm -v,确认输出匹配v24与npm v11+。
5、执行npm全局安装:npm install -g openclaw-cn,后续所有操作均基于该Node版本。
五、离线安装(推荐内网或断网环境用户)
适用于企业局域网、无外网权限的生产终端,需提前在联网机器打包依赖,再拷贝部署。
1、在联网Windows机器上,使用nvm切换至v24,执行:npm pack openclaw-cn@latest,生成openclaw-cn-2026.2.24.tgz文件。
2、将该tgz文件及Node.js v24离线安装包(.msi)、Git离线安装包(.exe)一并拷贝至目标机器。
3、依次双击安装Node.js(勾选自动安装工具)、Git(勾选添加PATH)。
4、在PowerShell中执行:npm install -g C:\path\to\openclaw-cn-2026.2.24.tgz
5、安装完成后,运行openclaw-cn onboard --flow quickstart启动本地初始化向导。






