在 Windows 系统下的 WSL2 中安装 OpenClaw 的完整详细教程(2026 年 2 月最新版)OpenClaw 是一个开源的个人 AI 助手(原 Clawdbot / Moltbot),你可以让它运行在自己的电脑上,通过 WhatsApp、Telegram、Discord、Slack 等你已经在用的聊天软件与它对话。它支持工具调用、持久记忆、多代理工作流等强大功能。为什么推荐在 WSL2 中安装?

  • Windows 原生安装 Node 环境兼容性差,技能(skills)和二进制依赖经常出问题。
  • WSL2 提供完整的 Linux 环境,运行稳定、性能好、容易做成后台服务。
  • 官方文档明确推荐 Windows 用户使用 WSL2 + Ubuntu。

一、前提条件(务必检查)

  1. Windows 10 版本 2004 或更高 / Windows 11(推荐 Win11)。

  2. BIOS 已开启 虚拟化(Intel VT-x 或 AMD SVM),可在任务管理器 → 性能 → 虚拟化:已启用。

  3. 至少 8GB 内存(推荐 16GB+),因为 AI 助手 + LLM 会占用资源。

  4. 稳定的网络(安装过程中会下载 Node、依赖、模型等)。


二、步骤 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

三、步骤 2:启用 systemd(必需!否则 daemon 服务装不上)在 WSL 终端中执行:

bash

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

然后在 Windows PowerShell 中重启 WSL:

powershell

wsl --shutdown

重新进入 WSL,验证 systemd 已启用:

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

四、步骤 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

五、步骤 4:完成 Onboarding(配置向导)安装完成后,立即运行(强烈建议加 --install-daemon 做成系统服务):

openclaw onboard --install-daemon

向导会引导你:

  1. 选择 LLM 提供商(推荐 Anthropic Claude / OpenAI / Grok / Minimax 等,免费额度够用)。

  2. 输入 API Key(去对应官网申请)。

  3. 配置主聊天通道(WhatsApp / Telegram / Discord 等)。

  4. 设置是否开机自启 daemon。

  5. 完成安全设置(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

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

  • Windows 浏览器直接输入 http://localhost:18789 通常就能访问(WSL2 默认端口转发)。

  • 如果无法访问,用以下命令查看 WSL IP:

hostname -I

然后在 Windows 浏览器输入 http://WSL-IP:18789


八、进阶配置(可选)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=“(npmprefixg)/bin:(npm prefix -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 文件)

十、后续操作建议

  1. 进入 Dashboard → Channels 添加你常用的聊天软件。

  2. 安装官方 Skills(ClawHub)让它能操作电脑、写代码、查邮件等。

  3. 推荐搭配 Tailscale / ngrok 实现手机远程控制。

  4. 定期运行 openclaw update 保持最新。

阅读全文
阅读全文需关注公众号
扫描下方二维码关注公众号,回复关键词获取解锁口令
公众号二维码
关键词:获取口令

在 Windows 系统下的 WSL2 中安装 OpenClaw 的完整详细教程(2026 年 2 月最新版)OpenClaw 是一个开源的个人 AI 助手(原 Clawdbot / Moltbot),你可以让它运行在自己的电脑上,通过 WhatsApp、Telegram、Discord、Slack 等你已经在用的聊天软件与它对话。它支持工具调用、持久记忆、多代理工作流等强大功能。为什么推荐在 WSL2 中安装?

  • Windows 原生安装 Node 环境兼容性差,技能(skills)和二进制依赖经常出问题。
  • WSL2 提供完整的 Linux 环境,运行稳定、性能好、容易做成后台服务。
  • 官方文档明确推荐 Windows 用户使用 WSL2 + Ubuntu。

一、前提条件(务必检查)

  1. Windows 10 版本 2004 或更高 / Windows 11(推荐 Win11)。

  2. BIOS 已开启 虚拟化(Intel VT-x 或 AMD SVM),可在任务管理器 → 性能 → 虚拟化:已启用。

  3. 至少 8GB 内存(推荐 16GB+),因为 AI 助手 + LLM 会占用资源。

  4. 稳定的网络(安装过程中会下载 Node、依赖、模型等)。


二、步骤 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

三、步骤 2:启用 systemd(必需!否则 daemon 服务装不上)在 WSL 终端中执行:

bash

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

然后在 Windows PowerShell 中重启 WSL:

powershell

wsl --shutdown

重新进入 WSL,验证 systemd 已启用:

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

四、步骤 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

五、步骤 4:完成 Onboarding(配置向导)安装完成后,立即运行(强烈建议加 --install-daemon 做成系统服务):

openclaw onboard --install-daemon

向导会引导你:

  1. 选择 LLM 提供商(推荐 Anthropic Claude / OpenAI / Grok / Minimax 等,免费额度够用)。

  2. 输入 API Key(去对应官网申请)。

  3. 配置主聊天通道(WhatsApp / Telegram / Discord 等)。

  4. 设置是否开机自启 daemon。

  5. 完成安全设置(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

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

  • Windows 浏览器直接输入 http://localhost:18789 通常就能访问(WSL2 默认端口转发)。

  • 如果无法访问,用以下命令查看 WSL IP:

hostname -I

然后在 Windows 浏览器输入 http://WSL-IP:18789


八、进阶配置(可选)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=“(npmprefixg)/bin:(npm prefix -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 文件)

十、后续操作建议

  1. 进入 Dashboard → Channels 添加你常用的聊天软件。

  2. 安装官方 Skills(ClawHub)让它能操作电脑、写代码、查邮件等。

  3. 推荐搭配 Tailscale / ngrok 实现手机远程控制。

  4. 定期运行 openclaw update 保持最新。

官方文档地址(强烈建议收藏):

按照上面步骤操作,99% 的用户都能在 15-30 分钟内成功跑起来。如果你卡在某一步,请把报错截图 + 当前步骤告诉我,我继续帮你排查!现在就去试试吧,安装完后你的个人 AI 助手就正式上线了 🦞