介绍在 Windows 系统下通过 WSL2 和 Ubuntu 部署 OpenClaw 的步骤。包括启用 WSL2 功能、安装 Ubuntu 24.04 LTS、更新系统及 Node.js 环境。使用脚本安装 OpenClaw 后，配置网关 Token 及模型服务。针对本地模型需设置 Ollama 监听所有接口并获取宿主机 IP 连接，或配置云端 API。最后演示通过任务计划程序实现 Ubuntu 开机自启。
这是官方推荐的 Windows 部署方式，提供最完整的 Linux 环境支持。
准备：启用适用于 Linux 的 Windows 子系统和虚拟化平台，重启电脑。
以管理员身份打开 PowerShell，执行：
# 启用 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 内核更新解决
wsl --set-default-version 2
方法 1：Microsoft Store 安装（推荐）
安装完成后会自动打开 Ubuntu 终端，按提示设置用户名和密码。
wsl --install -d Ubuntu-24.04
部分电脑报错无法解析服务器的名称或地址
解决方案
/C:\Windows\System32\drivers\etc 文件，添加 IP domain 的对，如图：在 ipaddress.com 中搜索查看 IP
部分 windows 安装 ubuntu 时，报错：Installing, this may take a few minutes... WslRegisterDistribution failed with error: 0x8007019e Error: 0x8007019e ??????? Linux ? Windows ????
这个报错 0x8007019e 通常是因为在安装 Ubuntu 之前，没有先开启 Windows 的**'适用于 Linux 的 Windows 子系统 (WSL)'**功能。
在 PowerShell 中执行如下命令，然后重启电脑即可
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
重启完成后重新打开 Ubuntu 24.04 LTS
首次启动设置用户名和密码，注意在 ubuntu 中输入密码时没有任何显示，直接输入完成回车即可
1. 在 PowerShell 中管理员身份运行，执行：
wsl --update
如果出现 wsl --update 卡在 0% 问题
解决方法 1：依次执行如下命令
# 停止 Windows Update 服务
net stop wuauserv
# 重新启动服务
net start wuauserv
**解决方法 2：**强制从网络获取最新更新
wsl --update --web-download
2. 执行版本转换命令
现在，运行转换命令。同样在 PowerShell 中，输入
wsl --set-version Ubuntu-24.04 2
查看版本
wsl -l -v
在 Ubuntu 终端中执行：
# 更新软件包列表
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git wget build-essential
# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装 Node.js
sudo apt install -y nodejs
# 验证版本（必须 ≥ 22.x）
node -v
npm -v
一键脚本安装
curl -fsSL https://openclaw.ai/install.sh | bash
通过左右方向键切换 Yes/No 选项，选择 Yes 即表示已了解 OpenClaw 权限相关风险，同意继续配置。
选择 Yes
进入 Onboarding mode 选择界面时，对于首次配置的用户，建议优先选择 QuickStart 模式——该模式以「最小配置 + 最快部署」为目标，可跳过非必要配置项，快速完成 OpenClaw 基础部署。
◆Model/auth provide
配置要使用的模型，可以在这里直接配置，也可以后续通过配置文件处理。
由于国内模型接口限制，OpenClaw 的配置是国际的会导致接口地址错误，所以建议先选择
Skip for now跳过大模型配置，后面再单独设置要使用的模型即可。
保持默认选择 All providers，回车即可
Default model
进入 Default model 选择界面时可任意选择一个模型临时占位——该配置后续将通过修改配置文件覆盖，不影响最终使用效果，保持默认选择 Keep current，回车即可
◆Select channel (QuickStart)
配置要使用的对话应用，如果用飞书，按要求填参数即可。这里可选
Skip for now，先跳过选择，后面笔者会单独用一节内容讲解怎么配置。
◇ Skills status
配置技能，可以选
No，根据提示安装一些常用的工具。
按空格选中 Skip for now
最后查看界面输出的信息，将这些信息保存下来。
安装完成
此时执行 openclaw 指令提示'openclaw: command not found'，依次执行如下指令添加 openclaw 到系统环境变量
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
查看 gateway 状态
Ollama 默认只监听 127.0.0.1，没监听这个虚拟网卡的 IP
第一步：Windows 上设置环境变量，让 Ollama 监听所有接口
以管理员身份打开 PowerShell，执行：
setx OLLAMA_HOST "0.0.0.0" /M
重启 Ollama（任务栏右下角小羊驼图标 → 右键 Quit → 重新从开始菜单启动）。
在 powershell 命令行执行：
netstat -an | findstr 11434
如果看到 0.0.0.0:11434 或 :::11434 处于 LISTENING，就成功了。
如果只有 127.0.0.1:11434，说明没生效，重启电脑即可。
第二步：WSL2 里用正确的宿主机 IP 测试
在 WSL2 Ubuntu 中执行（这才是你该用的 IP，不是 172.24.64.1）：
ip route show | grep default | awk '{print $3}'
这会输出 Windows 宿主机在 WSL2 网络中的真实网关 IP，大概率是 172.24.64.1 或类似（就是 Windows 的 vEthernet (WSL) 网卡 IP）。
然后用这个 IP 测试：
curl http://172.28.240.1:11434/api/tags # 把 IP 换成你上面查到的
{
"wizard": {
"lastRunAt": "2026-02-19T08:45:16.629Z",
"lastRunVersion": "2026.2.17",
"lastRunCommand": "onboard",
"lastRunMode": "local"
},
"agents": {
"defaults": {
"model": {
"primary": "ollama/qwen3:8b",
"fallbacks": ["openai/gpt-5.1-codex"]
},
"models": {
"ollama/qwen3:8b": {},
"openai/gpt-5.1-codex": {"alias": "GPT"}
},
"workspace": "/home/rgzn/.openclaw/workspace",
"compaction": {"mode": "safeguard"},
"maxConcurrent": 4,
"subagents": {"maxConcurrent": 8}
}
},
"messages": {"ackReactionScope": "group-mentions"},
"commands": {"native": "auto", "nativeSkills": "auto"},
"gateway": {
"port": 18789,
"mode": "local",
"bind": "loopback",
"auth": {
"mode": "token",
"token": "d3f44d798d67a145cbcb0caa5aa9b02de9fdad623384039c"
},
"tailscale": {"mode": "off", "resetOnExit": false},
"nodes": {
"denyCommands": ["camera.snap", "camera.clip", "screen.record", "calendar.add", "contacts.add", "reminders.add"]
}
},
"meta": {
"lastTouchedVersion": "2026.2.17",
"lastTouchedAt": "2026-02-19T08:45:16.638Z"
},
"models": {
"providers": {
"ollama": {
"baseUrl": "http://172.28.240.1:11434/v1",
"apiKey": "ollama-local",
"api": "openai-completions",
"models": [{
"id": "qwen3:8b",
"name": "Qwen3 8B",
"reasoning": false,
"input": ["text"],
"cost": {"input": 0, "output": 0},
"contextWindow": 131072,
"maxTokens": 8192
}]
}
}
}
}
如下图将 token 替换之前截图保存的
如下图将 workspace 中的 rgzn 替换成对应的名称（命令行@前的内容）
如下图将 baseUrl 中 IP 地址修改上面查询到的
执行如下命令进入配置文件目录
cd ~/.openclaw
备份 openclaw.json 配置文件，执行如下指令:
mv openclaw.json openclaw.json.bak
执行如下命令修改
nano openclaw.json
如需调用云端 deepseek 的 api 配置方式如下：
nano ~/.openclaw/openclaw.json
{
"meta": {
"lastTouchedVersion": "2026.2.9",
"lastTouchedAt": "2026-02-12T00:45:51.950Z"
},
"wizard": {
"lastRunAt": "2026-02-12T00:45:51.943Z",
"lastRunVersion": "2026.2.9",
"lastRunCommand": "configure",
"lastRunMode": "local"
},
"agents": {
"defaults": {
"model": {
"primary": "deepseek/deepseek-chat",
"fallbacks": ["openai/gpt-5.1-codex"]
},
"models": {
"deepseek/deepseek-chat": {},
"openai/gpt-5.1-codex": {"alias": "GPT"}
},
"workspace": "/home/syh/.openclaw/workspace",
"compaction": {"mode": "safeguard"},
"maxConcurrent": 4,
"subagents": {"maxConcurrent": 8}
}
},
"messages": {"ackReactionScope": "group-mentions"},
"commands": {"native": "auto", "nativeSkills": "auto"},
"gateway": {
"port": 18789,
"mode": "local",
"bind": "loopback",
"auth": {
"mode": "token",
"token": "66682db26fe6f1693570085e2009c52bf8a688901aa542fc"
},
"tailscale": {"mode": "off", "resetOnExit": false},
"nodes": {
"denyCommands": ["camera.snap", "camera.clip", "screen.record", "calendar.add", "contacts.add", "reminders.add"]
}
},
"skills": {
"install": {"nodeManager": "npm"}
},
"tools": {
"web": {
"search": {"enabled": false},
"fetch": {"enabled": true}
}
},
"models": {
"providers": {
"deepseek": {
"baseUrl": "https://api.deepseek.com/v1",
"apiKey": "填入你的 API KEY",
"api": "openai-completions",
"models": [{
"id": "deepseek-chat",
"name": "DeepSeek Chat",
"reasoning": false,
"input": ["text"],
"cost": {"input": 0.14, "output": 0.28},
"contextWindow": 128000,
"maxTokens": 4096
}]
}
}
}
}
可以运行以下 PowerShell 命令，查看 AUMID 备用
Get-StartApps | Where-Object { $_.Name -like "*Ubuntu*" }
点击创建基本任务
任务命名（名称随意）
选择'计算机启动时'
默认'启动程序'即可
程序或脚本：
explorer.exe
添加参数（红色字体替换成前面查到的 AUMID）：shell:AppsFolder\CanonicalGroupLimited.Ubuntu24.04LTS_79rhkp1fndgsc!ubuntu2404
点击完成
右键点击任务，点击运行（应该看到 ubuntu 窗口打开）。
设置完成
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online