OpenClaw 中文文档

Appearance

系统要求 ​

在安装 OpenClaw 之前，请确认你的系统满足以下最低要求。

硬件要求 ​

OpenClaw 本身非常轻量，可以运行在各种硬件上：

  • 最低要求：1 核 CPU，512MB 内存
  • 推荐配置：2 核 CPU，2GB 内存以上
  • 磁盘空间：至少 1GB 可用空间（Node.js 和依赖占用约 500MB）

支持的平台：

  • x86_64/amd64：完整支持（推荐）
  • ARM64/aarch64：完整支持（树莓派 4+、Apple Silicon）
  • ARMv7/armhf：部分支持，需要自己编译 Node.js

软件要求 ​

Node.js ​

OpenClaw 需要 Node.js：

  • Node.js 22 LTS (22.16+)：推荐，稳定支持
  • Node.js 24：完全支持，最新特性
  • Node.js < 22：不支持

安装 Node.js

在 Debian/Ubuntu 系统上推荐使用 NodeSource 安装：

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

检查版本：

bash
node --version
npm --version

输出版本应该 >= 22.0.0：

v22.22.1
10.9.0

操作系统 ​

支持的操作系统：

  • Linux：完整推荐支持（Debian 12+, Ubuntu 22.04+）
  • macOS：完整支持
  • Windows：通过 WSL2 支持，原生不推荐
  • FreeBSD/OpenBSD：社区支持

网络要求 ​

  • 需要能够访问 GitHub 下载依赖和更新
  • 如果需要连接到 AI 模型提供商，需要相应的网络访问
  • 如果你使用国内网络，建议配置代理或使用镜像源加速 npm

下一步 ​

现在确认系统满足要求，开始 安装 OpenClaw。