乐于分享
好东西不私藏

�� OpenClaw 部署环境准备:Windows下WSL安装及配置全攻略

�� OpenClaw 部署环境准备:Windows下WSL安装及配置全攻略

准备好部署环境,是OpenClaw部署的精髓,如果说OpenClaw部署收费99的话,环境准备至少值90。。。

通过 Windows 内置的 WSL(Windows Subsystem for Linux) 技术,我们完全可以在现有 Windows 电脑上实现 OpenClaw 方便快捷的本地化部署,既能获得Linux系统原生运行丝滑体验,又可以享受windows系统文件操作的简单方便。

第一部分:WSL 简介与准备工作

什么是 WSL?

WSL 全称 Windows Subsystem for Linux,是微软官方推出的强大工具,允许开发者直接在 Windows 上运行原生 Linux 命令行工具及应用程序。

我们之所以选择 WSL2(当前主流版本),是因为它包含完整的 Linux 内核,兼容性更好,性能极高,且能完整支持 Docker 和 OpenClaw 所需的全部依赖。

检查你的硬件与系统

在开始之前,请确保你的电脑满足以下条件:

  • 操作系统:Windows 10(版本 2004 及以上,内部版本 19041 及以上) 或 Windows 11

  • 硬件要求:建议内存 16GB 以上(推荐32GB),以保证后续AI模型运行流畅。

  • 虚拟化支持:需要在 BIOS 中开启 Intel VT-x 或 AMD-V 技术(通常新电脑默认开启,可按需检查)。


第二部分:核心实战——WSL2 安装指南

我们将采用最稳定、最简洁的 命令行 方式进行安装。

第一步:以管理员身份运行 PowerShell

点击 Windows 开始菜单,搜索 “PowerShell” 或 “终端”,右键选择 “以管理员身份运行”

第二步:一键安装 WSL

在 PowerShell 窗口中输入以下命令并回车:

wsl --installwsl --update
这是最简单的方法。此命令会自动执行以下操作:
  1. 启用 WSL 所需的核心功能。

  2. 启用“虚拟机平台”组件。

  3. 将 WSL 2 设置为默认版本。

  4. 自动安装 Ubuntu 发行版(推荐使用 22.04 或 24.04 版本)。

第三步:重启电脑

安装过程结束后,请务必重启你的电脑,让组件生效。

第四步:设置用户名与密码

重启后,系统会自动启动 Ubuntu 终端。

如果没有自动启动,请在开始菜单搜索 “Ubuntu” 并打开。此时你会进入 Linux 环境,需要设置:

  • Username:输入用户名(例如:yourname)。

  • Password:输入密码(注意:输入密码时屏幕不会显示星号,这是Linux的正常安全机制)。


第三部分:优化配置——让龙虾跑得更快

WSL2 虽然强大,但默认会占用较多内存资源。我们需要通过配置文件进行 性能限制,避免电脑卡顿。

1. 配置内存、CPU限制与网络配置

在 Windows 用户文件夹下创建配置文件。

操作步骤:

  1. 打开文件夹路径:%UserProfile% 【C盘,用户文件夹,你的用户名文件夹里面】

  2. 新建一个名为 .wslconfig 的文件(注意文件名以点开头,没有后缀名)。

  3. 用记事本打开,粘贴以下代码:

[wsl2]# 启用镜像网络模式networkingMode=mirrored# 启用 DNS 隧道,避免 VPN 环境下的 DNS 解析问题dnsTunneling=true# 自动使用 Windows 的 HTTP 代理设置autoProxy=true# 启用防火墙集成firewall=true#限制最大使用内存,建议按总物理内存的75%memory=24GB    #限制使用的CPU核心数,建议按总cpi的75%processors=12   [experimental]# 自动回收闲置内存autoMemoryReclaim=gradual# 允许从 WSL 访问 localhost 等回环地址hostAddressLoopback=true

4. 保存文件。

2. 重启 WSL 服务

在 PowerShell 中输入以下命令,使配置生效:

wsl --shutdown

第四部分:环境检验与下一步指引

至此,WSL 环境已完全准备就绪!但为了迎接 OpenClaw,我们还需要在 WSL 的 Ubuntu 系统内部 安装几样关键工具。

打开 Ubuntu 终端,执行以下命令:

1. 更新系统软件源

sudo apt update && sudo apt upgrade -y

2. 安装必要的基础工具

OpenClaw 的安装脚本依赖于 curl 和 git

sudo apt install -y curl git ca-certificates build-essential

3. 准备 Node.js 环境

OpenClaw 运行需要 Node.js 22 或更高版本。建议通过 NodeSource 安装,建议安装Node.js 22(后面装QMD需要这个版本):

# 下载并执行 Node.js 22 安装脚本curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -# 安装 Node.jssudo apt install -y nodejs

安装完成后,验证版本:

node -v# 应输出 v22.x.x 或更高npm -v

以上,大功告成!!!

剩下的部署openclaw,你完全可以用官网的文档,一条命令,丝滑部署:

curl -fsSL https://openclaw.ai/install.sh | bash

使用WSL部署OpenCalw的好处:

1. 原生Linux环境,OpenClaw运行更丝滑。

2. 文件互通,龙虾可以读写windows中的文件,你可以直接在windows环境改龙虾的配置。