Windows 系统下的 WSL2 中安装 OpenClaw 的完整实用教程实用指南

作者：袖梨 2026-08-21

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Windows 系统下的 WSL2 中安装 OpenClaw 的完整”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

Windows 上的 OpenClaw 建议借助 WSL2结合项目来看，（建议 Ubuntu）。CLI + Gateway 网关在 Linux 内运行，这保持了运行时的一致性同时使工具兼容性大大提高（Node/Bun/pnpm、Linux 二进制文件、Skills）。原生 Windows 可能更棘手。WSL2 给你完整的 Linux 体验——一条命令安装：wsl --install。原生 Windows 配套应用已在计划中。

在这个场景下，在 Windows 系统下的 WSL2 中安装 OpenClaw 的完整详细教程（2026 年 2 月最新版）OpenClaw 是一个开源的个人 AI 助手（原 Clawdbot / Moltbot），你能够让它运行在自己的电脑上，借助 WhatsApp、T@elegrimm、Discord、Slack 等你已经在用的聊天软件与它对话。它兼容工具调用、持久记忆、多代理工作流等强大功能。为什么建议在 WSL2 中安装？

落到代码里，Windows 原生安装 Node 环境兼容性差，技能（skills）和二进制依赖经常出问题。
在这个场景下，WSL2 提供完整的 Linux 环境，运行稳定、性能好、容易做成后台服务。
落到代码里，官方文档明确建议 Windows 用户采用 WSL2 + Ubuntu。

一、前提条件（务必检查）

从实现思路看，Windows 10 版本 2004 或更高 / Windows 11（建议 Win11）。
从实现思路看，BIOS 已开启虚拟化（Intel VT-x 或 AMD SVM），可在任务管理器 → 性能 → 虚拟化：已启用。
落到代码里，至少 8GB 内存（建议 16GB+），因为 AI 助手 + LLM 会占用资源。
稳定的网络（安装过程中会下载 Node、依赖、模型等）。

二、安装 WSL2 + Ubuntu

1：安装 WSL2 + Ubuntu（只需一次）以管理员身份打开 PowerShell（或终端），依次执行：

# 一键安装 WSL2 和默认 Ubuntu（推荐）
wsl --install
# 如果想指定 Ubuntu 24.04 LTS（更稳定）
wsl --list --online
wsl --install -d Ubuntu-24.04

理解这一步时，安装完成后重启电脑（Windows 会提示）。重启后再次打开 PowerShell，进入 WSL：

wsl -d Ubuntu-24.04   # 或直接输入 wsl

更新系统（重要）：

sudo apt update && sudo apt upgrade -y
sudo apt install curl git -y

三、启用 systemd

2：启用 systemd（必需！否则 daemon 服务装不上）在 WSL 终端中执行：

sudo tee /etc/wsl.conf > /dev/null <<'EOF'
[boot]
systemd=true
EOF

随后在 Windows PowerShell 中重启 WSL：

wsl --shutdown

重新进入 WSL，验证 systemd 已启用：

systemctl --user status   # 应该能看到正常输出

四、安装 OpenClaw

3：安装 OpenClaw（建议方式）方法 A：采用官方一键安装脚本（最建议，自动处理 Node 22+）在 WSL 终端中直接运行：

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

脚本会：

自动检测/安装 Node.js 22+
全局安装 openclaw@latest
启动 onboarding 向导

方法 B：手动 npm 安装（如果你喜欢自己控制）

# 确保 Node 版本
node -v   # 应该显示 v22.x 或更高
npm install -g openclaw@latest

结合项目来看，若 sharp 编译报错（常用于某些 WSL 环境），加环境变量重试：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

五、 Onboarding设置向导

4：完成 Onboarding（设置向导）安装完成后，立即运行（强烈建议加 --install-daemon 做成系统服务）：

openclaw onboard --install-daemon

向导会引导你：

从实现思路看，选择 LLM 提供商（建议 Anthropic Claude / OpenAI / Grok / Minimax 等，免费额度够用）。
输入 API Key（去对应官网申请）。
落到代码里，设置主聊天通道（WhatsApp / T@elegrimm / Discord 等）。
设置是否开机自启 daemon。
完成安全设置（prompt injection 防护等）。

整个过程 3-5 分钟，跟着提示点就行。

六、常用命令（安装后必记）

openclaw doctor          # 检查配置问题
openclaw status          # 查看网关状态
openclaw dashboard       # 打开浏览器控制台（http://127.0.0.1:18789）
openclaw gateway start   # 手动启动网关
openclaw gateway --port 18789   # 指定端口
# 重启服务
openclaw gateway restart
# 查看日志
openclaw logs

七、Dashboard访问

从 Windows 浏览器访问 Dashboard在 WSL 中启动网关后：

Windows 浏览器直接输入（链接已移除）默认端口转发）。
若无法访问，用以下命令查看 WSL IP：

hostname -I

然后在 Windows 浏览器输入（链接已移除）

八、进阶设置

（可选）

1. 把服务做成开机自启（已借助 --install-daemon 完成）2. 暴露端口给局域网其他设备（手机也能直接聊）在 Windows PowerShell（管理员）中设置端口转发（示例 SSH 22 端口）：

$Distro = "Ubuntu-24.04"
$ListenPort = 2222
$TargetPort = 22
$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort connectaddress=$WslIp connectport=$TargetPort

在这个场景下，同时添加防火墙规则。3. 采用 Ollama 本地模型（完全离线）先在 WSL 安装 Ollama：

curl -fsSL https://ollama.com/install.sh | sh
ollama serve &
ollama pull llama3.2   # 或你喜欢的模型

结合项目来看，随后在 OpenClaw onboarding 时选择本地 Ollama 端点。

九、常用问题排查

问题	解决方法
openclaw: command not found	export PATH=“(npmprefix−g)/bin:(npmprefix−g)/bin:PATH” 同时添加到 ~/.bashrc
systemd 未启用	重复步骤 2，重启 WSL
daemon 启动失败	openclaw doctor + journalctl --user -u openclaw-gateway
sharp / node-gyp 报错	SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
访问不了 localhost	用 WSL IP 或确保网关绑定 0.0.0.0
内存不足	给 WSL 分配更多内存（.wslconfig 文件）