OpenClaw 安装指南：Linux 与 Windows 系统详细教程

OpenClaw 安装指南

OpenClaw 是一个本地优先的个人 AI 助手，支持多种通讯渠道（WhatsApp、Telegram、Slack、Discord 等）。本文将详细介绍如何在 Linux 和 Windows 系统上安装 OpenClaw。

系统要求

项目	要求
Node.js	≥ 22 版本
内存	至少 2GB（推荐 4GB+）
磁盘空间	至少 5GB 可用空间
网络	能够访问 npm 仓库和 GitHub

检查 Node.js 版本：

bash 复制代码

node --version

Linux 系统安装

方法一：官方安装脚本（推荐）

这是最简单、最推荐的安装方式，适用于大多数 Linux 发行版（Ubuntu、Debian、CentOS、Fedora 等）：

bash 复制代码

curl -fsSL https://openclaw.ai/install.sh | bash

安装脚本会自动完成以下操作：

检查系统依赖
安装或更新 Node.js（如需要）
通过 npm 安装 OpenClaw
创建必要的目录结构

方法二：使用 npm/pnpm 全局安装

如果你更喜欢使用包管理器手动安装：

使用 npm：

bash 复制代码

npm install -g openclaw@latest

使用 pnpm（推荐，速度更快）：

bash 复制代码

pnpm add -g openclaw@latest

⚠️ 注意：不建议使用 Bun 作为 Gateway 运行时，因为存在 WhatsApp/Telegram 兼容性问题。

方法三：Docker 安装

如果你希望使用容器化部署：

bash 复制代码

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 运行 Docker 安装脚本
./docker-setup.sh

更多 Docker 配置选项，请参考 [Docker 安装章节](#Docker 安装章节)。

Windows 系统安装

前提条件

Windows 安装强烈建议 通过 WSL2（Windows Subsystem for Linux）进行。原生 Windows 支持有限。

安装 WSL2

以管理员身份打开 PowerShell
运行以下命令安装 WSL2：

powershell 复制代码

wsl --install

重启计算机
安装 Ubuntu 发行版（或其他 Linux 发行版）

在 WSL2 中安装 OpenClaw

进入 WSL2 环境后，使用与 Linux 相同的安装命令：

bash 复制代码

curl -fsSL https://openclaw.ai/install.sh | bash

PowerShell 直接安装（实验性）

如果你不想使用 WSL2，可以尝试 PowerShell 安装脚本：

powershell 复制代码

iwr -useb https://openclaw.ai/install.ps1 | iex

⚠️ 警告：Windows 原生支持不如 WSL2 完善，某些功能可能无法正常工作。

Docker 安装（可选）

Docker 安装适合以下场景：

需要隔离的运行环境
在 VPS/云服务器上部署
不想在主机上安装 Node.js 依赖

快速开始

bash 复制代码

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 运行安装脚本
./docker-setup.sh

脚本执行完成后：

访问 http://127.0.0.1:18789/ 打开控制面板
在设置中输入生成的 Token

使用远程镜像（跳过本地构建）

bash 复制代码

export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./docker-setup.sh

可用的镜像标签：

latest - 最新的稳定版本
main - 最新的开发版本
2026.2.26 - 特定版本号

常用 Docker 命令

bash 复制代码

# 查看容器状态
docker compose ps

# 查看日志
docker compose logs -f openclaw-gateway

# 重启服务
docker compose restart

# 停止服务
docker compose down

从源码安装

适合开发者或需要最新功能的用户。

步骤

bash 复制代码

# 1. 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 2. 安装依赖（推荐使用 pnpm）
pnpm install

# 3. 构建 UI
pnpm ui:build

# 4. 构建项目
pnpm build

# 5. 运行安装向导
pnpm openclaw onboard --install-daemon

开发模式（热重载）

bash 复制代码

# 启动 Gateway（自动重载 TypeScript 更改）
pnpm gateway:watch

安装后配置

1. 运行安装向导

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

bash 复制代码

openclaw onboard --install-daemon

向导将引导你完成：

身份验证配置（OpenAI 或其他模型提供商）
Gateway 基本设置
通讯渠道配置（WhatsApp、Telegram 等）
安装系统服务（自动启动）

2. 检查 Gateway 状态

bash 复制代码

openclaw gateway status

3. 打开控制面板

bash 复制代码

# 自动在浏览器中打开
openclaw dashboard

# 或手动访问
# http://127.0.0.1:18789/

4. 运行健康检查

bash 复制代码

openclaw doctor

doctor 命令会：

检查配置是否正确
迁移旧版本配置
检测安全风险（如 DM 策略）
修复常见问题

5. 启动/停止 Gateway

bash 复制代码

# 查看状态
openclaw gateway status

# 前台运行（调试用）
openclaw gateway --port 18789 --verbose

# 停止服务
openclaw gateway stop

# 重启服务
openclaw gateway restart

# 查看日志
openclaw logs --follow

常见问题

Q: 安装时提示权限不足？

Linux/macOS：

bash 复制代码

# 使用 sudo 运行安装脚本
curl -fsSL https://openclaw.ai/install.sh | sudo bash

# 或者修复 npm 权限
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Q: Node.js 版本过低？

bash 复制代码

# 使用 n 模块升级 Node.js
npm install -g n
n 22

# 或使用 nvm
nvm install 22
nvm use 22

Q: Windows 上无法使用某些功能？

强烈建议使用 WSL2。WSL2 提供更完整的 Linux 兼容性，是 Windows 上运行 OpenClaw 的推荐方式。

Q: Docker 构建时内存不足？

确保分配至少 2GB 内存给 Docker：

Docker Desktop：Settings → Resources → Memory
Linux：确保系统有足够的可用内存

Q: 如何更新 OpenClaw？

推荐方式（重新运行安装脚本）：

bash 复制代码

curl -fsSL https://openclaw.ai/install.sh | bash

使用包管理器：

bash 复制代码

npm i -g openclaw@latest
# 或
pnpm add -g openclaw@latest

从源码更新：

bash 复制代码

openclaw update

Q: 如何切换更新通道？

bash 复制代码

# 切换到 Beta 通道
openclaw update --channel beta

# 切换到开发通道
openclaw update --channel dev

# 切换回稳定通道
openclaw update --channel stable

Q: 安装后 Gateway 无法启动？

检查端口是否被占用：

bash 复制代码

openclaw gateway --port 18790  # 使用其他端口

查看详细日志：
bash 复制代码
```
openclaw logs --follow
```
运行诊断工具：
bash 复制代码
```
openclaw doctor
```

总结

安装方式	适用平台	难度	推荐度
官方安装脚本	Linux, macOS	⭐ 简单	⭐⭐⭐⭐⭐
npm/pnpm 全局安装	Linux, macOS, Windows (WSL2)	⭐⭐ 中等	⭐⭐⭐⭐
Docker	Linux, macOS, Windows	⭐⭐ 中等	⭐⭐⭐⭐
源码安装	Linux, macOS, Windows (WSL2)	⭐⭐⭐ 较难	⭐⭐⭐
PowerShell 脚本	Windows 原生	⭐ 简单	⭐⭐

对于大多数用户，官方安装脚本 是最简单、最可靠的选择。Windows 用户强烈建议使用 WSL2 环境运行 OpenClaw。

最后更新：2026年3月

OpenClaw 安装指南：Linux 与 Windows 系统详细教程