WSL2 + Ubuntu 部署 OpenClaw 完整指南（上）：环境搭建与依赖处理

• ​摘要​：专为新手设计的互动式实战指南，带你从零开始在 Windows 11 WSL2 上搭建 OpenClaw 开发环境。通过”体检 → 装引擎 → 一键部署”三关闯关模式，避开依赖报错、网络超时等常见坑，每步附带验证标准与人话拆解，学完就能动手实战。
• 🧭 ​文档导航​：目标愿景与前置条件 -> 核心指令速查 -> 实施路径与验证方法 -> 资源补给站 -> 总结与彩蛋

​导读​：安装 OpenClaw 的过程并不复杂，步骤也不多，但本着对新手友好的原则，对安装过程做了详细的记录。为了控制文章篇幅的长度，分为了上下篇。
请继续阅读：WSL2 + Ubuntu 部署 OpenClaw 完整指南（下）：核心配置与模型对接

开篇叙述

要做什么？
你想在 Windows 11 的 WSL2 子系统里安装 OpenClaw，但对 Ubuntu 命令行和这个新工具都不熟——完全没问题！咱们把安装过程拆成”闯关游戏”，每步都有明确目标和验证标准，你只管跟着敲命令，遇到报错随时在讨论区留言。

为啥要这么学？
直接丢给你一串命令很容易”复制粘贴一时爽，报错排查火葬场”。互动式学习能让你：① 理解每步在干嘛，② 建立排查问题的直觉，③ 顺便熟悉 Linux 基础操作，一举三得。

怎么开始？
打开 Windows 终端（PowerShell 或 CMD），输入 进入 Ubuntu，看到提示符变为 就说明准备好了。

环境清单

• 🖥️ ​适用系统​：Windows 11 + WSL2 + Ubuntu 24.04.4 LTS （其他版本可能需微调）
• 📦 ​前置依赖​：
  • 稳定的网络连接（安装过程需下载多个组件）
  • 8GB+ 内存、20GB+ 磁盘空间（建议）
  • 基础命令行认知（知道怎么复制粘贴、回车执行）
• 🔑 ​权限提示​：需要 权限安装系统级软件（首次创建的用户默认具备）

💡 ​老手建议​：先扫一眼，知道大概要敲啥，细节后面会拆解。

🎮 互动闯关模式说明

咱们把安装过程拆成四个小关卡，每过一关都把你的实际反馈结果和文章中的预期结果进行对比，确认无误，再进下一关。这样学起来不累，遇到问题也能马上解决。

🚩 第一关：环境体检（5 分钟）

​这一步我们要干嘛​：确保你的 Ubuntu 系统是”新鲜”的，基础工具齐全，避免后面安装时各种奇葩报错。

🔹 步骤 1：进入 Ubuntu 环境

👉 ​你的任务​：执行后，确认终端提示符样式（例如 ），确认我们”在同一频道”。

🔹 步骤 2：更新软件包列表

💡 ​老手建议​：输入密码时屏幕不会显示任何字符，这是 Linux 的安全设计，放心输完回车就行。

📋 ​预期输出参考​：

👉 ​你的任务​：执行后，把控制台中​反馈结果的最后三行和上面的预期结果相比较​，如果有明显报错，来讨论区，我来帮你判断是否成功。

🔹 步骤 3：升级已安装软件

📋 ​预期输出参考​：

👉 ​你的任务​：执行后，检查返回结果。如果中间有红色报错，来讨论区。

🔹 步骤 4：安装基础构建工具

💡 ​人话拆解​：

• ：用管理员权限执行
• ：Ubuntu 官方安装命令
• ：自动确认所有提问，不用你手动按 Y
• ：下载工具 + 代码管理 + 编译工具包

📋 ​成功标志​：执行过程没有红色 字样，最后回到命令提示符。

👉 ​你的任务​：执行后，检查：

1. 有没有红色报错？
2. 最后是否回到 提示符？

