适用环境Windows 10/11 (64位) WSL2 (Ubuntu)原理把目前安装完成Ubuntu20.04版本 Openclaw打包压缩包下载完成后一键导入配置大模型和飞书参数后就可以直接使用。第一步检查 Windows 系统版本与 WSL 前置条件在开始之前我们需要确保你的 Windows 系统满足运行 WSL2 的基本要求。1. 检查系统版本WSL2 需要Windows 10 版本 2004 及以上内部版本 19041或Windows 11。操作方法按下Win R键输入winver并回车。在弹出的窗口中查看版本号。如果是 Windows 10确保版本号 ≥ 2004。如果是 Windows 11通常默认满足条件。注意如果你的版本过低请前往 Windows 设置 - 更新和安全 进行系统更新。2. 确认虚拟化已开启WSL2 依赖 CPU 虚拟化技术Intel VT-x 或 AMD-V。大多数现代电脑默认开启。如果后续安装报错需进入 BIOS/UEFI 设置找到Virtualization Technology并设置为Enabled。3. 安装windows平台虚拟化组件通过管理员打开PowerShell 输入如下命令开启或者通过windows系统开启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/norestartSet-ExecutionPolicyRemoteSigned-Scope CurrentUser或通过【启用或关闭Windows功能】 如下图安装完成后重启电脑第二步安装并更新 WSL2这是最关键的一步我们将启用 WSL 功能并升级到最新的内核确保环境 ready。下载从微软官方仓库下载对应的 MSI 文件。x64 架构: [wsl_update_x64.msi](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi?spm5176.28103460.0.0.96a07551QfqAfrfilewsl_update_x64.msi)下载后完成安装第三步 下载导入安装包一键导入下载安装包安装包分三种 根据需要选择合适的安装仅安装了Ubuntu20.04 git nodeJs 24.14 Ubuntu20.04安装好Ubutu20.04 Openclaw Claue code UbuntuOpenclaw安装好Ubutu20.04 Openclaw Claue code 沙箱环境无法访问windows系统文件可以授权访问挂载 D:/openclaw_file 文件目录 UbuntuOpenclaw第四步 一键导入在管理员权限打开PowerShell 运行以下命令wsl--import Ubuntu-20.04 D:\WSL\system D:\WSL\backup\ubuntu-openclaw.v1.tar导入完成后进入Ubuntu 系统配置 大模型和飞书通信渠道进入就lUbuntu 系统、配置大模型参数、密钥 和 飞书通信渠道# 进入linux 系统wsl-e# 进入root账号、也是openclaw 安装用户目录cd/root# 配置openclawopenclaw onboard--install-daemonopenclaw onboard# 验证网关是否正常openclaw gateway status注意退出linux 和powershell 命令行工具后正常运行在后台程序中关机后会关闭后台程序。开机需要重启注意针对不放开openclaw访问沙箱环境(windows系统文件权限安装包需要配置共享目录在 Windows 中只共享D:\openclaw_file5.1 创建目录如果目录还不存在可在PowerShell中执行 也可以手动在 D 盘创建一个文件夹 openclaw_fileNew-Item -ItemType Directory -Force -Path D:\openclaw_file5.2 配置共享推荐使用 Windows 图形界面完成步骤如下右键D:\openclaw_file选择“属性”打开“共享”选项卡点击“高级共享”勾选“共享此文件夹”共享名填写openclaw_file点击“权限”只保留你自己的 Windows 用户授予需要的权限删除不需要的“Everyone”或其他泛权限账户5.3 进入 WSL linux 创建 SMB 凭据文件把下面命令中的name替换成你的 Windows 用户名password替换成你的 Windows 登录密码执行sudotee/root/.smb-openclaw/dev/nullEOF usernamename passwordpassword EOFsudochmod600/root/.smb-openclaw进入 WSL linux 系统执行如下脚本/usr/local/bin/mount-openclaw.sh5.4 验证挂载是否成功windows D:\openclaw_file 目录创建文件 在 linux 系统 /data/openclaw_file 是否可见在 linux 系统 /data/openclaw_file 创建文件在 D:\openclaw_file 是否可以进入linux环境用如下命令验证共享目前是否配置成功## 1. 验证 WSL 不再访问整盘#执行以下命令ls/mntls/mnt/cls/mnt/d#预期结果# /mnt 下不再自动出现 c、d# ls /mnt/c 和 ls /mnt/d 目录空文件夹\#你也可以再检查当前挂载列表mount#重点确认#没有 C: 或 D: 的自动挂载项# 只有 /data/openclaw_file 这个白名单目录可用# 手动卸载共享目录sudoumount/data/openclaw_file#重新挂载共享目录sudomount/data/openclaw_file
Openclaw 一键快速安装，八分钟快速安装
适用环境Windows 10/11 (64位) WSL2 (Ubuntu)原理把目前安装完成Ubuntu20.04版本 Openclaw打包压缩包下载完成后一键导入配置大模型和飞书参数后就可以直接使用。第一步检查 Windows 系统版本与 WSL 前置条件在开始之前我们需要确保你的 Windows 系统满足运行 WSL2 的基本要求。1. 检查系统版本WSL2 需要Windows 10 版本 2004 及以上内部版本 19041或Windows 11。操作方法按下Win R键输入winver并回车。在弹出的窗口中查看版本号。如果是 Windows 10确保版本号 ≥ 2004。如果是 Windows 11通常默认满足条件。注意如果你的版本过低请前往 Windows 设置 - 更新和安全 进行系统更新。2. 确认虚拟化已开启WSL2 依赖 CPU 虚拟化技术Intel VT-x 或 AMD-V。大多数现代电脑默认开启。如果后续安装报错需进入 BIOS/UEFI 设置找到Virtualization Technology并设置为Enabled。3. 安装windows平台虚拟化组件通过管理员打开PowerShell 输入如下命令开启或者通过windows系统开启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/norestartSet-ExecutionPolicyRemoteSigned-Scope CurrentUser或通过【启用或关闭Windows功能】 如下图安装完成后重启电脑第二步安装并更新 WSL2这是最关键的一步我们将启用 WSL 功能并升级到最新的内核确保环境 ready。下载从微软官方仓库下载对应的 MSI 文件。x64 架构: [wsl_update_x64.msi](https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi?spm5176.28103460.0.0.96a07551QfqAfrfilewsl_update_x64.msi)下载后完成安装第三步 下载导入安装包一键导入下载安装包安装包分三种 根据需要选择合适的安装仅安装了Ubuntu20.04 git nodeJs 24.14 Ubuntu20.04安装好Ubutu20.04 Openclaw Claue code UbuntuOpenclaw安装好Ubutu20.04 Openclaw Claue code 沙箱环境无法访问windows系统文件可以授权访问挂载 D:/openclaw_file 文件目录 UbuntuOpenclaw第四步 一键导入在管理员权限打开PowerShell 运行以下命令wsl--import Ubuntu-20.04 D:\WSL\system D:\WSL\backup\ubuntu-openclaw.v1.tar导入完成后进入Ubuntu 系统配置 大模型和飞书通信渠道进入就lUbuntu 系统、配置大模型参数、密钥 和 飞书通信渠道# 进入linux 系统wsl-e# 进入root账号、也是openclaw 安装用户目录cd/root# 配置openclawopenclaw onboard--install-daemonopenclaw onboard# 验证网关是否正常openclaw gateway status注意退出linux 和powershell 命令行工具后正常运行在后台程序中关机后会关闭后台程序。开机需要重启注意针对不放开openclaw访问沙箱环境(windows系统文件权限安装包需要配置共享目录在 Windows 中只共享D:\openclaw_file5.1 创建目录如果目录还不存在可在PowerShell中执行 也可以手动在 D 盘创建一个文件夹 openclaw_fileNew-Item -ItemType Directory -Force -Path D:\openclaw_file5.2 配置共享推荐使用 Windows 图形界面完成步骤如下右键D:\openclaw_file选择“属性”打开“共享”选项卡点击“高级共享”勾选“共享此文件夹”共享名填写openclaw_file点击“权限”只保留你自己的 Windows 用户授予需要的权限删除不需要的“Everyone”或其他泛权限账户5.3 进入 WSL linux 创建 SMB 凭据文件把下面命令中的name替换成你的 Windows 用户名password替换成你的 Windows 登录密码执行sudotee/root/.smb-openclaw/dev/nullEOF usernamename passwordpassword EOFsudochmod600/root/.smb-openclaw进入 WSL linux 系统执行如下脚本/usr/local/bin/mount-openclaw.sh5.4 验证挂载是否成功windows D:\openclaw_file 目录创建文件 在 linux 系统 /data/openclaw_file 是否可见在 linux 系统 /data/openclaw_file 创建文件在 D:\openclaw_file 是否可以进入linux环境用如下命令验证共享目前是否配置成功## 1. 验证 WSL 不再访问整盘#执行以下命令ls/mntls/mnt/cls/mnt/d#预期结果# /mnt 下不再自动出现 c、d# ls /mnt/c 和 ls /mnt/d 目录空文件夹\#你也可以再检查当前挂载列表mount#重点确认#没有 C: 或 D: 的自动挂载项# 只有 /data/openclaw_file 这个白名单目录可用# 手动卸载共享目录sudoumount/data/openclaw_file#重新挂载共享目录sudomount/data/openclaw_file
