第2课 开始前的准备#

为什么要学这一课?#

在安装 OpenClaw 之前,需要准备好你的电脑。不用担心——你只需要安装一样东西:Node.js。在这一课中,我们会解释它是什么,并一步步在你的系统上安装它。


什么是 Node.js?#

Node.js 是一个可以运行 JavaScript 编写的应用程序的软件。OpenClaw 是用 JavaScript 编写的,所以没有 Node.js 它就无法运行。

打个比方:要打开 Word 文件,你需要 Microsoft Word。要运行 OpenClaw——你需要 Node.js。它只是运行程序的"引擎"。

重要: 你需要 Node.js 22 或更新版本


如何检查你是否已经有 Node.js#

打开终端(下一课会详细介绍终端是什么)并输入:

node --version
  • 如果你看到类似 v22.12.0 的内容——太好了,Node.js 已经安装了!
  • 如果出现"command not found"错误——说明需要安装。

安装 Node.js#

选择你的操作系统并按照说明操作。

🍎 macOS (Mac)#

方法1:从网站下载(最简单)

  1. 在浏览器中打开网站:https://nodejs.org
  2. 点击绿色按钮上的 22.x LTS 版本(LTS 表示"长期支持的稳定版本")
  3. 会下载一个 .pkg 文件——打开它
  4. 按照安装程序的提示操作:“继续”→“继续”→“安装”
  5. 完成!

方法2:通过 Homebrew(如果你知道这是什么)

brew install node@22

🪟 Windows#

OpenClaw 开发者的建议: 在 Windows 上最好使用 WSL2——这是一种在 Windows 内部直接运行 Linux 的方法。但如果这听起来很复杂,也可以不用它。

简单方法:下载安装程序

  1. 在浏览器中打开:https://nodejs.org
  2. 点击 22.x LTS 版本的按钮
  3. 会下载一个 .msi 文件——打开它
  4. 按照安装步骤操作:“Next”→“Next”→“Install”
  5. 重要: 如果出现"Automatically install the necessary tools"(自动安装必要工具)选项,请勾选
  6. 完成!

高级方法:通过 WSL2(推荐)

WSL2(Windows Subsystem for Linux)是 Windows 内置的运行 Linux 的功能。OpenClaw 在其中运行效果最好。

  1. 以管理员身份打开 PowerShell(右键点击"开始"按钮 → “终端(管理员)")
  2. 输入:
    wsl --install
  3. 重启电脑
  4. 重启后会打开一个 Ubuntu 窗口——创建用户名和密码
  5. 然后在 Ubuntu 中安装 Node.js:
    curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
    sudo apt-get install -y nodejs

🐧 Linux (Ubuntu / Debian)#

打开终端并执行:

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

sudo 是以管理员身份运行操作的命令。系统会要求你输入密码——这是正常的。输入密码时不会显示字符——直接输入然后按 Enter。


验证安装#

安装完成后,打开终端并输入:

node --version

你应该会看到版本号,例如:

v22.12.0

如果版本号以 v22 或更高版本开头——一切正常! ✅

还要检查 npm(包管理器——用于安装其他程序的工具)是否已安装:

npm --version

你应该会看到一个数字,例如 10.9.0


还需要什么#

  • 🌐 网络连接 —— OpenClaw 通过互联网与 AI 模型通信
  • 🔑 AI 服务订阅 —— Anthropic (Claude) 或 OpenAI (ChatGPT)。详见第4课
  • ⏱️ 15-20 分钟空闲时间 —— 用于安装和配置

本课总结#

  • 运行 OpenClaw 需要 Node.js 22 或更新版本
  • Node.js 是运行 OpenClaw 的"引擎”
  • 安装 Node.js 只需 2 分钟,从 nodejs.org 下载即可
  • 在 Windows 上建议使用 WSL2 以获得更好的兼容性
  • 安装后用 node --version 命令检查版本

在下一课中,我们将用一条命令安装 OpenClaw 本身!