OpenClaw Windows全流程实操安装指南3种安装方案一键绿色包/原生npm安装/WSL2推荐安装系统硬性要求Win10 21H2及以上/Win11、内存≥8GB优选16GB、磁盘空余≥15GBCPU支持虚拟化WSL方案必需前置提醒安装前临时关闭Windows Defender实时防护、火绒/360等杀毒避免安装包被误拦截删除方案一绿色一键安装包新手首选·免环境配置推荐1.下载官方Windows一键ZIP安装包国内社区包下载链接https://pan.quark.cn/s/73c17f1bbcef2.解压安装包右键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策略WinX→选择Windows PowerShell(管理员)执行Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSigned# 输入Y确认步骤2安装依赖三件套Node22Gitpnpm① 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适配国产大模型通义千问/DeepSeekgitclone 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启用WSL2wsl--install# 自动安装Ubuntu执行后重启电脑wsl--set-default-version 2重启后自动打开Ubuntu设置用户名密码2.WSL启用systemdOpenClaw后台服务必需Ubuntu终端执行sudotee/etc/wsl.conf/dev/nullEOF [boot] systemdtrue [interop] enabledtrue appendWindowsPathtrue EOFWindows端PowerShellwsl --shutdown重启WSL3.WSL安装Node22curl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoapt-getinstall-ynodejsnode-v#验证v224.安装OpenClaw启动#全局安装npminstall-gopenclawlatest#初始化配置openclaw onboard --install-daemon#启动网关Windows浏览器访问localhost:18789openclaw gateway常用运维命令汇总命令作用openclaw --version查看当前安装版本openclaw stop关闭后台网关服务openclaw update在线静默升级openclaw clean清理缓存依赖常见报错解决端口18789被占用openclaw gateway --port18790修改端口启动依赖下载超时已配置pnpm镜像重装前执行pnpm cache cleanWSL安装失败BIOS开启CPU虚拟化控制面板→程序→启用Windows虚拟机平台WSL
OpenClaw Windows全流程实操安装指南
发布时间：2026/6/6 3:30:33
OpenClaw Windows全流程实操安装指南3种安装方案一键绿色包/原生npm安装/WSL2推荐安装系统硬性要求Win10 21H2及以上/Win11、内存≥8GB优选16GB、磁盘空余≥15GBCPU支持虚拟化WSL方案必需前置提醒安装前临时关闭Windows Defender实时防护、火绒/360等杀毒避免安装包被误拦截删除方案一绿色一键安装包新手首选·免环境配置推荐1.下载官方Windows一键ZIP安装包国内社区包下载链接https://pan.quark.cn/s/73c17f1bbcef2.解压安装包右键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策略WinX→选择Windows PowerShell(管理员)执行Set-ExecutionPolicy-Scope CurrentUser-ExecutionPolicy RemoteSigned# 输入Y确认步骤2安装依赖三件套Node22Gitpnpm① 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适配国产大模型通义千问/DeepSeekgitclone 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启用WSL2wsl--install# 自动安装Ubuntu执行后重启电脑wsl--set-default-version 2重启后自动打开Ubuntu设置用户名密码2.WSL启用systemdOpenClaw后台服务必需Ubuntu终端执行sudotee/etc/wsl.conf/dev/nullEOF [boot] systemdtrue [interop] enabledtrue appendWindowsPathtrue EOFWindows端PowerShellwsl --shutdown重启WSL3.WSL安装Node22curl-fsSLhttps://deb.nodesource.com/setup_22.x|sudo-Ebash-sudoapt-getinstall-ynodejsnode-v#验证v224.安装OpenClaw启动#全局安装npminstall-gopenclawlatest#初始化配置openclaw onboard --install-daemon#启动网关Windows浏览器访问localhost:18789openclaw gateway常用运维命令汇总命令作用openclaw --version查看当前安装版本openclaw stop关闭后台网关服务openclaw update在线静默升级openclaw clean清理缓存依赖常见报错解决端口18789被占用openclaw gateway --port18790修改端口启动依赖下载超时已配置pnpm镜像重装前执行pnpm cache cleanWSL安装失败BIOS开启CPU虚拟化控制面板→程序→启用Windows虚拟机平台WSL
