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