一键部署 OpenClaw
按照以下步骤,几分钟即可完成安装并开始使用
安装 Node.js 22+
OpenClaw 需要 Node.js 22 或更高版本。选择你的平台下载安装:
node 命令,请手动将 Node.js 安装路径(默认 C:\Program Files\nodejs\)添加到系统环境变量 PATH 中,然后重新打开终端。也可以使用包管理器安装:
winget install OpenJS.NodeJS.LTSbrew install node@22curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt-get install -y nodejs验证 Node.js 安装
打开终端,运行以下命令确认版本号:
node --version输出应为 v22.x.x 或更高版本
全局安装 OpenClaw
使用 npm 一键安装:
npm install -g openclaw验证安装
确认 OpenClaw 已正确安装:
openclaw --version配置 API Key
首次运行 OpenClaw,会引导你配置 AI 模型的 API Key:
openclaw init支持 Anthropic Claude、OpenAI GPT、本地 Ollama 等模型
启动 OpenClaw
一切就绪,启动你的 AI 助手:
openclaw start默认在 http://localhost:3000 启动管理面板
安装 Docker
确保已安装 Docker Engine 20.10+ 或 Docker Desktop。选择你的平台下载:
Linux 用户可使用命令安装:
curl -fsSL https://get.docker.com | sh拉取镜像
从 Docker Hub 拉取最新的 OpenClaw 镜像:
docker pull openclaw/openclaw:latest创建配置文件
在本地创建配置目录和配置文件:
mkdir -p ~/.openclaw && touch ~/.openclaw/config.json5在 config.json5 中配置你的 API Key 和频道信息
启动容器
运行 Docker 容器,挂载配置目录:
docker run -d --name openclaw -p 3000:3000 -v ~/.openclaw:/root/.openclaw --restart unless-stopped openclaw/openclaw:latest查看日志
确认容器正常运行:
docker logs -f openclaw生产环境推荐使用 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 启动
验证环境
确认 Node.js、Git 和 npm 均已正确安装:
node --version && git --version && npm --version克隆仓库
从 GitHub 克隆 OpenClaw 源代码:
git clone https://github.com/openclaw/openclaw.git安装依赖并编译
进入项目目录,安装依赖并构建:
cd openclaw && npm install && npm run build配置并启动
初始化配置并启动服务:
npm run init && npm start默认在 http://localhost:3000 启动管理面板
系统要求
Windows 10+、macOS 12+、Ubuntu 20.04+
npm 安装和源码编译方式必需
最低 2GB RAM,推荐 4GB 以上
需要 Anthropic 或 OpenAI 等模型的 API Key(或使用本地 Ollama)
需要访问 AI 模型 API(本地模型除外)
至少 500MB 可用空间