第 2 章入门10 分钟阅读
环境准备与安装
安装 Node.js、获取 API Key，三种方式快速部署 OpenClaw
本章内容
- 1系统要求
- 2安装 Node.js
- 3安装 OpenClaw
系统要求
OpenClaw 支持主流操作系统，以下是运行所需的基本环境：
| 要求项 | 最低版本 | 推荐版本 | 说明 |
|---|---|---|---|
| 操作系统 | macOS 12 / Ubuntu 20.04 / Windows 10 WSL2 | 最新稳定版 | Windows 用户需要 WSL2 |
| Node.js | 22.0 | 22 LTS | 必须，用于运行 OpenClaw |
| 内存 | 4GB | 8GB+ | 运行 AI 模型时需要更多内存 |
| 网络 | 稳定网络 | 宽带连接 | 需要访问 AI API 服务 |
💡 如果你不确定自己的 Node.js 版本，打开终端输入 `node --version` 查看。如果显示 v22 以上就没问题。
安装 Node.js
如果你还没有安装 Node.js，或者版本低于 22，请按照以下步骤安装：
macOS / Linux（推荐使用 nvm）
# 安装 nvm（Node 版本管理器）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# 重新加载终端配置
source ~/.bashrc # 或 source ~/.zshrc
# 安装 Node.js 22
nvm install 22
nvm use 22
# 验证安装
node --version # 应显示 v22.x.xWindows（PowerShell）
# 方法一：从官网下载安装包
# 访问 https://nodejs.org 下载 v22 LTS 版本
# 方法二：使用 winget
winget install OpenJS.NodeJS.LTS
# 验证安装
node --version安装 OpenClaw
提供三种安装方式，根据你的使用场景选择：
方式一：一键安装脚本（推荐新手）
# macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash方式二：npm 手动安装
# 全局安装 OpenClaw
npm install -g openclaw@latest
# 运行配置向导
openclaw onboard --install-daemon方式三：Docker 部署（适合服务器）
docker run -d \
--name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest✅ 安装完成后运行 `openclaw dashboard`，浏览器自动打开控制面板即为成功！