OpenClaw 安装教程（一）：Windows 环境准备与 Node.js 安装

欢迎使用 OpenClaw 系列安装教程！本教程分为三篇，将从零开始手把手带你完成 OpenClaw 在 Windows 上的完整安装与配置。本文是第一篇，重点介绍环境准备和 Node.js 安装。

什么是 OpenClaw？

OpenClaw 是一款开源的个人 AI 助手框架，支持本地运行，可连接飞书、Telegram、WhatsApp、Discord 等多个聊天平台。它不仅能帮你管理日程、读写文档、执行代码，还能通过技能（Skills）系统无限扩展功能。

核心特点：

• 🤖 多平台支持 — Windows、macOS、Linux 均可运行
• 💬 多频道连接 — 飞书、Telegram、WhatsApp、Discord 等
• 🔧 多模型支持 — Anthropic Claude、OpenAI GPT、Google Gemini 等
• 🔌 技能扩展 — 社区技能市场，按需安装
• 🔒 本地运行 — 数据不离开你的电脑，隐私安全

系统要求

在开始安装之前，请确认你的电脑满足以下最低要求：

• 操作系统：Windows 10（1903+）或 Windows 11
• 处理器：x64 架构（ARM 设备需要 WSL2 兼容层）
• 内存：至少 4 GB RAM（推荐 8 GB+）
• 磁盘空间：至少 2 GB 可用空间
• 网络：需要能访问 API 服务（如 Anthropic / OpenAI）

方式一：直接在 Windows 上安装（推荐新手）

步骤 1：下载并安装 Node.js

Node.js 是 OpenClaw 运行的基础环境。我们推荐安装 LTS（长期支持）版本。

方法 A：使用 winget 安装（最简单）

如果你使用 Windows 10 1709+ 或 Windows 11，系统自带 winget 包管理器。打开 PowerShell（以管理员身份运行），执行：

winget install OpenJS.NodeJS.LTS

方法 B：官网下载安装包

访问 nodejs.org，下载 LTS 版本的 .msi 安装包，双击运行。

步骤 2：验证安装

安装完成后，重新打开一个 PowerShell 窗口（重要！必须新窗口才能生效），输入：

node -v
npm -v

如果正确安装，你会看到版本号输出，例如：

v22.22.0
10.9.2

步骤 3：配置 npm 全局路径（可选）

有时候 npm 全局安装的包路径不在系统 PATH 中，会导致命令找不到。检查当前全局路径：

npm config get prefix

如果返回路径不是你期望的，可以手动设置：

# 1. 创建全局安装目录
mkdir "$env:APPDATA\npm-global"

# 2. 配置 npm 使用新目录
npm config set prefix "$env:APPDATA\npm-global"

# 3. 将新目录添加到用户 PATH（永久生效）
[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:APPDATA\npm-global", "User")

方式二：使用 WSL2 安装（推荐开发者）

如果你熟悉 Linux 环境，或者需要更好的开发体验，WSL2（Windows Subsystem for Linux 2）是最佳选择。它能在 Windows 中运行完整的 Linux 环境，同时与 Windows 文件系统无缝互通。

步骤 1：启用 WSL2

以管理员身份打开 PowerShell，执行：

wsl --install

这个命令会自动安装 WSL2 和 Ubuntu（默认发行版）。安装完成后需要重启电脑。

步骤 2：初始配置 Ubuntu

重启后会自动弹出 Ubuntu 终端窗口，要求你设置用户名和密码。请记住这个密码，后续 sudo 操作需要用到。

步骤 3：在 WSL2 中安装 Node.js

打开 Ubuntu 终端（或在 PowerShell 中输入 wsl），执行：

# 更新包管理器
sudo apt update && sudo apt upgrade -y

# 安装 Node.js 22.x LTS
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node -v
npm -v

常见问题

Q: 安装后输入 node 提示"不是内部命令"？

这说明 Node.js 没有正确添加到 PATH。重新打开 PowerShell，或者手动将 Node.js 安装路径（通常在 C:\Program Files\nodejs）添加到系统环境变量 PATH 中。

Q: winget 命令不存在？

winget 需要通过 Microsoft Store 安装 "应用安装程序"（App Installer）。打开 Microsoft Store，搜索 "App Installer" 并更新到最新版本。

Q: WSL2 安装后无法启动？

确保你的电脑 BIOS 中开启了虚拟化（Virtualization / VT-x）。不同品牌主板进入 BIOS 的方式不同，一般是开机时按 F2 / F10 / Del 键。

下一篇预告

环境准备就绪后，下一步就是安装 OpenClaw 本体并进行初始化配置。下一篇我们将介绍：

• 使用 PowerShell 一键安装 OpenClaw
• 运行 onboard 向导进行初始化
• 配置 AI 模型提供商和 API Key
• 安装 Gateway 后台服务

👉 继续阅读：OpenClaw 安装教程（二）：安装 OpenClaw 与初始化配置