OpenClaw Windows电脑零基础防坑完美安装详细教程与运行指南

大家好，我是张少！

在 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 updatesudo 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 OpenClawcd OpenClaw

安装项目依赖

bash

npm install

手动构建图形界面 (Dashboard)

这是最关键的一步，必须提前编译好网页文件：

bash

pnpm run ui:build

(耐心等待进度条走完，看到 ✓ built in... 字样代表构建成功。)

阶段四：启动并访问 OpenClaw (双终端法) 🚀

由于是源码安装，系统无法直接识别 openclaw 这个简写命令。请严格采用以下**“双窗口启动法”**：

步骤 1：启动后端服务器 (Gateway)

1. 打开第一个 Ubuntu 终端。
2. 进入目录并启动：
3. bash

cd ~/OpenClawnode scripts/run-node.mjs gateway

1. 不要关闭这个黑窗口！等待日志输出 listening on ws://127.0.0.1:18789，说明后端已就绪。

步骤 2：获取控制面板链接 (Dashboard)

1. 保持上一个窗口运行，新开第二个 Ubuntu 终端窗口。
2. 获取带 Token 的访问链接：
3. bash

cd ~/OpenClawnode 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

大家如有不懂的，请欢迎留言交流