这是官方推荐的 Windows 部署方式,提供最完整的 Linux 环境支持。
准备:启用适用于 Linux 的 Windows 子系统和虚拟化平台,重启电脑。

介绍在 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