在 Windows 系统上安装 OpenClaw 时，由于涉及跨系统（WSL）操作，新手极易在“Node.js 路径冲突”、“C盘空间爆满”、“权限报错”和“UI 编译失败”上踩坑。
今天手把手教你：如何把 Ubuntu 安装到非 C 盘，并提供一套绝对不会报错的 OpenClaw 安装与启动流程。
默认情况下，Windows 会把 Linux 子系统（WSL）安装在 C 盘。我们为了节省系统盘空间，必须手动将其迁移到其他盘（例如 D 盘）。
第一步：开启 WSL 功能并下载 Ubuntu
- 1. 打开 PowerShell (管理员身份)：右键点击开始菜单，选择“Windows PowerShell (管理员)”。
- 2. 安装默认的 WSL：输入以下命令并回车：
- 3. powershell
wsl --install- 1. 重启电脑：安装完成后，根据提示重启电脑。重启后，系统通常会自动弹出一个 Ubuntu 窗口要求你设置用户名和密码（请记住它们，后面会用到）。
注意：
如果上面的命令 下载卡住了，进度条一直死死卡在 0.0%，请在当前这个 PowerShell 窗口中，直接按下键盘的 Ctrl + C，强制结束这个卡住的安装进程。
默认的 wsl –install 会通过微软商店的后台通道去下载，经常会卡住。微软后来加入了一个强制走网页直连下载的参数。
中断刚才的命令后，在 PowerShell 中输入下面这个新命令并回车：
powershell
wsl --install --web-download
这个参数能绕过部分微软商店的网络限制，通常能瞬间让进度条动起来。
第二步：将 Ubuntu 迁移到 D 盘 (核心避坑)
此时你的 Ubuntu 还在 C 盘，我们需要把它“打包”移走。
- 1. 关闭所有 Ubuntu 窗口，再次打开 PowerShell。
- 2. 停止 WSL 服务：确保没有任何后台占用。
- 3. powershell
wsl --shutdown- 1. 导出当前的 Ubuntu：将 C 盘的系统打包成一个文件（注意：D:\ 必须存在）。
- 2. powershell
wsl --export Ubuntu D:\Ubuntu_Backup.tar- 1. 注销 C 盘的 Ubuntu：这会释放 C 盘空间。
- 2. powershell
wsl --unregister Ubuntu- 1. 在 D 盘导入并重新注册：我们把系统安装在 D:\WSL\Ubuntu（请提前建好这个文件夹）。
- 2. powershell
wsl --import Ubuntu D:\WSL\Ubuntu D:\Ubuntu_Backup.tar- 1. 设置默认登录用户：导入后默认是 root 用户，我们需要改回你之前设置的用户名（假设你刚才设置的用户名是 zh）。
- 2. powershell
ubuntu config --default-user zh- 1. 清理垃圾：删除刚才导出的压缩包。
- 2. powershell
del D:\Ubuntu_Backup.tar这样你拥有了一个完全运行在 D 盘的纯净 Linux 环境。 请在开始菜单搜索“Ubuntu”并打开它，进入黑色终端（出现类似 zh@hostname:~$ 的提示符）。
配置 Linux 原生开发环境 🛠️
⚠️ 致命警告：千万不要在 WSL 里调用 Windows 安装的 Node.js，这会引发 UNC 路径不受支持 的错误！我们必须在 Ubuntu 内部重新安装。
请在你的 Ubuntu 终端中依次复制并执行以下命令：
安装 Node.js v22 (原生 Linux 版)
bash
# 获取 Node.js v22 官方源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 正式安装
sudo apt install -y nodejs
# 验证版本（必须输出 v22.x.x）
node -v(如果 curl 命令卡住，说明网络不通，请暂时关闭 Windows 代理工具)
安装 pnpm 包管理器 (官方脚本防报错)
不要使用 npm install -g pnpm，那会导致 EACCES 权限错误！
bash
# 使用官方脚本安装
curl -fsSL https://get.pnpm.io/install.sh | sh -
# 刷新终端配置，使其立即生效
source ~/.bashrc安装必要的编译工具 (Git 等)
bash
sudo apt update
sudo apt install -y git build-essential阶段三：获取 OpenClaw 源码并手动构建 🏗️
这是解决 Control UI build failed: exit 1 报错的唯一正确方法。
克隆代码并进入目录
(以下命令会将 OpenClaw 下载到 Ubuntu 的家目录下)
bash
cd ~
git clone https://github.com/OpenClaw/openclaw.git OpenClaw
cd OpenClaw安装项目依赖
bash
npm install手动构建图形界面 (Dashboard)
这是最关键的一步，必须提前编译好网页文件：
bash
pnpm run ui:build(耐心等待进度条走完，看到 ✓ built in… 字样代表构建成功。)
阶段四：启动并访问 OpenClaw (双终端法) 🚀
由于是源码安装，系统无法直接识别 openclaw 这个简写命令。请严格采用以下**“双窗口启动法”**：
步骤 1：启动后端服务器 (Gateway)
- 1. 打开第一个 Ubuntu 终端。
- 2. 进入目录并启动：
- 3. bash
cd ~/OpenClaw
node scripts/run-node.mjs gateway- 1. 不要关闭这个黑窗口！ 等待日志输出 listening on ws://127.0.0.1:18789，说明后端已就绪。
步骤 2：获取控制面板链接 (Dashboard)
- 1. 保持上一个窗口运行，新开第二个 Ubuntu 终端窗口。
- 2. 获取带 Token 的访问链接：
- 3. bash
cd ~/OpenClaw
node scripts/run-node.mjs dashboard- 1. 终端会输出类似这样的一行： Dashboard URL: http://127.0.0.1:18789/#token=xxxxxxxxxxxxxxxxxxx
步骤 3：在浏览器中打开
复制步骤 2 中的完整链接（包括 #token= 及其后面的乱码），直接粘贴到 Windows 的 Chrome 或 Edge 浏览器中访问。
这个完整链接地址请一定要收藏保存，以后就直接打开这个地址进入图形操作界面了
常见问题急救包 (FAQ)
OpenClaw 启动的日常步骤：
1、在 Windows powershell中启动 Ubuntu 输入下面指令
wsl -d Ubuntu进入到你的 Linux 环境
2、进入 OpenClaw 目录 输入下面指令
cd ~/OpenClaw切换到 OpenClaw 项目的根目录
3、启动后端 (Gateway) 输入下面指令
node scripts/run-node.mjs gateway
暂无评论