2026年OpenClaw 最终安装指南：Windows 下用 WSL2 + Ubuntu 跑通源码版

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

这篇文章不是"照着官方文档抄一遍"，而是一份真正走通过、踩过坑、最后收敛出的最终推荐流程。

这次在 Windows 上安装源码版，前后遇到了几类很典型的问题：

Windows 原生环境跑构建脚本不稳定
默认占用盘
不会自动继承 Windows 代理
在下跑容易遇到权限和文件锁问题
安装完成后，还要区分、、之间的关系

所以这篇文章的目标不是"记录过程"，而是给出一套以后重装也能直接照做的最终版本。

如果你想在 Windows 上稳定运行源码版，推荐路线是：

Windows 只负责宿主系统
用提供 Linux 运行环境
把 Ubuntu 迁移到盘，避免长期吃掉盘
在 Ubuntu 中安装和
把 OpenClaw 仓库同步到 WSL 的 Linux 文件系统
在 WSL 本地目录里执行
日常使用时先启动，再通过 Dashboard 或 TUI 访问

理论上你可以在 Windows 里直接跑：

 但实际很容易遇到：

脚本依赖
某些依赖在 Windows 原生环境兼容性一般
容易被编辑器、索引器、杀毒同时占用
报错形态复杂，比如：

管理员 PowerShell 执行：

如果提示重启，就先重启电脑。

如果提示虚拟化问题，需要进入 BIOS 打开：

Intel：
AMD：

正常可以先尝试：

GPT plus 代充 只需 145 如果这一步因为联网问题失败，但开始菜单里已经出现 图标，也可以直接点击图标初始化。

第一次进入 Ubuntu 时，会提示你创建：

Linux 用户名
Linux 密码（这里有保护机制，只管输入后回车就行，不记得了就删除重新输入后回车）

确认安装成功：

 看到类似：
 就说明 Ubuntu 已经正常跑在 上。

这一点强烈建议不要省略。

WSL 默认会把 Ubuntu 放在盘用户目录下，并创建一个虚拟磁盘文件。随着后续安装依赖、缓存、构建，它会持续长大。

如果你的盘空间本来就不富余，最好在 Ubuntu 初始化成功后立刻迁移到盘。

执行：

GPT plus 代充 只需 145 如果导入后默认用户变成 root

进入 Ubuntu 后执行：

 如果输出是 ，把默认用户改回你自己的普通账户。假设用户名是 ：
 然后回到 PowerShell：
 再次确认：
 如果输出已经是你的普通用户名，说明 Ubuntu 已经成功迁移到 盘并修复了默认用户。

在 Ubuntu 中执行：

GPT plus 代充 只需 145 这一步里最值得注意的是 ，后面同步仓库会用到。

这次实际安装过程中，因为访问 GitHub Raw 失败不稳定，所以最终最稳的方案是用：

 仓库只要求：
 因此 完全满足要求。

最省事的方式：

GPT plus 代充 只需 145 实际安装中，拿到 也可以正常继续使用，不必强行纠结一定要和锁文件版本完全一致。

这是整个安装过程中最关键的一条经验。

如果你在下面这种路径直接跑：

 很容易遇到：
 根本原因通常不是简单的"没权限"，而是：

项目在 Windows 文件系统里
在 WSL 中安装依赖
编辑器、杀毒、索引器、Windows 文件锁可能同时干扰

因此最终推荐做法是：

Windows 上保留源码副本，真正安装和构建时，把仓库同步到 WSL 自己的 Linux 文件系统中。

如果 Windows 上已经有仓库，不需要再一遍，直接同步：

这样做有两个好处：

避开 GitHub clone 网络不稳定的问题
避免把 Windows 侧残缺或损坏的一起带过来

这一点也非常重要。

很多人会发现：

Windows 浏览器可以正常访问外网
代理软件一直开着
但 WSL 里的、、还是访问 GitHub 失败

如果你的代理软件本地提供：

那么在 Ubuntu 中应优先配置 HTTP 代理。

先获取 Windows 主机在 WSL 中的地址：

然后设置代理：

测试：

如果还不通

大概率要去 Windows 代理软件里打开：

否则 WSL 访问不到宿主机的代理端口。

在以下前提都满足后：

Ubuntu 已迁移到盘
Node 和 pnpm 已安装
仓库已同步到
代理已验证可访问 GitHub 和 codeload

执行：

完成后运行引导：

第一次安装，建议尽量走最简路线。

推荐选择如下：

安全确认：
模式：
默认模型：
聊天渠道：
搜索提供商：
Skills：
Hooks：

这样最适合第一次先跑通系统，而不是一上来把所有能力全配完。

安装完成后，很多人会误以为、Dashboard 或 CLI 自己就能直接工作。

实际上，的日常使用方式应该分成两层：

1. 先启动 gateway （18789 是我这边代理的端口，根据自己代理端口自行调整）

进入仓库：

这个终端要保持开着，因为它就是后台服务。

2. 再打开访问入口

你有两个常见入口：

浏览器 Dashboard

在 Windows 浏览器打开：

如果需要 token，就用 onboarding 给出的完整链接。

终端 UI

新开一个 Ubuntu 终端，执行：

如果你先开，但没启动，就会看到：

这不是安装失败，只是顺序错了。

因为你现在跑的是源码仓库模式，不是全局 npm 安装模式。

所以优先使用：

而不是直接执行：

这是另一个很容易误解的点。

如果你直接执行：

它可能会报要你传：

这不是环境有问题，而是命令本身需要你明确指定会话目标。

第一次上手时，不建议从 CLI 裸命令开始，更推荐：

先用 Dashboard
或者用

这通常不是自己挂了，而更像是你当前模型提供商的限流提示，比如侧请求过快。

出现这种情况时建议：

关闭多余测试窗口
不要连续刷新和重试
等几十秒再发一条短消息

这类问题一般属于模型侧限流，不是本地 gateway 安装失败。

如果你以后要在另一台 Windows 机器上重装，照下面这套最短流程就行。

Windows 管理员 PowerShell

Ubuntu 初始化成功后迁移到 D 盘

Ubuntu 中安装基础环境

同步仓库到 WSL 本地目录

配代理

安装和构建 OpenClaw

日常启动

如果你当前在 Windows 桌面环境里，建议先打开，然后进入 Ubuntu：

GPT plus 代充 只需 145 进入 Ubuntu 后，再启动 OpenClaw gateway：
 最后回到 Windows 浏览器访问：

最后把最关键的经验再压缩成三句：

OpenClaw 源码版在 Windows 上最稳的跑法是 WSL，不是原生 PowerShell
不要在下直接跑，要把项目放到 WSL 本地目录
Windows 开代理不等于 WSL 自动能用，WSL 必须单独配置代理

如果你只想记住一句话，那就是：

Windows 提供系统，WSL 提供 Linux 环境，OpenClaw 项目放在 WSL 本地目录里，代理单独配，日常先起 gateway，再开 Dashboard。

按这套流程走，基本就能避开这次安装中遇到的大多数坑。