安装详解

OpenClaw 支持多种安装方式。选择最适合你的：官方 npm 安装适用所有平台，新手脚本帮你一步搞定 Mac 环境。

本页内容

选择安装方式
方式一：官方安装（推荐）
运行配置向导
方式二：新手一键脚本（Mac 专用）
方式三：Docker 部署
其他安装方式
更新升级
卸载

选择安装方式

方式	适用系统	难度	说明
官方 npm 安装	macOS / Linux / WSL2	⭐ 简单	官方推荐，一行命令，适用所有平台
新手一键脚本	仅 macOS	⭐ 最简单	帮你装好 Node.js + OpenClaw + Claude Code，开箱即用
Docker	任何有 Docker 的系统	⭐⭐ 中等	容器化部署，适合服务器
Nix / Ansible	Linux / NixOS	⭐⭐⭐ 进阶	声明式配置，适合运维

方式一：官方安装（推荐）

这是 OpenClaw 官方推荐的安装方式，适用于 macOS、Linux、WSL2 所有平台。

前提条件

需要 Node.js 22+。检查是否已安装：

bash

node --version   # 需要 v22 或更高

如果没有 Node.js 或版本低于 22，先安装：

bash

# macOS（通过 Homebrew）
brew install node

# 或通过 nvm（推荐，可管理多版本）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.zshrc   # 或 source ~/.bashrc
nvm install 22

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

# CentOS / RHEL / Fedora
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo yum install -y nodejs

安装 OpenClaw

bash

# 全局安装 OpenClaw CLI
npm install -g openclaw@latest

# 验证安装
openclaw --version

✅

就这么简单

一行 npm install -g openclaw@latest 就装好了。接下来运行配置向导连接你的聊天平台和 AI 模型。

运行配置向导

安装完成后，运行向导完成首次配置：

bash

# 首次配置（交互式向导）
openclaw onboard

向导会引导你完成：

选择 AI 模型 — Anthropic Claude（推荐）/ OpenAI / 国内模型
输入 API Key — 向导会告诉你去哪里获取
连接聊天平台 — Telegram / Discord / WhatsApp 等
初始化工作区 — AI 的配置文件和记忆存储

配置完成后，启动 Gateway：

bash

# 启动 Gateway（AI 助手上线）
openclaw gateway start

# 查看状态
openclaw status

💡

开机自启

OpenClaw 安装后会自动配置开机自启（macOS 用 launchd，Linux 用 systemd）。正常情况下 Gateway 会一直运行，不需要手动管理。

方式二：新手一键脚本（Mac 专用）

⚠️

仅适用于 macOS

这个脚本是我们为 Mac 用户制作的新手包，会额外安装 Claude Code、cc-switch 等开发工具。如果你用 Linux 或只需要 OpenClaw 本身，请使用上面的官方安装方式。

打开终端，复制下面的命令：

bash

curl -fsSL https://cdn.gamesxh.com/ai-setup/setup-openclaw.sh -o setup.sh && bash setup.sh

这个脚本会帮你一步到位安装：

组件	说明
Homebrew	macOS 包管理器（如果没有）
Node.js 22+	OpenClaw 运行环境
OpenClaw	AI 助手网关
Claude Code	Anthropic 的编程助手 CLI
cc-switch	Claude Code 多账号切换工具

整个过程约 3~5 分钟。安装完成后，同样运行 openclaw onboard 完成配置。

🔍

查看脚本源码

你可以先下载查看再执行：curl -fsSL https://cdn.gamesxh.com/ai-setup/setup-openclaw.sh -o setup.sh && cat setup.sh

方式三：Docker 部署

适合服务器部署或不想影响本机环境的用户。

bash

# 拉取镜像
docker pull openclaw/openclaw:latest

# 运行容器
docker run -d \
  --name openclaw \
  --restart unless-stopped \
  -v openclaw-data:/root/.openclaw \
  -p 3000:3000 \
  openclaw/openclaw:latest

# 进入容器运行配置向导
docker exec -it openclaw openclaw onboard

使用 Docker Compose：

yaml

# docker-compose.yml
version: "3.8"
services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    volumes:
      - openclaw-data:/root/.openclaw
    ports:
      - "3000:3000"

volumes:
  openclaw-data:

⚠️

Docker 模式限制

Docker 部署下，AI 无法直接操作宿主机的文件系统和终端命令。如果需要 AI 帮你写代码、管理文件，建议直接安装到宿主机。

其他安装方式

Nix

如果你使用 NixOS 或 Nix 包管理器：

bash

nix profile install github:openclaw/openclaw

Ansible

适合批量部署到多台服务器，详见官方 Ansible 文档。

Bun

如果你使用 Bun 运行时：

bash

bun install -g openclaw@latest

VPS 部署

OpenClaw 支持部署到各种云平台：

DigitalOcean — 最低 $4/月的 Droplet 就能跑
Oracle Cloud — Always Free ARM 实例（免费！）
Raspberry Pi — 树莓派也能当 AI 助手服务器
Railway / Render / Fly.io — 一键部署平台

详见官方 VPS 部署指南。

Windows (WSL2)

Windows 用户需要先安装 WSL2：

powershell

# 在 PowerShell（管理员）中运行
wsl --install

重启电脑后，打开 WSL2 终端（Ubuntu），然后用官方 npm 方式安装即可。

更新升级

bash

# 方式一：使用 OpenClaw 自带更新命令
openclaw update

# 方式二：用 npm 更新
npm update -g openclaw@latest

# 更新后重启 Gateway
openclaw gateway restart

更新不会影响你的配置文件和数据，可以放心升级。

卸载

bash

# 停止 Gateway
openclaw gateway stop

# 卸载 CLI
npm uninstall -g openclaw

# （可选）删除配置和数据
rm -rf ~/.openclaw

🚨

注意：删除数据不可恢复

rm -rf ~/.openclaw 会删除所有配置、对话记录和记忆数据。建议先备份。

← 上一篇快速开始下一篇 → 连接聊天平台