1. 首页首页
  2. 科技前沿科技前沿

OpenClaw 详细部署流程（Windows版）

科技前沿 • • 阅读 1

OpenClaw 详细部署流程（Windows版）前置硬件 软件要求 系统 Windows 10 2004 版本以上 内部版本 19041 Windows 11 全版本 硬件 CPU 支持虚拟化 VT x AMD V 内存 8GB 目标磁盘剩余空间 20GB 网络 能正常访问外网 或国内镜像源 学习目标 学完本课程 你将掌握 Windows 下 WSL2 的一键安装与验证 WSL2 自定义非系统盘安装的完整流程

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



前置硬件/软件要求

  1. 系统：Windows 10 2004版本以上（内部版本19041+）/ Windows 11 全版本
  2. 硬件：CPU支持虚拟化（VT-x/AMD-V），内存≥8GB，目标磁盘剩余空间≥20GB
  3. 网络：能正常访问外网（或国内镜像源）

学习目标

学完本课程，你将掌握：

  1. Windows下WSL2的一键安装与验证
  2. WSL2自定义非系统盘安装的完整流程
  3. 适配OpenClaw的WSL环境优化配置
  4. WSL常见问题的排查与解决

所有安装方式都必须先完成这一步，提前规避90%的新手报错。

1.1 检查Windows系统版本

  1. 按下键盘 ，弹出运行窗口，输入  回车
  2. 在弹出的窗口中核对版本要求：
    • Windows 10：需显示「版本 2004 及以上」，内部版本号≥19041
    • Windows 11：任意版本均符合要求
  3. 若版本不达标：打开「设置 → Windows 更新 → 检查更新」，升级到最新稳定版后再继续。

1.2 确认CPU虚拟化已开启

  1. 按下  打开任务管理器
  2. 切换到「性能」选项卡，点击「CPU」
  3. 在右下角查看「虚拟化：已启用」
  4. 若显示「未启用」：重启电脑，进入BIOS开启CPU虚拟化（VT-x/AMD-V），可搜索「你的电脑型号 开启虚拟化」获取对应教程。

1.3 准备管理员权限终端

后续所有操作必须以管理员身份运行终端，操作步骤：

  1. 按下 ，在弹出的菜单中选择「Windows 终端（管理员）」（Windows 10 选择「Windows PowerShell（管理员）」）
  2. 弹出用户账户控制提示，点击「是」，进入管理员终端窗口，后续所有命令均在此窗口执行。

适用场景：C盘剩余空间≥20GB，想最快速度完成安装，上手OpenClaw
全程仅需4步，5分钟完成安装

2.1 执行一键安装命令

在管理员终端中，直接输入以下命令，回车执行：

powershell

 
    
命令核心作用：
 这是微软官方的一键安装指令，会自动完成所有操作，无需手动干预：

 
    
     
     
  • ✅ 启用「适用于Linux的Windows子系统」核心组件
    •  
     
  • ✅ 启用「虚拟机平台」虚拟化组件
    •  
     
  • ✅ 下载并安装WSL2最新Linux内核
    •  
     
  • ✅ 下载并安装默认的Ubuntu Linux发行版
    •  
     
  • ✅ 自动设置WSL2为默认版本
    •  
    
 
    
初始化完成后，按提示创建UNIX用户账户：
 
    
bash
 
    
 
    
2.2 重启电脑使组件生效
 
    
命令执行完成后，必须重启电脑，否则系统组件不会生效，重启后再进行后续操作。
 
    
2.3 Ubuntu安装及系统初始化设置
 
    
     
     
  1. 按下 ，在弹出的菜单中选择「Windows 终端（管理员）」
    2.  
     
  2. 输入：
    3.  
    
 
    
powershell
 
    
 
    
2.4 验证安装是否成功
 
    
在管理员终端中，输入以下命令回车执行：
 
    
powershell
 
    
 
    
成功标准（必须同时满足）：
 
    
     
     
  1. STATE 列显示 Running
    2.  
     
  2. VERSION 列显示 2（必须为2，不可为1）
    3.  
     
  3. 发行版名称显示 Ubuntu 或对应版本名
    4.  
    
 
    
完成验证后，可直接跳转到第四章，进行OpenClaw专属环境配置。
 
    
2.5 系统更新与软件源配置
 
    
常规使用：
 
    
powershell
 
    
 
    
如果需要配置国内镜像源（如清华大学 TUNA 镜像或阿里云镜像），然后执行系统更新：
 
    
powershell
 
    
 
    
 
     
 
     
 
     
适用场景：C盘空间不足，想把WSL安装到其他盘，全程10步，15分钟完成
 核心说明：微软官方  命令无直接指定安装路径的参数，无法一键装到其他盘，因此采用「装核心组件→导出发行版→导入到目标盘」的官方标准方案，安全无风险，不会丢失数据。

 
     
