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,运行:
wsl --install -d Ubuntu-24.04首次运行会自动启用 WSL2 功能并下载 Ubuntu 24.04。完成后重启电脑。
重启后,Ubuntu 会自动启动,按提示设置用户名与密码。
如果希望确认 WSL 版本,重启后在 PowerShell 中运行:
wsl --status看到 默认版本: 2 即表示 WSL2 已就绪。
第 2 步:更新系统
Section titled “第 2 步:更新系统”进入 Ubuntu 终端,先更新系统:
sudo apt update && sudo apt upgrade -y第 3 步:安装 OpenClaw
Section titled “第 3 步:安装 OpenClaw”OpenClaw 官方提供一键安装脚本,会自动检测系统、安装所需 Node 运行时并完成安装:
curl -fsSL https://openclaw.ai/install.sh | bash安装完成后,重新登录终端(或执行 source ~/.bashrc),验证:
openclaw --version看到版本号即安装成功。
如果你希望跳过首次配置向导,可追加参数:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
第 4 步:初始化并启动
Section titled “第 4 步:初始化并启动”运行配置向导,按提示选择模型提供商、填入 API Key:
openclaw onboard --install-daemon--install-daemon 会将 Gateway 注册为 systemd 服务,开机自启。WSL2 新版本默认启用 systemd,无需额外配置。
启动后,在 WSL 内访问:
openclaw status第 5 步:从 Windows 访问(可选)
Section titled “第 5 步:从 Windows 访问(可选)”WSL2 会自动把监听在 localhost 的端口转发到 Windows。因此你可以在 Windows 浏览器直接访问:
http://localhost:18789即可打开 OpenClaw 的本地控制界面。
WSL 默认版本不是 2?
Section titled “WSL 默认版本不是 2?”在 PowerShell 中强制设置:
wsl --set-default-version 2命令找不到 openclaw?
Section titled “命令找不到 openclaw?”执行 source ~/.bashrc,或重新登录终端。仍找不到则确认 Node 是否安装成功:
node -v在 WSL 内运行 openclaw uninstall,或在 PowerShell 中删除整个发行版:
wsl --unregister Ubuntu-24.04- 安装完成后,阅读 OpenClaw 安装与模型配置 配置你的模型。
- 想让 DLinkClaw 接入你的对话?查看 DLinkClaw 通道插件。
