首页 教程 分类 Skills下载 关于
ZH EN JA KO

一键部署 OpenClaw

按照以下步骤,几分钟即可完成安装并开始使用

最新版本 v3.2.0
1

安装 Node.js 22+

OpenClaw 需要 Node.js 22 或更高版本。选择你的平台下载安装:

Windows 用户注意:.msi 安装包会自动配置 PATH 环境变量。如果安装后终端提示找不到 node 命令,请手动将 Node.js 安装路径(默认 C:\Program Files\nodejs\)添加到系统环境变量 PATH 中,然后重新打开终端。

也可以使用包管理器安装:

Windows (winget)
winget install OpenJS.NodeJS.LTS
macOS (Homebrew)
brew install node@22
Linux (Ubuntu/Debian)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs
2

验证 Node.js 安装

打开终端,运行以下命令确认版本号:

node --version

输出应为 v22.x.x 或更高版本

3

全局安装 OpenClaw

使用 npm 一键安装:

npm install -g openclaw
4

验证安装

确认 OpenClaw 已正确安装:

openclaw --version
5

配置 API Key

首次运行 OpenClaw,会引导你配置 AI 模型的 API Key:

openclaw init

支持 Anthropic Claude、OpenAI GPT、本地 Ollama 等模型

6

启动 OpenClaw

一切就绪,启动你的 AI 助手:

openclaw start

默认在 http://localhost:3000 启动管理面板

1

安装 Docker

确保已安装 Docker Engine 20.10+ 或 Docker Desktop。选择你的平台下载:

Linux 用户可使用命令安装:

curl -fsSL https://get.docker.com | sh
2

拉取镜像

从 Docker Hub 拉取最新的 OpenClaw 镜像:

docker pull openclaw/openclaw:latest
3

创建配置文件

在本地创建配置目录和配置文件:

mkdir -p ~/.openclaw && touch ~/.openclaw/config.json5

在 config.json5 中配置你的 API Key 和频道信息

4

启动容器

运行 Docker 容器,挂载配置目录:

docker run -d --name openclaw -p 3000:3000 -v ~/.openclaw:/root/.openclaw --restart unless-stopped openclaw/openclaw:latest
5

查看日志

确认容器正常运行:

docker logs -f openclaw
Docker Compose 推荐配置

生产环境推荐使用 Docker Compose,便于管理多服务编排:

version: '3.8' services: openclaw: image: openclaw/openclaw:latest ports: - "3000:3000" volumes: - ./config:/root/.openclaw restart: unless-stopped

保存为 docker-compose.yml,运行 docker compose up -d 启动

1

安装 Node.js 22+ 和 Git

源码编译需要 Node.js 22+ 和 Git。

2

验证环境

确认 Node.js、Git 和 npm 均已正确安装:

node --version && git --version && npm --version
3

克隆仓库

从 GitHub 克隆 OpenClaw 源代码:

git clone https://github.com/openclaw/openclaw.git
4

安装依赖并编译

进入项目目录,安装依赖并构建:

cd openclaw && npm install && npm run build
5

配置并启动

初始化配置并启动服务:

npm run init && npm start

默认在 http://localhost:3000 启动管理面板

系统要求

操作系统

Windows 10+、macOS 12+、Ubuntu 20.04+

Node.js 22+

npm 安装和源码编译方式必需

2GB+ 内存

最低 2GB RAM,推荐 4GB 以上

API Key

需要 Anthropic 或 OpenAI 等模型的 API Key(或使用本地 Ollama)

网络连接

需要访问 AI 模型 API(本地模型除外)

磁盘空间

至少 500MB 可用空间

开始使用 OpenClaw

开源免费,一条命令安装,连接你的 WhatsApp、Telegram、Discord 等聊天平台