3.1 安装WSL核心组件（必须先做）
 
     
在管理员终端中，依次执行以下命令，先安装WSL核心组件，不自动安装发行版：
 
     
powershell
 
     
 
     
执行完成后，必须重启电脑，使组件生效。
 
     
3.2 安装Ubuntu发行版到临时目录
 
     
重启电脑后，再次打开管理员终端，执行以下命令，安装OpenClaw官方推荐的Ubuntu 22.04 LTS稳定版：
 
     
powershell
 
     
 
     
3.3 终止发行版，避免自动初始化
 
     
安装完成后，绝对不要打开Ubuntu应用（避免自动初始化占用C盘），直接在终端执行以下命令，终止发行版运行：
 
     
powershell
 
     
 
     
3.4 在目标盘创建安装目录
 
     
     
      
  1. 打开文件资源管理器，在目标盘（如D盘）创建专属目录，示例： 
       
       
        
    • 导出文件临时目录：
      •  
        
    • 最终安装目录：
      •  
       
     
    2.  
      
  2. ❗ 关键避坑：目录路径绝对不要有中文、空格、特殊字符，否则会导致导入失败。
    3.  
     
 
     
3.5 导出发行版到临时文件
 
     
在管理员终端中，执行导出命令，把安装的Ubuntu发行版打包成tar文件，放到目标盘临时目录：
 
     
powershell
 
     
 
     
等待导出完成，根据磁盘速度约1-3分钟，无报错即为成功。
 
     
3.6 注销C盘的默认发行版
 
     
导出完成后，执行以下命令，删除C盘安装的默认发行版，释放C盘空间：
 
     
powershell
 
     
 
     
执行后，C盘的发行版文件会被完全删除，后续用导出的tar文件导入到目标盘。
 
     
3.7 导入发行版到目标盘
 
     
执行导入命令，把tar文件导入到目标安装目录，强制使用WSL2版本：
 
     
powershell
 
     
 
     
参数解释：
 
     
     
      
  • ：自定义的发行版名称，后续启动用这个名字
    •  
      
  • ：目标安装目录，WSL所有文件都会存放在这里
    •  
      
  • ：强制使用WSL2版本，必须添加该参数
    •  
     
 
     
3.8 设置默认登录用户（关键！避免默认root登录）
 
     
导入完成后默认会以root管理员身份登录，不符合日常使用规范，需设置普通用户为默认登录用户：
 
     
     
      
  1. 先进入导入的Ubuntu系统：
    2.  
     
 
     
powershell
 
     
 
     
     
      
  1. 进入系统后，依次执行以下命令，替换命令中的  为你自定义的用户名：
    2.  
     
 
     
bash
 
     
 
     
     
      
  1. 执行完成后，输入  退出WSL系统，回到Windows终端。
    2.  
     
 
     
3.9 重启WSL使配置生效
 
     
在管理员终端执行以下命令，终止并重启发行版：
 
     
powershell
 
     
 
     
成功标准：
 进入系统后，命令行前缀显示你创建的用户名，而非root，示例：

 
     
text
 
     
 
     
3.10 验证安装路径与版本
 
     
在Windows管理员终端，执行以下命令验证安装结果：
 
     
powershell
 
     
 
     
成功标准（必须同时满足）：
 
     
     
      
  1. STATE 列显示 Running
    2.  
      
  2. VERSION 列显示 2
    3.  
      
  3. LOCATION 列显示你设置的目标盘路径（如 ）
    4.  
      
  4. 打开目标盘目录，能看到WSL系统文件，说明安装路径正确
    5.  
     
 
     
 
      
 
      
 
      
WSL 网络架构详解与配置
 
      
配置.wslconfig 文件
 
      
镜像模式属于全局配置，需在 Windows 用户目录下创建或修改  文件。
 
      
步骤 1：打开文件资源管理器，导航到以下路径：
 
      
powershell
 
      
 
      
步骤 2：如果文件不存在，创建名为  的新文件（注意前面的点号）。也可以直接下载放入。
 步骤 3：使用记事本打开文件，添加以下配置：

 
      
ini
 
      
 
      
步骤 4：保存文件。
 步骤 5：在 Windows 终端中执行以下命令以应用配置：

 
      
powershell
 
      
 
      
步骤 6：等待约 8 秒钟以确保虚拟机彻底关闭，然后重新启动 Ubuntu。
 
      
验证配置：
 进入 WSL 后，执行以下命令验证网络模式：

 
      
