Ubuntu 能正常打开
以后每次用 OpenClaw,都是先打开 Ubuntu,而不是回到原生 CMD 或 PowerShell。
安装部署 / Windows
这篇只讲一条最稳的 Windows 安装路线:先装 WSL2,再在 Ubuntu 里安装 OpenClaw。如果你是第一次碰命令行,也没关系,下面就是按顺序一步一步做的版本。
你先把这两点记住,后面就不会总想绕回原生 Windows 去折腾。
你可以先扫一眼全流程,再往下按步骤执行。
先在 Windows 搜索框里找到 PowerShell,右键选择以管理员身份运行,然后执行:
wsl --install
如果你想显式选择 Ubuntu 版本,也可以这样看列表并安装:
wsl --list --online
wsl --install -d Ubuntu-24.04
如果系统要求重启,就先重启。第一次安装 WSL2 的时间通常比后面装 OpenClaw 更久,这是正常的。
安装完成后,Windows 通常会自动弹出 Ubuntu 终端。如果没有,就在开始菜单里搜索 Ubuntu 打开它。
第一次启动时会让你设置:
这组信息后面执行 sudo 命令时会用到,记住就行。
这一步特别重要。官方 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
如果这一步没做,后面很多“服务装不上”或者“不会自启动”的问题都会冒出来。
接下来就正式开始安装 OpenClaw 了。在 Ubuntu 终端里执行:
curl -fsSL https://openclaw.ai/install.sh | bash
如果提示没有 curl,先补装:
sudo apt update
sudo apt install curl -y
再重新执行官方安装脚本。这里建议直接使用官方地址,不要把第三方镜像脚本当成默认方案。
Windows + WSL2 最常见的安装问题,其实是网络。最稳的优先级是:先用代理,再考虑镜像。
如果你本机已经在用 Clash 或其他代理工具,可以先在 Ubuntu 里临时设置:
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
然后重新运行安装脚本。这里的端口用你自己的代理端口替换。
官方安装脚本通常会自动进入 onboarding。如果没有自动进入,你可以手动执行:
openclaw onboard --install-daemon
然后按顺序检查状态:
openclaw doctor
openclaw gateway status
openclaw dashboard
如果浏览器正常打开,或者你手动访问 http://127.0.0.1:18789/ 能看到页面,就说明这条 Windows 路线已经跑通了。
不要只看终端里有没有报错,真正的成功标准是下面这几件事至少做到大半。
以后每次用 OpenClaw,都是先打开 Ubuntu,而不是回到原生 CMD 或 PowerShell。
openclaw doctor 能运行说明 CLI 至少已经装到可用状态。
openclaw gateway status 有结果说明 Gateway 已进入可检查状态,而不是单纯装了个命令。
只要 Dashboard 正常出来,就说明你已经跨过安装阶段了。
Windows 用户最常见的问题并不多,先按这三类查,通常就能找到方向。
wsl --update 和 wsl --shutdown,再重新打开 Ubuntu。
openclaw gateway status,再手动访问 127.0.0.1:18789,最后再排查代理、防火墙和端口。
node -v、npm prefix -g 和 echo "$PATH"。
Windows 用户想少踩坑,最稳的方式仍然是:在 WSL2 的 Ubuntu 里安装和运行 OpenClaw。别和原生 Windows 环境来回切,按这篇顺序做,通常就能很快跑通。