Windowns系统WSL2 Ubuntu 方式部署Openclaw

Ne0inhk

15 Mar 2026 — 10 min read

这是官方推荐的 Windows 部署方式，提供最完整的 Linux 环境支持。

准备：启用适用于Linux的Windows子系统和虚拟化平台，重启电脑。

1. 启用 WSL2

以管理员

身份打开 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

2. 安装 Ubuntu

方法1 ：Microsoft Store 安装（推荐）

打开 Microsoft Store
搜索「Ubuntu 24.04 LTS」
点击「获取」并安装

安装完成后会自动打开 Ubuntu 终端，按提示设置用户名和密码。

方法2 ：wsl命令安装

wsl --install -d Ubuntu-24.04

部分电脑报错无法解析服务器的名称或地址

解决方案

打开 /C:\Windows\System32\drivers\etc文件，添加IP domain的对，如图：

在IPaddress中搜索查看IP

启动Ubuntu 24.04 LTS

部分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中输入密码时没有任何显示，直接输入完成回车即可

WSL内核更新

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 系统

在 Ubuntu 终端中执行：

# 更新软件包列表

sudo apt update && sudo apt upgrade -y

sudo apt install -y curl git wget build-essential

安装 Node.js 22+

# 添加 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

安装 OpenClaw

一键脚本安装

curl -fsSL https://openclaw.ai/install.sh | bash

通过左右方向键切换 Yes/No 选项，选择 Yes 即表示已了解 OpenClaw 权限相关风险，同意继续配置。

选择Yes

进入 Onboarding mode 选择界面时，对于首次配置的用户，建议优先选择 QuickStart 模式——该模式以「最小配置+最快部署」为目标，可跳过非必要配置项，快速完成 OpenClaw 基础部署。

◆Model/auth provide

配置要使用的模型，可以在这里直接配置，也可以后续通过配置文件处理。

因为笔者使用 moonshot 国内模型，但是 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状态

http://127.0.0.1:18789/#token=d3f44d798d67a145cbcb0caa5aa9b02de9fdad623384039c

本地模型配置步骤：

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）：

bash

ip route show | grep default | awk '{print $3}'

这会输出 Windows 宿主机在 WSL2 网络中的真实网关 IP，大概率是 172.24.64.1 或类似（就是 Windows 的 vEthernet (WSL) 网卡 IP）。

然后用这个 IP 测试：bash

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窗口打开）。

设置完成