powershell
 
      
 
      
防火墙与安全策略调整
 
      
在镜像模式下，WSL2 应用将直接暴露在 Windows 防火墙规则中。为了确保 OpenClaw 的网络端口能够被正确访问，需要配置 Windows 防火墙规则。
 
      
步骤 1：以管理员身份打开 PowerShell
 在开始菜单中搜索 “PowerShell”，右键选择“以管理员身份运行”。

 
      
步骤 2：配置防火墙规则
 对于 WSL2 镜像网络模式，推荐使用标准的 Windows 防火墙命令：

 
      
powershell
 
      
 
      
4.1 基础环境配置（免密设置）
 
      
为了在后续安装脚本运行中避免频繁输入密码，建议为当前用户开启 sudo 免密权限：
 
      
powershell
 
      
 
      
在文件末尾添加以下内容（将  替换为你的实际用户名）：
 
      
text
 
      
 
      
保存并退出（Ctrl+O → Enter → Ctrl+X）。
 
      
4.2 安装基础工具
 
      
powershell
 
      
 
      
4.3 安装 OpenClaw 官方脚本
 
      
powershell
 
      
 
      
4.4 如果出现npm没有安装到全局环境
 
      
执行这段代码：
 
      
powershell
 
      
 
      
4.5 LLM模型选择
 
      
     
       
  1. GLM 新用户可以白嫖 
    2.  
       
  2. 阿里百炼 7.9可以白嫖首月COD
    3.  
       
  3. 硅基流动也可以白嫖很多新手
    4.  
      
 
      
阿里百炼openclaw部署办法
 
      
json
 
      
 
      
输入代码：重新启动
 
      
powershell
 
      
 
      
4.5 运行初始化向导
 
      
powershell
 
      
 
      
4.6 验证安装
 
      
powershell
 
      
 
      
OpenClaw拓展链接
 
      
https://chromewebstore.google.com/detail/openclaw-browser-relay/nglingapjinhecnfejdcpihlpneeadjp
 
      
报错请看
 
      
如果启动gateway报错：需要启用 systemd 才能在 WSL 里正常运行。
 
      
     
       
  1. 输入代码：
    2.  
      
 
      
powershell
 
      
 
      
     
       
  1. 在 Windows PowerShell 里执行 
    2.  
      
 
      
powershell
 
      
 
      
     
       
  1. 重启 WSL 后，再启动 OpenClaw。
    2.  
      
 
      
如果启动OPENCLAW后 出现下面的代码：
 
      
text
 
      
 
      
     
       
  1. 输入：
    2.  
      
 
      
powershell
 
      
 
      
     
       
  1. 检查状态：
    2.  
      
 
      
powershell
 
      
 
      
 
       
 
       
 
       
问题1：执行wsl –install报错，提示需要更新内核
 解决方案：手动下载安装微软官方WSL2内核更新包，地址：https://learn.microsoft.com/zh-cn/windows/wsl/install-manual#step-4—download-the-linux-kernel-update-package

 
       
，安装后重新执行命令。
 
       
问题2：wsl –list –verbose 显示VERSION是1，不是2
 解决方案：

 
       
     
        
  1. 确认CPU虚拟化已开启
    2.  
        
  2. 执行 
    3.  
        
  3. 执行 ，等待转换完成
    4.  
       
 
       
问题3：忘记Ubuntu用户密码
 解决方案：

 
       
     
        
  1. 在Windows终端执行 ，以root身份进入系统
    2.  
        
  2. 执行 ，重新设置密码
    3.  
        
  3. 执行  退出，用新密码登录即可
    4.  
       
 
       
问题4：镜像模式不生效，IP还是172开头
 解决方案：

 
       
     
        
  1. 确认文件放在正确的用户目录下，文件名正确（，不是）
    2.  
        
  2. 执行  完全关闭WSL，等待10秒后再启动
    3.  
        
  3. 执行  更新WSL到最新版本
    4.  
       
 
       
问题5：导入发行版报错，提示路径无效
 解决方案：检查目标路径是否有中文、空格、特殊字符，换成纯英文路径，比如，不要使用带空格/中文的路径。

 
       
 
      
     
    
   
  
  

                    


                    


                    

                        

                            

                                小讯
                            

                            

                                

                                    
                                        
                                    
                                

                            

                        

                    

                


                

                    
                    
                    

                        
                        

                             上一篇
                            2026-03-31 09:17
                        

                    

                    
                    


                    
                    
                    

                        
                        

                            下一篇 
                            2026-03-31 09:15
                        

                    

                    
                    
                


                

                    
相关推荐

                    
                

                

                    

                        版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/229342.html