Windows 系统下的 WSL2 中安装 OpenClaw 的完整详细教程

Windows 上的 OpenClaw 推荐通过 WSL2（推荐 Ubuntu）。CLI + Gateway 网关在 Linux 内运行，这保持了运行时的一致性并使工具兼容性大大提高（Node/Bun/pnpm、Linux 二进制文件、Skills）。原生 Windows 可能更棘手。WSL2 给你完整的 Linux 体验——一条命令安装：。原生 Windows 配套应用已在计划中。

在 Windows 系统下的 WSL2 中安装 OpenClaw 的完整详细教程（2026 年 2 月最新版）OpenClaw 是一个开源的个人 AI 助手（原 Clawdbot / Moltbot），你可以让它运行在自己的电脑上，通过 WhatsApp、Telegram、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、依赖、模型等）。

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

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

更新系统（重要）：

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

然后在 Windows PowerShell 中重启 WSL：

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

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

脚本会：

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

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

如果 sharp 编译报错（常见于某些 WSL 环境），加环境变量重试：

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

向导会引导你：

• 选择 LLM 提供商（推荐 Anthropic Claude / OpenAI / Grok / Minimax 等，免费额度够用）。
• 输入 API Key（去对应官网申请）。
• 配置主聊天通道（WhatsApp / Telegram / Discord 等）。
• 设置是否开机自启 daemon。
• 完成安全设置（prompt injection 防护等）。

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

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

• Windows 浏览器直接输入 http://localhost:18789 通常就能访问（WSL2 默认端口转发）。
• 如果无法访问，用以下命令查看 WSL IP：

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

（可选）

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

并添加防火墙规则。3. 使用 Ollama 本地模型（完全离线）先在 WSL 安装 Ollama：

然后在 OpenClaw onboarding 时选择本地 Ollama 端点。

• 进入 Dashboard → Channels 添加你常用的聊天软件。
• 安装官方 Skills（ClawHub）让它能操作电脑、写代码、查邮件等。
• 推荐搭配 Tailscale / ngrok 实现手机远程控制。
• 定期运行 openclaw update 保持最新。

官方文档地址（强烈建议收藏）：

• 主文档：https://docs.openclaw.ai/
• WSL2 专用页：https://docs.openclaw.ai/platforms/windows
• GitHub：https://github.com/openclaw/openclaw

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

端口转发不工作？
确认 Windows 防火墙规则已添加
检查 WSL IP 地址是否正确：wsl — hostname -I
使用 netsh interface portproxy show all 查看当前转发规则
Gateway 服务无法启动？
运行诊断工具：