这是官方推荐的 Windows 部署方式，能提供完整的 Linux 环境支持。
第一步：启用 WSL2 与虚拟化平台
首先需要在 Windows 上开启必要的功能。以管理员身份打开 PowerShell，依次执行以下命令启用 WSL 和虚拟机平台：
# 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
# 启用虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
执行完成后，将 WSL 默认版本设置为 2：
wsl --set-default-version 2
注意：部分电脑此步可能报错，暂时忽略即可，后续通过内核更新解决。
第二步：安装 Ubuntu
推荐方式：Microsoft Store 安装
- 打开 Microsoft Store。
- 搜索「Ubuntu 24.04 LTS」。
- 点击获取并安装。
安装完成后会自动打开终端，按提示设置用户名和密码。
备选方式：命令行安装 如果商店下载失败，可直接在 PowerShell 运行：
wsl --install -d Ubuntu-24.04
若遇到无法解析服务器名称的错误，需修改 hosts 文件。打开 C:\Windows\System32\drivers\etc 下的 hosts 文件，添加 GitHub 的 IP 映射（可在 ipaddress.com 查询）。
首次启动 Ubuntu 时，输入密码不会显示字符，直接输入回车即可。
第三步：WSL 内核更新与系统初始化
在 PowerShell 中执行以下命令更新 WSL 内核：
wsl --update
如果遇到卡在 0% 的情况，可尝试停止并重启 Windows Update 服务，或使用强制下载模式：
net stop wuauserv
net start wuauserv
# 或者
wsl --update --web-download
接着转换 Ubuntu 版本为 WSL 2：
wsl --set-version Ubuntu-24.04 2
进入 Ubuntu 终端后，先更新系统并安装基础工具：
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git wget build-essential
第四步：安装 Node.js 环境
OpenClaw 基于 Node.js，建议安装 22.x 及以上版本：
# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装 Node.js
sudo apt install -y nodejs
# 验证版本
node -v
npm -v
第五步：一键安装 OpenClaw
使用官方脚本进行安装：
curl -fsSL https://openclaw.ai/install.sh | bash
安装过程中会弹出配置向导：
- 权限确认：选择 Yes 表示同意风险。
- Onboarding 模式：新手建议选择 QuickStart，跳过非必要配置项快速完成。
- 模型配置：国内用户若使用 Moonshot 等模型，接口地址可能与默认不同，建议先选
Skip for now，后续单独配置。 - 通道选择：如飞书集成可按需填写，也可暂选 Skip。
- 技能状态：根据提示安装常用工具，或选 Skip。
安装完成后，若提示 command not found，需手动配置环境变量：
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
此时执行 openclaw 指令应能正常运行，网关默认监听在 http://127.0.0.1:18789。
第六步：本地模型 Ollama 配置
Ollama 默认只监听 localhost，需修改配置允许外部访问。
1. Windows 端设置环境变量 以管理员身份打开 PowerShell：
setx OLLAMA_HOST "0.0.0.0" /M
重启 Ollama 服务（任务栏小羊驼图标右键 Quit 后重新从开始菜单启动）。验证端口是否监听所有接口：
netstat -an | findstr 11434
若看到 0.0.0.0:11434 或 :::11434 处于 LISTENING 状态即成功。
2. WSL2 端获取宿主机 IP 在 Ubuntu 中执行以下命令获取 Windows 在 WSL 网络中的真实网关 IP：
ip route show | grep default | awk '{print $3}'
通常结果为 172.x.x.x 格式。使用该 IP 测试连通性：
curl http://<你的网关IP>:11434/api/tags
第七步：修改配置文件
编辑配置文件以绑定正确的模型地址和 Token。
cd ~/.openclaw
mv openclaw.json openclaw.json.bak
nano openclaw.json
主要修改以下几点：
- Token：替换为你安装时保存的 Token。
- Workspace：路径中的用户名需改为当前实际用户名。
- BaseUrl：将 Ollama 的地址改为上述获取的网关 IP。
云端 API 配置示例（如 DeepSeek）：
{
"models": {
"providers": {
"deepseek": {
"baseUrl": "https://api.deepseek.com/v1",
"apiKey": "填入你的 API KEY",
"api": "openai-completions"
}
}
}
}
第八步：设置开机自动启动
为了让 Ubuntu 随系统启动，可使用任务计划程序：
- 查找 Ubuntu 应用的 AUMID：
Get-StartApps | Where-Object { $_.Name -like "*Ubuntu*" } - 创建基本任务，触发器设为'计算机启动时'。
- 操作类型选'启动程序'，程序填
explorer.exe。 - 参数填：
shell:AppsFolder\CanonicalGroupLimited.Ubuntu24.04LTS_79rhkp1fndgsc!ubuntu2404（请替换为你实际的 AUMID）。
完成上述步骤后，重启电脑即可自动进入环境。
