跳转到内容

WSL 安装 OpenClaw 教程

本教程指导你在 Windows 电脑上,通过 WSL2 安装 Ubuntu 24.04,并在其中部署 OpenClaw。适合希望在 Windows 本机运行 OpenClaw、同时拥有完整 Linux 环境的用户。

  • 系统:Windows 10 2004+ 或 Windows 11
  • 内存:建议 8 GB 及以上(WSL2 会占用一部分内存)
  • CPU:支持虚拟化(BIOS 中需开启 VT-x / SVM)

第 1 步:启用 WSL2 并安装 Ubuntu 24.04

Section titled “第 1 步:启用 WSL2 并安装 Ubuntu 24.04”

管理员身份打开 PowerShell 或 Windows Terminal,运行:

Terminal window
wsl --install -d Ubuntu-24.04

首次运行会自动启用 WSL2 功能并下载 Ubuntu 24.04。完成后重启电脑

重启后,Ubuntu 会自动启动,按提示设置用户名密码

如果希望确认 WSL 版本,重启后在 PowerShell 中运行:

Terminal window
wsl --status

看到 默认版本: 2 即表示 WSL2 已就绪。

进入 Ubuntu 终端,先更新系统:

Terminal window
sudo apt update && sudo apt upgrade -y

OpenClaw 官方提供一键安装脚本,会自动检测系统、安装所需 Node 运行时并完成安装:

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

安装完成后,重新登录终端(或执行 source ~/.bashrc),验证:

Terminal window
openclaw --version

看到版本号即安装成功。

如果你希望跳过首次配置向导,可追加参数: curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

运行配置向导,按提示选择模型提供商、填入 API Key:

Terminal window
openclaw onboard --install-daemon

--install-daemon 会将 Gateway 注册为 systemd 服务,开机自启。WSL2 新版本默认启用 systemd,无需额外配置。

启动后,在 WSL 内访问:

Terminal window
openclaw status

第 5 步:从 Windows 访问(可选)

Section titled “第 5 步:从 Windows 访问(可选)”

WSL2 会自动把监听在 localhost 的端口转发到 Windows。因此你可以在 Windows 浏览器直接访问:

http://localhost:18789

即可打开 OpenClaw 的本地控制界面。

在 PowerShell 中强制设置:

Terminal window
wsl --set-default-version 2

执行 source ~/.bashrc,或重新登录终端。仍找不到则确认 Node 是否安装成功:

Terminal window
node -v

在 WSL 内运行 openclaw uninstall,或在 PowerShell 中删除整个发行版:

Terminal window
wsl --unregister Ubuntu-24.04