Openclaw 一键快速安装，八分钟快速安装

适用环境：Windows 10/11 (64位) + WSL2 (Ubuntu)

本方案核心在于提供开箱即用的Ubuntu 20.04预集成环境，已内置Openclaw。你只需下载我们配置好的压缩包，通过WSL一键导入至Windows系统，随后配置你的大模型API与飞书参数，即可立即启用。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

第一步：检查 Windows 系统版本与 WSL 前置条件

部署前，请首先验证你的Windows环境是否满足WSL2运行的最低标准，这能从根本上规避后续的兼容性问题。

1. 检查系统版本

WSL2要求Windows 10版本2004（内部版本19041）或更高，或Windows 11系统。

按此步骤确认：

1. 按下Win + R组合键，在“运行”框中输入winver并回车。
2. 在弹出的窗口中查看详细版本信息。
   • 对于Windows 10，版本号需≥2004。
   • Windows 11系统默认符合要求。

提示：若系统版本过低，请先前往“设置” > “更新和安全”完成Windows更新，再继续后续步骤。

2. 确认虚拟化已开启

WSL2依赖CPU硬件虚拟化支持（Intel VT-x / AMD-V）。

• 多数现代PC在出厂时已默认启用。
• 若安装过程出现相关报错，需重启进入BIOS/UEFI设置界面，手动启用Virtualization Technology或类似选项。

3. 安装Windows平台虚拟化组件

此步骤是启用WSL功能的必要操作。提供两种等效方法：

方法一（推荐）：以管理员身份启动PowerShell，逐行执行以下命令：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
dism.exe /online /enable-feature /featurename:HypervisorPlatform /all /norestart
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

方法二：通过控制面板的【启用或关闭Windows功能】图形界面，勾选“适用于Linux的Windows子系统”和“虚拟机平台”。

完成后，必须重启计算机使所有更改生效。

第二步：安装并更新 WSL2

接下来，我们需要安装WSL2内核更新包，确保其版本为最新，以保证系统稳定与性能。

下载：从微软官方仓库下载对应的 MSI 文件。

获取WSL2内核更新的最快捷径是直接下载安装包：

WSL更新包下载链接

下载完成后，运行MSI文件并按提示完成内核更新安装。

第三步：下载导入安装包，实现一键导入

下载安装包：安装包分三种，根据需要选择合适的

我们提供了三种预设环境包，请根据你的安全与集成需求选择：

1. 基础系统包：纯净Ubuntu 20.04，预装git与Node.js 24.14运行环境。（例如：Ubuntu20.04.tar.gz）
2. 完整环境包：集成Ubuntu 20.04 + Openclaw + Claude code，无需额外安装。（例如：Ubuntu+Openclaw.tar.gz）
3. 沙箱环境包：在完整环境基础上，实施文件系统访问隔离，WSL仅能读写指定的Windows共享文件夹（如 D:/openclaw_file），提升安全性。（例如：Ubuntu+Openclaw_Sandbox.tar.gz）

第四步：一键导入

使用管理员权限的PowerShell，执行以下导入命令。请将命令中的文件路径替换为你实际保存的压缩包路径。

wsl --import Ubuntu-20.04 D:\WSL\system D:\WSL\backup\ubuntu-openclaw.v1.tar

命令解析：将指定路径的压缩包（如ubuntu-openclaw.v1.tar），作为名为“Ubuntu-20.04”的WSL发行版，导入到目标目录D:\WSL\system中。

导入完成后进入Ubuntu系统，配置大模型和飞书通信渠道

导入成功后，进入该系统，完成Openclaw的核心配置，包括大模型API、密钥及飞书机器人的接入设置。

# 登录至刚导入的WSL发行版（确保名称一致）
wsl -d Ubuntu-20.04

# 切换至root账户（Openclaw默认安装用户）并进入其主目录
sudo su -
cd /root

# 运行Openclaw配置向导，并安装守护进程服务
openclaw onboard --install-daemon
openclaw onboard

# 检查网关服务运行状态
openclaw gateway status

重要说明：关闭PowerShell或终端窗口不会停止已启动的Openclaw守护进程服务。但若重启了计算机，则需重新手动启动服务。

开机后，重新进入WSL并运行openclaw gateway start即可恢复服务。

注意：针对不放开openclaw访问权限的沙箱环境安装包，需要配置共享目录

若你选择了“沙箱环境包”，需在Windows端设置一个共享目录供WSL专用（以D:\openclaw_file为例），完成跨系统文件访问配置。

5.1 创建目录

如果目标目录不存在，在PowerShell中执行创建命令，或在资源管理器中手动新建文件夹。

New-Item -ItemType Directory -Force -Path D:\openclaw_file

5.2 配置共享

建议通过图形界面设置文件夹共享，步骤更清晰：

1. 右键点击D:\openclaw_file文件夹。
2. 选择“属性”。
3. 切换至“共享”选项卡。
4. 点击“高级共享”。
5. 勾选“共享此文件夹”。
6. 设置“共享名”为：openclaw_file。
7. 点击“权限”。
8. 出于安全最佳实践，移除“Everyone”组，仅添加你的Windows用户账户并授予“完全控制”权限。

5.3 进入 WSL Linux 系统，创建 SMB 凭据文件

切换到WSL的Ubuntu环境中。创建一个凭据文件，用于存储访问Windows共享所需的认证信息。

执行以下命令，并将name和password替换为你的Windows用户名与密码：

sudo tee /root/.smb-openclaw >/dev/null <<'EOF'
username=name
password=password
EOF
sudo chmod 600 /root/.smb-openclaw

随后，运行环境提供的挂载脚本（如安装时已部署）：

/usr/local/bin/mount-openclaw.sh

5.4 验证挂载是否成功

完成配置后，必须进行双向读写测试以验证共享是否正常：

1. 在Windows的D:\openclaw_file目录下新建文件，检查WSL的/data/openclaw_file目录是否同步出现。
2. 在WSL的共享目录内创建文件，确认Windows端能否立即看到。

你也可以在WSL内使用以下命令进行更深入的沙箱环境验证：

# 1. 验证沙箱隔离是否生效（WSL应无法访问其他Windows驱动器）
# 执行命令：
ls /mnt
ls /mnt/c
ls /mnt/d
# 预期输出：
# `/mnt` 目录下不应自动挂载 `c`、`d`等盘符。
# `ls /mnt/c` 和 `ls /mnt/d` 应返回空或“No such file or directory”。

# 查看系统挂载点列表，确认无自动挂载的Windows分区
mount

# 关键确认：仅有你手动配置的 `/data/openclaw_file` 这一个共享目录可访问。

# 2. 测试挂载功能（可选）
# 手动卸载共享目录
sudo umount /data/openclaw_file
# 重新挂载共享目录
sudo mount /data/openclaw_file