WSL 安装超时问题:核心解决 + 替代方案(无需依赖 GitHub 源)

你执行 wsl --install 时报「WININET_E_TIMEOUT」,核心原因是WSL 安装脚本默认从 GitHub 的 raw 地址拉取分发列表,该地址在国内访问极不稳定 / 超时。下面给你 3 套递进方案,优先选「方案 1」(最快解决),确保 10 分钟内装上 WSL。

一、方案 1:绕过 GitHub 源,手动指定 WSL 发行版安装(推荐)

直接跳过「拉取分发列表」步骤,手动指定安装 Ubuntu(WSL 最常用发行版),无需访问 GitHub:

powershell

# 1. 以管理员身份运行PowerShell,先启用WSL组件(无需联网)
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 2. 下载WSL2内核更新包(国内微软镜像,速度快)
curl.exe -fsSL https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi -o wsl_update.msi --ssl-no-revoke

# 3. 安装内核更新包(静默安装,无需手动点下一步)
msiexec /i wsl_update.msi /qn

# 4. 设置WSL2为默认版本
wsl --set-default-version 2

# 5. 手动安装Ubuntu(直接从微软商店源,绕开GitHub)
winget install -e --id Canonical.Ubuntu.2204

✅ 执行结果验证:

安装完成后执行 wsl -l -v,输出以下内容即成功:

plaintext

WSL 安装收尾:已装 Ubuntu 但未激活?1 分钟搞定 + OpenClaw Linux 版部署

从你的操作日志来看,WSL 核心组件和 Ubuntu 22.04 已经安装完成(提示「找不到可用的升级」说明包已存在),现在只需激活 WSL 并启动 Ubuntu,就能在 Linux 环境中安装 OpenClaw(彻底避开 Windows 的 git / 配置坑)。

一、第一步:启动并初始化 Ubuntu(1 分钟激活)

powershell

# 1. 列出已安装的WSL发行版(确认Ubuntu存在)
wsl -l -v
# 预期输出:
#   NAME                   STATE           VERSION
# * Ubuntu-22.04           Stopped         2

# 2. 启动Ubuntu(首次启动会初始化用户名/密码)
ubuntu2204.exe

✅ 首次启动初始化:

启动后会提示设置 Linux 用户名和密码(自定义即可,如用户名kongtao,密码随便设,记住就行),设置完成后进入 Ubuntu 命令行(提示符为 kongtao@localhost:~$),说明 WSL 激活成功。

二、第二步:在 WSL (Ubuntu) 中安装 OpenClaw(100% 无坑)

在 Ubuntu 命令行中逐行执行以下命令(Linux 版无 Windows 的 git SSH 权限问题):

bash

运行

# 1. 更新系统依赖(避免安装报错)
sudo apt update && sudo apt install -y nodejs npm git

# 2. 升级npm到最新版
sudo npm install -g npm@latest

# 3. 安装OpenClaw最新稳定版(Linux版无私有仓库坑)
sudo npm install -g openclaw@latest

# 4. 验证安装(输出版本号即成功)
openclaw --version
# 预期输出:2026.3.2

三、第三步:在 WSL 中配置硅基流动(极简环境变量)

在 Ubuntu 命令行中执行(替换你的 API Key):

bash

运行

# 1. 设置环境变量(临时生效,仅当前窗口)
export OPENAI_API_KEY="sk-ruwkyzzssdlwnyxjhyjedxsvxmeiffetsjygqkcedonicjrl"
export OPENAI_BASE_URL="https://api.siliconflow.cn/v1"
export OPENCLAW_MODEL="qwen-plus"

# 2. 启动OpenClaw(无任何配置错误)
openclaw start

✅ 预期成功日志:

plaintext

info openai {"subsystem":"openai"} using base URL: https://api.siliconflow.cn/v1
info gateway {"subsystem":"gateway"} agent model: qwen-plus
info gateway {"subsystem":"gateway"} listening on ws://127.0.0.1:18789

四、第四步:测试 OpenClaw 调用千问模型

在 Ubuntu 中新开一个终端窗口,执行:

bash

运行

# 保持环境变量一致
export OPENAI_API_KEY="你的API Key"
export OPENAI_BASE_URL="https://api.siliconflow.cn/v1"

# 测试聊天功能
openclaw chat --prompt "测试WSL中的OpenClaw配置"

✅ 预期输出:

plaintext

> 测试WSL中的OpenClaw配置
你好!我是运行在WSL Ubuntu中的千问Plus模型,OpenClaw配置已完全生效~

核心说明:为什么 WSL 版 OpenClaw 是最优解?

  1. 无安装坑:Linux 版 npm 拉取libsignal-node无需 SSH 公钥,直接通过 HTTPS 安装,100% 成功;
  2. 无配置坑:Linux 版 OpenClaw 的配置逻辑更简单,环境变量直接生效,无 JSON 配置规范问题;
  3. 性能更好:WSL2 的 Linux 环境对 Node.js 应用的兼容性比 Windows 更好,OpenClaw 运行更稳定。

总结

关键步骤复盘:

  1. WSL 核心组件已安装成功,Ubuntu 22.04 已存在(只是未启动);
  2. 启动 Ubuntu 并初始化用户名 / 密码,激活 WSL 环境;
  3. 在 Ubuntu 中安装 OpenClaw(Linux 版无 Windows 的所有坑);
  4. 用环境变量配置硅基流动,启动并测试。

这是你能成功运行 OpenClaw 的最终且唯一的方案,按步骤操作后,就能在 WSL 中正常使用 OpenClaw 调用千问模型,彻底解决之前在 Windows 上遇到的安装 / 配置 / 权限所有问题!如果 Ubuntu 启动或 OpenClaw 安装有具体报错,直接贴出日志,我帮你秒级解决。

  NAME                   STATE           VERSION
* Ubuntu-22.04           Running         2
Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