✅ ​第一关通关标准​：以上四条命令都成功执行，无红色报错。

🚩 第二关：安装 Node.js 引擎（10 分钟）

​这一步我们要干嘛​：OpenClaw 是用 Node.js 写的，OpenClaw 官方推荐 Node.js 22.x ，我们可以安装一个”新一点”的版本（v24）。用 nvm（Node Version Manager）来管理安装会非常方便。

🔹 步骤 1：检查是否已安装 nvm

📋 ​预期输出参考​：

👉 ​你的任务​：执行后，如果返回结果和预期输出一致，跳到步骤 4 继续执行。如果提示 也无妨，请继续下一步。

🔹 步骤 2：如未安装，执行安装（国内镜像加速）

💡 ​老手建议​：安装结束后，需要重启终端或执行 让配置生效。

🔹 步骤 3：加载配置 + 验证 nvm

👉 ​你的任务​：执行后，检查是否输出了 nvm 的版本号。

🔹 步骤 4：安装 Node.js 24.x

📋 ​预期输出参考​：（反馈结果的最后4行）

✅ ​关键标志​：看到 +

👉 ​你的任务​：执行后，检查反馈结果中有无报错。

🔹 步骤 5：验证 Node 环境

📋 ​预期输出参考​：

👉 ​你的任务​：执行后，检查输出的版本号是否符合预期。

✅ ​第二关通关标准​： 返回 ， 返回对应版本号，无报错。

🚩 第三关：一键安装 OpenClaw（5 分钟）

​这一步我们要干嘛​：万事俱备，用官方脚本一键安装 OpenClaw，它会自动处理剩余依赖。

🔹 步骤 1：执行官方安装脚本

⚠️ ​高能预警​：这个命令会下载并执行远程脚本，请确保你信任官方源。安装过程中保持终端交互，不要中途关闭。

📋 ​预期输出关键节点​：

💡 ​老手建议​：执行到 这一行时可能要等待较长时间，只要不报错，耐心等待！如果在这里遇到了坑，请给我留言，或许这个坑我已经踩过了。

👉 ​你的任务​：执行过程中，如果看到以下交互提示，表示安装成功，自动进入了 onboard 向导。

💡 ​老手建议​：请保持终端交互，勿中断，可直接进入下一关，完成初次配置和运行。

🔹 步骤 2：验证 CLI 安装（可选，建议新终端执行）

📋 ​预期输出参考​：

📋 ​预期输出参考​：

👉 ​你的任务​：执行后，确认 命令可用。

✅ ​第三关通关标准​：执行 可以显示版本号，或者执行 能显示帮助信息。

🎯 三条保命法则

1. ​先体检，再动手​：任何软件安装前，先 openclaw 部署 刷新环境，能避开一半的依赖报错。
2. ​版本要对，别贪新​：Node.js 用 LTS 或官方推荐版本，太新的版本可能有兼容性问题。
3. ​报错别慌，看最后三行​：大多数错误信息的关键线索都在输出的末尾，复制最后几行搜一下，大概率有解。

🎁 彩蛋：一句命令查看你的”技术画像”

✅ ​搞定标志​：运行后看到一行整洁的环境信息，截图发朋友圈，新手村成就达成！✨

🚀 下一站预告

恭喜你完成前三关！接下来我们可以一起探索：

• ​第四关​： 配置向导，连接你的第一个 AI 模型。请继续阅读：WSL2 + Ubuntu 部署 OpenClaw 完整指南（下）：核心配置与模型对接

💡 ​老手建议​：学习新技术就像打游戏，通关不是目的，享受过程、积累手感才是真本事。遇到卡关随时在讨论区留言，咱们一起拆招！
📌 ​重要提醒​：本教程中所有”预期输出”均来自安装过程实录，仅供参考，你实际执行时得到的反馈结果可能不完全相同。不要参考预期输出改写你的安装指令。