OpenClaw WSL2 安装教程：Windows 轻松运行 AI 助手
教程说明：OpenClaw 官方推荐在 POSIX 环境下运行，而 WSL2（Windows Subsystem for Linux 2）正是让 Windows 用户无缝运行完整 Linux 内核的最佳选择。本教程带你从零开始，在 Windows 10/11 上启用 WSL2、安装 Ubuntu 24.04、配置 Node.js，最终完整运行 OpenClaw AI 助手。全程约 30 分钟，无需双系统，不影响现有 Windows 使用。
为什么 Windows 用户要通过 WSL2 安装 OpenClaw？
OpenClaw 是 2026 年最受开发者追捧的开源个人 AI 助手框架。它依赖 Unix 信号（SIGTERM、SIGHUP）、Unix 套接字、Shell 脚本和 inotify 文件系统监控等 Linux/macOS 原生机制。这些功能在 Windows 原生环境中无法原生支持，因此 OpenClaw 官方建议 Windows 用户通过 WSL2 运行。
WSL2 在 Hyper-V 轻量虚拟机中运行完整的 Linux 内核，性能几乎与原生 Linux 持平，文件系统访问速度比 WSL1 快 3-6 倍。更重要的是，WSL2 完全集成在 Windows 中，可以通过 Windows Terminal 直接访问，无需双系统、无需重启，与 Windows 应用无缝协作。
安装前的系统要求
Windows 10 版本 2004（Build 19041）或 Windows 11
按 Win+R 输入 winver 查看版本。如版本过低，请先通过 Windows Update 升级系统。
BIOS 中已开启虚拟化技术（VT-x / AMD-V）
打开任务管理器 → 性能 → CPU，查看"虚拟化"一栏是否显示"已启用"。若未启用，需进入 BIOS 开启。
至少 8GB 内存，推荐 16GB
WSL2 运行时会占用约 2-4GB 内存，OpenClaw 本身约 200-400MB，加上 Windows 系统本身，8GB 是基本下限。
稳定的国际网络连接
安装过程需要从 npm 下载包，运行时需连接 Anthropic/OpenAI API。建议全程开启 VPN07 以保证速度和稳定性。
第一步：启用 WSL2 并安装 Ubuntu 24.04
以管理员身份打开 PowerShell（右键开始菜单 → Windows PowerShell（管理员）），输入以下命令一键安装 WSL2 和 Ubuntu 24.04：
# 一键安装 WSL2 + Ubuntu 24.04
wsl --install -d Ubuntu-24.04
# 安装完成后重启电脑
Restart-Computer
重启后的操作
重启后，系统会自动弹出 Ubuntu 终端窗口完成初始化。按提示设置 Linux 用户名和密码（这是 WSL2 内部的账户，与 Windows 账户无关）。建议用简单好记的用户名，如 ubuntu。
第二步：启用 systemd（OpenClaw 守护进程必需）
OpenClaw 的网关（Gateway）功能需要 systemd 支持，才能在后台持续运行。在 Ubuntu 终端中执行以下命令启用 systemd：
# 编辑 WSL 配置文件
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
# 在 PowerShell 中重启 WSL（从 Windows 执行）
# wsl --shutdown
在 Windows 端打开新的 PowerShell 执行 wsl --shutdown，然后重新打开 Ubuntu 终端，运行 systemctl --no-pager status 验证 systemd 已启动。
第三步：安装 Node.js 22+
OpenClaw 需要 Node.js 22 或更高版本。在 Ubuntu 终端中执行以下命令：
# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装 Node.js
sudo apt install -y nodejs
# 验证安装
node --version # 应显示 v22.x.x
npm --version # 应显示 10.x.x
第四步：安装 OpenClaw
Node.js 就绪后，可以通过两种方式安装 OpenClaw。推荐使用官方一键脚本，它会自动处理所有依赖和初始化：
方式一：官方一键脚本（推荐）
curl -fsSL https://openclaw.ai/install.sh | bash
自动安装 Node.js、OpenClaw 及所有依赖，完成后直接进入配置引导。
方式二：npm 手动安装
npm install -g openclaw
openclaw onboard
更灵活，适合已有 Node.js 环境的用户，可以精确控制安装版本。
第五步：WSL2 网络配置与代理设置
这是很多用户在 WSL2 安装 OpenClaw 时遇到障碍最多的环节。OpenClaw 需要连接 Anthropic、OpenAI 等境外 API 服务器，而 WSL2 默认通过 NAT 方式访问网络，如果 Windows 端配置了 VPN，需要让 WSL2 也能使用该代理。
# 获取 Windows 主机的 IP（WSL2 网关地址）
WINDOWS_IP=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
# 设置代理（假设 Windows VPN 在 7890 端口监听）
export http_proxy="http://${WINDOWS_IP}:7890"
export https_proxy="http://${WINDOWS_IP}:7890"
# 测试连接
curl -I https://api.anthropic.com
💡 推荐永久配置代理
将以上代理设置添加到 ~/.bashrc 文件末尾，这样每次打开 WSL2 终端都会自动生效，无需重复输入。
echo 'export http_proxy="http://$(cat /etc/resolv.conf | grep nameserver | awk '"'"'{print $2}'"'"'):7890"' >> ~/.bashrc
echo 'export https_proxy="http://$(cat /etc/resolv.conf | grep nameserver | awk '"'"'{print $2}'"'"'):7890"' >> ~/.bashrc
source ~/.bashrc
第六步：首次 Onboard 配置
网络畅通后，运行 openclaw onboard 开始交互式配置。这个过程会引导你完成几个关键步骤：
给 AI 助手命名
给你的 AI 助手起一个个性化的名字，例如"助手"、"小助"或任何你喜欢的英文名。这个名字将出现在所有消息通知中。
输入 AI API Key
粘贴你的 Anthropic Claude API Key（格式：sk-ant-xxxxx）。推荐使用 Claude，效果最好。如果没有，也可以使用 OpenAI API Key。
选择通信渠道
推荐选择 Telegram。在 Telegram 中与 @BotFather 对话，发送 /newbot 创建机器人，获取 Token 后粘贴到 OpenClaw 配置中即可。
访问控制面板
配置完成后，在 Windows 浏览器中打开 http://localhost:19090 即可访问 OpenClaw 的 Web 控制界面，查看日志、管理技能、监控状态。
WSL2 安装 OpenClaw 常见问题
Q：WSL2 安装时报错"虚拟化平台未启用"？
以管理员运行 PowerShell，执行 Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform，重启后再次尝试。若仍有问题，需进入 BIOS 开启 Intel VT-x 或 AMD SVM。
Q：npm install 速度极慢或超时？
原因是未正确设置代理，npm 无法连接境外服务器。确认 Windows 端 VPN07 已连接，WSL2 中已通过上述方法设置代理变量，再用 curl https://registry.npmjs.org 测试连通性。
Q：电脑重启后 OpenClaw 如何自动启动？
使用 systemd 注册守护服务：openclaw service install，然后 systemctl enable openclaw。这样 WSL2 启动时 OpenClaw 会自动在后台运行，无需手动启动。
Q：WSL2 占用内存太多怎么办？
在用户目录下创建 %UserProfile%\.wslconfig 文件，加入 [wsl2] 即可限制 WSL2 资源使用。
memory=4GB
processors=2
WSL2 vs 原生 Windows 运行 OpenClaw 性能对比
| 指标 | WSL2 运行 | 原生 Windows 运行 |
|---|---|---|
| 功能完整性 | 100%（官方推荐） | ~70%（部分功能受限） |
| 启动速度 | 约 3-5 秒 | 约 2-3 秒 |
| 内存占用 | 约 2-4GB | 约 1-2GB |
| 插件/技能兼容 | 完全支持 | 部分不支持 |
WSL2 + OpenClaw 最佳使用场景
WSL2 环境下运行的 OpenClaw 有几个特别适合的使用场景，充分发挥了 Windows 与 Linux 混合环境的优势：
Windows 开发者的 AI 编程助理
OpenClaw 在 WSL2 中可以直接访问你的 Windows 文件系统（通过 /mnt/c/），与 VS Code、Cursor 等 IDE 无缝协作。你可以让 AI 助手监控项目目录的变化，自动运行测试、生成文档、审查代码。
24 小时自动化工作流
利用 Windows 台式机长期开机的特点，WSL2 中的 OpenClaw 可以设置定时任务，在你睡觉时自动整理邮件、更新数据报告、监控关键指标并通过 Telegram 推送摘要。
多 AI 工具协同工作站
OpenClaw 可以在 WSL2 中协调 Claude Code、Cursor、GitHub Copilot 等多个 AI 工具的工作，作为"总调度员"管理复杂的多步骤开发任务，大幅提升工程效率。
为什么 OpenClaw 用户必须配备优质 VPN？
无论是在 WSL2 还是原生 Windows 上运行 OpenClaw，都绕不开一个核心问题：网络连通性。OpenClaw 的智能来自于 Claude、GPT 等大型语言模型，每一次 AI 响应都需要实时连接境外 API 服务器。如果网络不稳定，后果包括：
网络不稳定的后果
- • AI 响应超时，任务中断
- • 自动化工作流失败，数据丢失
- • npm 安装中途失败，依赖损坏
- • Telegram Bot 无法收发消息
使用 VPN07 的效果
- • 1000Mbps 千兆带宽，API 响应极速
- • 70+ 国家节点，自动选择最优线路
- • 十年稳定运营，7×24 小时可用
- • Windows 原生客户端，WSL2 自动共享