OpenClaw 安装指南
OpenClaw 是一个本地优先的个人 AI 助手,支持多种通讯渠道(WhatsApp、Telegram、Slack、Discord 等)。本文将详细介绍如何在 Linux 和 Windows 系统上安装 OpenClaw。
OpenClaw 是一款本地优先的个人 AI 助手,支持 WhatsApp、Telegram 等多种通讯渠道。本文详细介绍了在 Linux 和 Windows 系统上的安装方法,包括官方脚本、npm/pnpm 全局安装、Docker 容器化及源码构建。系统要求 Node.js 版本不低于 22,内存至少 2GB。Windows 用户推荐使用 WSL2 环境。安装后需通过向导配置身份验证与网关,可使用 openclaw doctor 进行健康检查。常见问题涵盖权限、Node 版本及 Docker 资源限制等。
OpenClaw 是一个本地优先的个人 AI 助手,支持多种通讯渠道(WhatsApp、Telegram、Slack、Discord 等)。本文将详细介绍如何在 Linux 和 Windows 系统上安装 OpenClaw。
| 项目 | 要求 |
|---|
| Node.js | ≥ 22 版本 |
| 内存 | 至少 2GB(推荐 4GB+) |
| 磁盘空间 | 至少 5GB 可用空间 |
| 网络 | 能够访问 npm 仓库和 GitHub |
检查 Node.js 版本:
node --version
这是最简单、最推荐的安装方式,适用于大多数 Linux 发行版(Ubuntu、Debian、CentOS、Fedora 等):
curl -fsSL https://openclaw.ai/install.sh | bash
安装脚本会自动完成以下操作:
如果你更喜欢使用包管理器手动安装:
使用 npm:
npm install -g openclaw@latest
使用 pnpm(推荐,速度更快):
pnpm add -g openclaw@latest
⚠️ 注意:不建议使用 Bun 作为 Gateway 运行时,因为存在 WhatsApp/Telegram 兼容性问题。
如果你希望使用容器化部署:
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 运行 Docker 安装脚本
./docker-setup.sh
更多 Docker 配置选项,请参考 Docker 安装章节。
Windows 安装强烈建议通过 WSL2(Windows Subsystem for Linux)进行。原生 Windows 支持有限。
wsl --install
进入 WSL2 环境后,使用与 Linux 相同的安装命令:
curl -fsSL https://openclaw.ai/install.sh | bash
如果你不想使用 WSL2,可以尝试 PowerShell 安装脚本:
iwr -useb https://openclaw.ai/install.ps1 | iex
⚠️ 警告:Windows 原生支持不如 WSL2 完善,某些功能可能无法正常工作。
Docker 安装适合以下场景:
# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 运行安装脚本
./docker-setup.sh
脚本执行完成后:
http://127.0.0.1:18789/ 打开控制面板export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./docker-setup.sh
可用的镜像标签:
latest - 最新的稳定版本main - 最新的开发版本2026.2.26 - 特定版本号# 查看容器状态
docker compose ps
# 查看日志
docker compose logs -f openclaw-gateway
# 重启服务
docker compose restart
# 停止服务
docker compose down
适合开发者或需要最新功能的用户。
# 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
# 启动 Gateway(自动重载 TypeScript 更改)
pnpm gateway:watch
首次安装后,运行安装向导进行配置:
openclaw onboard --install-daemon
向导将引导你完成:
openclaw gateway status
# 自动在浏览器中打开 openclaw dashboard
# 或手动访问
# http://127.0.0.1:18789/
openclaw doctor
doctor 命令会:
# 查看状态
openclaw gateway status
# 前台运行(调试用)
openclaw gateway --port 18789 --verbose
# 停止服务
openclaw gateway stop
# 重启服务
openclaw gateway restart
# 查看日志
openclaw logs --follow
Linux/macOS:
# 使用 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
# 使用 n 模块升级 Node.js
npm install -g n
n 22
# 或使用 nvm
nvm install 22
nvm use 22
强烈建议使用 WSL2。WSL2 提供更完整的 Linux 兼容性,是 Windows 上运行 OpenClaw 的推荐方式。
确保分配至少 2GB 内存给 Docker:
推荐方式(重新运行安装脚本):
curl -fsSL https://openclaw.ai/install.sh | bash
使用包管理器:
npm i -g openclaw@latest # 或
pnpm add -g openclaw@latest
从源码更新:
openclaw update
# 切换到 Beta 通道
openclaw update --channel beta
# 切换到开发通道
openclaw update --channel dev
# 切换回稳定通道
openclaw update --channel stable
运行诊断工具:
openclaw doctor
查看详细日志:
openclaw logs --follow
检查端口是否被占用:
openclaw gateway --port 18790 # 使用其他端口
| 安装方式 | 适用平台 | 难度 | 推荐度 |
|---|---|---|---|
| 官方安装脚本 | Linux, macOS | ⭐ 简单 | ⭐⭐⭐⭐⭐ |
| npm/pnpm 全局安装 | Linux, macOS, Windows (WSL2) | ⭐⭐ 中等 | ⭐⭐⭐⭐ |
| Docker | Linux, macOS, Windows | ⭐⭐ 中等 | ⭐⭐⭐⭐ |
| 源码安装 | Linux, macOS, Windows (WSL2) | ⭐⭐⭐ 较难 | ⭐⭐⭐ |
| PowerShell 脚本 | Windows 原生 | ⭐ 简单 | ⭐⭐ |
对于大多数用户,官方安装脚本是最简单、最可靠的选择。Windows 用户强烈建议使用 WSL2 环境运行 OpenClaw。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online