OpenClaw 安装指南
OpenClaw 是一个本地优先的个人 AI 助手,支持多种通讯渠道(WhatsApp、Telegram、Slack、Discord 等)。本文将详细介绍如何在 Linux 和 Windows 系统上安装 OpenClaw。
系统要求
| 项目 | 要求 |
|---|---|
| Node.js | ≥ 22 版本 |
| 内存 | 至少 2GB(推荐 4GB+) |
| 磁盘空间 | 至少 5GB 可用空间 |
| 网络 | 能够访问 npm 仓库和 GitHub |
检查 Node.js 版本:
node --version
Linux 系统安装
方法一:官方安装脚本(推荐)
这是最简单、最推荐的安装方式,适用于大多数 Linux 发行版(Ubuntu、Debian、CentOS、Fedora 等):
curl -fsSL https://openclaw.ai/install.sh | bash
安装脚本会自动完成以下操作:
- 检查系统依赖
- 安装或更新 Node.js(如需要)
- 通过 npm 安装 OpenClaw
- 创建必要的目录结构
方法二:使用 npm/pnpm 全局安装
如果你更喜欢使用包管理器手动安装:
使用 npm:
npm install -g openclaw@latest
使用 pnpm(推荐,速度更快):
pnpm add -g openclaw@latest
⚠️ 注意:不建议使用 Bun 作为 Gateway 运行时,因为存在 WhatsApp/Telegram 兼容性问题。
方法三:Docker 安装
如果你希望使用容器化部署:
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 运行 Docker 安装脚本
./docker-setup.sh
更多 Docker 配置选项,请参考 Docker 安装章节。
Windows 系统安装
前提条件
Windows 安装强烈建议通过 WSL2(Windows Subsystem for Linux)进行。原生 Windows 支持有限。
安装 WSL2
- 以管理员身份打开 PowerShell

