O
OpenClaw

安装指南

OpenClaw 支持多种安装方式，选择适合你的方法开始安装。

系统要求

  • 操作系统： macOS 12+、Linux (Ubuntu 20.04+)、Windows 10/11 (WSL2)
  • Node.js： 22.0.0 或更高版本
  • 内存： 至少 4GB RAM
  • 存储： 至少 1GB 可用空间

安装 Node.js

macOS

# 使用 Homebrew 安装 brew install node # 验证安装 node --version  # 应显示 v22.x.x 或更高

Ubuntu/Debian

# 使用 NodeSource 安装最新版本 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt-get install -y nodejs # 验证安装 node --version

Windows (WSL2)

在 WSL2 Ubuntu 环境中，使用与 Ubuntu 相同的命令安装。

安装 OpenClaw

方式一：npm 全局安装（推荐）

npm install -g openclaw

方式二：使用 npx（无需全局安装）

npx openclaw gateway start

方式三：从源码安装

# 克隆仓库 git clone https://github.com/openclaw/openclaw.git cd openclaw # 安装依赖并构建 npm install npm run build # 链接到全局 npm link

验证安装

openclaw --version openclaw --help

目录结构

安装后，OpenClaw 会在你的主目录创建以下结构：

~/.openclaw/ ├── openclaw.json      # 主配置文件 ├── workspace/         # 工作目录 │   ├── memory/        # 记忆文件 │   └── ... └── logs/              # 日志文件

下一步

安装完成后，继续阅读：