Windows通过wsl2安装openclaw

WSL2 环境部署指南

请以管理员权限启动PowerShell。核心安装流程实质上仅需执行两条关键指令：

wsl --update
wsl --install # 此指令将自动完成Ubuntu发行版的下载与基础配置

然而，部署过程可能并不总是一帆风顺。若遇到“Error code: Wsl/InstallDistro/0x80072efe”报错，或系统提示“This update only applies to machines with the Windows Subsytem for Linux”，表明相关系统组件未启用。此时，需手动启用以下功能：

# 强制启用Windows子系统for Linux功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /force /norestart
# 强制启用虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /force /norestart
# 启用Hyper-V虚拟化平台（适用于Win11家庭版等需要命令解锁的场景）
dism.exe /online /enable-feature /featurename:HypervisorPlatform /all /norestart

执行上述命令后，必须重启计算机使设置生效，随后再次尝试WSL2的安装操作。

在WSL2中部署OpenClaw

完整安装文档请参阅：https://datawhalechina.github.io/hello-claw/cn/adopt/chapter2/

启动你的Ubuntu终端，运行以下安装脚本：

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

通常情况下，安装程序将自动运行。成功的初始化过程会在终端显示类似下文的状态输出，这标志着安装正按预期推进：

接下来，遵循安装向导的提示完成后续配置即可。详尽步骤可参考前述官方文档。

安装可能会在“Configuring npm for user-local installs”或“Installing OpenClaw v2026.3.13”等阶段停滞，这通常源于网络连接问题。可尝试配置国内镜像源以加速依赖下载：

npm config set registry https://registry.npmmirror.com
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

安装结束后，使用openclaw status命令验证服务状态。若返回“command not found”，则需手动将安装路径添加至环境变量：export PATH="/home/xxx/.npm-global/bin:$PATH"（请将路径中的“xxx”替换为你的实际用户名）。正常运行时，该命令将反馈如下系统状态信息：

最后，执行openclaw tui命令即可启动交互式对话界面。至此，OpenClaw在WSL2环境下的完整安装与验证流程全部结束：

来源：互联网