OpenClaw Docs CN

安装部署 / Windows

Windows(WSL2 推荐)

Windows + WSL2

Windows 用户照这一条路走,成功率最高。

这篇只讲一条最稳的 Windows 安装路线:先装 WSL2,再在 Ubuntu 里安装 OpenClaw。如果你是第一次碰命令行,也没关系,下面就是按顺序一步一步做的版本。

Windows 主推荐路线 15-30 分钟 适合第一次安装
Before You Start

开始前先知道两件事

你先把这两点记住,后面就不会总想绕回原生 Windows 去折腾。

不是 Windows 不能装 而是 OpenClaw 在 Windows 上最稳的方式,是让 CLI 和 Gateway 跑在 WSL2 里的 Linux 环境中。
你看到的是 Ubuntu 终端,不是原生 CMD 后面安装、onboarding、打开 Dashboard,都尽量在 Ubuntu 终端里完成,不要来回切环境。
systemd 这一步不要跳 如果你后面要装 Gateway 服务或长期运行,WSL 里启用 systemd 是关键步骤。
看起来步骤多,其实只做 5 步 装 WSL2、开 Ubuntu、启用 systemd、跑安装脚本、验证 Dashboard,做完就通了。
Overview

整篇教程的顺序就是这样

你可以先扫一眼全流程,再往下按步骤执行。

01 安装 WSL2 和 Ubuntu 在 Windows 管理员 PowerShell 里执行安装命令。
02 第一次进入 Ubuntu 设置 Linux 用户名和密码,进入真正的工作环境。
03 启用 systemd 这一步和服务安装直接相关,别跳。
04 运行官方安装脚本 在 Ubuntu 里安装 OpenClaw。
05 完成 onboarding 并验证 确认 Gateway 正常、Dashboard 能打开。

第 1 步:在 Windows 里安装 WSL2 和 Ubuntu

先在 Windows 搜索框里找到 PowerShell,右键选择以管理员身份运行,然后执行:

wsl --install

如果你想显式选择 Ubuntu 版本,也可以这样看列表并安装:

wsl --list --online
wsl --install -d Ubuntu-24.04

如果系统要求重启,就先重启。第一次安装 WSL2 的时间通常比后面装 OpenClaw 更久,这是正常的。

第 2 步:第一次打开 Ubuntu

安装完成后,Windows 通常会自动弹出 Ubuntu 终端。如果没有,就在开始菜单里搜索 Ubuntu 打开它。

第一次启动时会让你设置:

  • 一个 Linux 用户名
  • 一个 Linux 密码

这组信息后面执行 sudo 命令时会用到,记住就行。

第 3 步:在 WSL 里启用 systemd

这一步特别重要。官方 Windows 文档明确写了:如果你希望安装 Gateway 服务,要先启用 systemd

在 Ubuntu 终端里执行:

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

然后回到 Windows 的 PowerShell,执行:

wsl --shutdown

再重新打开 Ubuntu,检查 systemd 是否正常:

systemctl --user status

如果这一步没做,后面很多“服务装不上”或者“不会自启动”的问题都会冒出来。

第 4 步:在 Ubuntu 里安装 OpenClaw

接下来就正式开始安装 OpenClaw 了。在 Ubuntu 终端里执行:

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

如果提示没有 curl,先补装:

sudo apt update
sudo apt install curl -y

再重新执行官方安装脚本。这里建议直接使用官方地址,不要把第三方镜像脚本当成默认方案。

第 5 步:如果国内网络慢,先加代理再重试

Windows + WSL2 最常见的安装问题,其实是网络。最稳的优先级是:先用代理,再考虑镜像

如果你本机已经在用 Clash 或其他代理工具,可以先在 Ubuntu 里临时设置:

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

然后重新运行安装脚本。这里的端口用你自己的代理端口替换。

第 6 步:完成 onboarding 并打开 Dashboard

官方安装脚本通常会自动进入 onboarding。如果没有自动进入,你可以手动执行:

openclaw onboard --install-daemon

然后按顺序检查状态:

openclaw doctor
openclaw gateway status
openclaw dashboard

如果浏览器正常打开,或者你手动访问 http://127.0.0.1:18789/ 能看到页面,就说明这条 Windows 路线已经跑通了。

Success Check

怎样才算安装成功

不要只看终端里有没有报错,真正的成功标准是下面这几件事至少做到大半。

Ubuntu 能正常打开

以后每次用 OpenClaw,都是先打开 Ubuntu,而不是回到原生 CMD 或 PowerShell。

openclaw doctor 能运行

说明 CLI 至少已经装到可用状态。

openclaw gateway status 有结果

说明 Gateway 已进入可检查状态,而不是单纯装了个命令。

Dashboard 能打开

只要 Dashboard 正常出来,就说明你已经跨过安装阶段了。

Troubleshooting

遇到问题先看这 3 个排查点

Windows 用户最常见的问题并不多,先按这三类查,通常就能找到方向。

Ubuntu 打不开或 WSL 状态异常 回管理员 PowerShell 里先试 wsl --updatewsl --shutdown,再重新打开 Ubuntu。
Dashboard 打不开 先跑 openclaw gateway status,再手动访问 127.0.0.1:18789,最后再排查代理、防火墙和端口。
装完找不到 openclaw 命令 通常是 PATH 问题,先检查 node -vnpm prefix -gecho "$PATH"
想长期后台运行 优先在 onboarding 时安装服务,或者后面再看服务和长期运行专题,不必第一次就全配齐。

一句话总结

Windows 用户想少踩坑,最稳的方式仍然是:在 WSL2 的 Ubuntu 里安装和运行 OpenClaw。别和原生 Windows 环境来回切,按这篇顺序做,通常就能很快跑通。