OpenClaw 2026.4.1 全平台安装教程（Windows / macOS / Linux）最新版

OpenClaw 2026.4.1 是截至 2026 年 4 月的最新稳定版本，带来了全新的 /tasks 心跳任务看板、SQLite 持久化任务注册表和多项安全加固。本文是针对该版本的全平台安装一站式指南，覆盖 macOS、Linux 和 Windows 三大平台，无论你是第一次安装还是从旧版本升级，本文都能帮你快速完成。更多资源请访问 OpenClaw 中文版官网。

一、安装前必读：系统要求与安全提示

系统要求

平台推荐优先级

• 🥇 macOS：体验最完整，原生支持语音唤醒、iMessage、Canvas、菜单栏 App，Apple Silicon M 系列芯片能效最佳
• 🥈 Linux：服务器部署首选，稳定性高，systemd 守护进程支持完善，VPS 运行推荐
• 🥉 Windows：通过 WSL2 安装体验与 Linux 相当，原生安装存在已知 Bug，不推荐生产环境使用

安全提示：OpenClaw 拥有读取文件、执行命令、发送消息等系统级权限。强烈建议不要安装在存有个人敏感数据（iCloud 同步、密码管理器、工作文档）的主力设备上，推荐使用专用 Mac Mini、独立 VPS 或虚拟机部署。

二、macOS 安装教程

macOS 是 OpenClaw 体验最好的平台，社区中 Mac Mini M4（16GB）已成为运行 OpenClaw 的标准硬件选择。

第一步：安装 Node.js

推荐通过 Homebrew 安装 Node.js v24：

# 如未安装 Homebrew，先安装
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Apple Silicon 用户需将 Homebrew 加入 PATH
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# 安装 Node.js v24
brew install node@24

# 验证版本
node --version   # 应显示 v24.x.x
npm --version

或者使用 nvm 管理多版本 Node：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.zshrc
nvm install 24
nvm use 24

第二步：安装 OpenClaw 2026.4.1

方式一：官方一键安装脚本（最简单）

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

脚本会自动检测系统环境、安装 OpenClaw CLI，并启动引导向导。

方式二：通过 npm 安装

npm install -g openclaw@latest

# 如遇 libvips 冲突报错（Sharp 构建错误），加环境变量重试
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

方式三：通过 pnpm 安装

pnpm add -g openclaw@latest
# pnpm 需要显式批准包含构建脚本的包
pnpm approve-builds -g

第三步：验证安装

openclaw --version
# 应显示：2026.4.1

如果提示”命令未找到”，是 npm 全局目录不在 PATH 中，执行以下修复：

echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

第四步：运行引导向导

openclaw onboard --install-daemon

引导向导依次配置：安全确认 → 选择 AI 模型服务商 → 输入 API Key → 配置 Gateway 绑定（选 Loopback）→ 可选配置消息平台 → 安装守护进程。

--install-daemon 会将 Gateway 注册为 macOS launchd 服务，系统启动后自动运行，无需手动启动终端。

第五步（可选）：安装 macOS 伴侣 App

macOS 伴侣 App 提供菜单栏快速入口、语音唤醒（Voice Wake）和系统级功能集成：

1. 前往 GitHub Releases 页面（github.com/openclaw/openclaw/releases）
2. 下载最新的 OpenClaw-macOS-Universal.dmg（当前对应 app 版本 2026.3.22）
3. 安装后，菜单栏出现🦞图标，在 Settings → Gateway 中填入本地 Gateway 地址和 Token 完成配对

三、Linux 安装教程（Ubuntu / Debian）

Linux 是服务器部署的首选，以下步骤以 Ubuntu 24.04 LTS 为例。

第一步：系统初始化

# 更新系统包
sudo apt update && sudo apt upgrade -y

# 安装必要依赖
sudo apt install -y curl git build-essential

第二步：安装 Node.js v24

# 方式一：通过 nvm（推荐，便于版本管理）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 24
nvm use 24
nvm alias default 24

# 方式二：通过 NodeSource 官方源
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

# 验证
node --version   # v24.x.x

第三步：安装 OpenClaw

# 一键安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash

# 或通过 npm
npm install -g openclaw@latest

# 验证
openclaw --version

第四步：运行引导向导

openclaw onboard --install-daemon

--install-daemon 在 Linux 上会注册为 systemd 用户服务，实现开机自启。如果 systemd 守护进程注册失败，可手动管理服务：

# 查看服务状态
systemctl --user status openclaw-gateway

# 手动启动 / 停止
systemctl --user start openclaw-gateway
systemctl --user stop openclaw-gateway

# 设置开机自启
systemctl --user enable openclaw-gateway

在 VPS 上的额外配置

# 配置防火墙（只允许本地访问控制面板）
sudo ufw allow 22/tcp   # SSH
sudo ufw deny 18789/tcp # 禁止外网直访控制面板
sudo ufw enable

# 建议以非 root 用户运行 OpenClaw
sudo adduser openclaw
sudo usermod -aG sudo openclaw
su - openclaw

四、Windows 安装教程

Windows 安装分为两个路径：WSL2（推荐）和原生 PowerShell（不推荐生产环境）。

安全警告：如果你使用的是 2026.2.25 之前的 OpenClaw 原生 Windows 版本，请立即升级。2026 年 3 月披露的 CVE-2026-22176 漏洞影响 Windows 计划任务自启机制，2026.4.1 版本已修复。WSL2 和 Docker 方式不受此漏洞影响。

方式一：WSL2 安装（强烈推荐）

步骤 1：安装 WSL2

以管理员身份打开 PowerShell，执行：

wsl --install

如果系统提示重启，重启后 WSL2 会自动完成安装（默认安装 Ubuntu）。

验证安装：

wsl --list --verbose
# 应显示：Ubuntu  Running  2

步骤 2：在 WSL2 中安装 Node.js 和 OpenClaw

打开 Ubuntu 终端，执行：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# 安装 Node.js v24
nvm install 24
nvm use 24

# 安装 OpenClaw
npm install -g openclaw@latest

# 验证
openclaw --version

步骤 3：运行引导向导

openclaw onboard --install-daemon

WSL2 环境下，OpenClaw 使用 systemd 守护进程，完全等同于原生 Linux 体验，支持 /restart 命令和稳定的后台运行。

方式二：原生 PowerShell 安装（仅用于快速测试）

如果你只是想快速体验，不需要 24 小时稳定运行，可以使用原生 Windows 安装：

安装 nvm-windows

1. 前往 github.com/coreybutler/nvm-windows/releases 下载 nvm-setup.exe 安装
2. 以管理员身份打开 PowerShell，执行：

nvm install 24
nvm use 24
npm install -g openclaw@latest
openclaw --version

Windows 原生安装已知问题

• 启动时出现控制台窗口（#10933）：守护进程启动时会闪现或常驻一个 PowerShell 窗口，已知 Bug，暂无完美修复
• 重启后端口被占用（#41804）：Gateway 崩溃重启时，旧进程持续占用 18789 端口，需手动终止。临时修复：netstat -ano | findstr :18789 找到 PID，再 taskkill /PID <PID> /F
• /restart 命令无效：原生 Windows 无 launchctl/systemctl，该命令不可用。WSL2 和 Docker 方式正常支持

以上问题在 WSL2 中均不存在，生产环境请使用 WSL2 方式。

五、引导向导配置指南（三平台通用）

无论哪个平台，运行 openclaw onboard --install-daemon 后，引导向导的步骤是相同的：

1. 安全确认：阅读风险提示，用方向键选择”Yes”继续
2. 选择安装模式：选 QuickStart（快速）或 Manual（手动），新手选 QuickStart
3. 选择 AI 模型服务商：
   • 国际用户：推荐 Anthropic Claude 或 OpenAI
   • 国内用户：推荐 DeepSeek（价格最低）、智谱 GLM 或选 Qwen（扫码授权，无需 API Key）
4. 输入 API Key：粘贴对应服务商的密钥，向导自动验证
5. 选择默认模型：建议新手选 Sonnet 系列（性价比最高），复杂任务再升级 Opus
6. Gateway 绑定方式：务必选择 Loopback（本机回环），防止局域网内其他设备访问控制面板
7. 配置消息平台（可选）：可暂时跳过，安装后在控制面板中配置
8. 安装 Hooks：建议全部选中
9. 完成并重启：选择 Restart 应用所有配置

引导完成后，终端会显示：

• Web 控制面板地址：http://127.0.0.1:18789
• Gateway 访问 Token（请复制保存，登录控制面板时需要）

六、验证安装是否成功

# 检查版本
openclaw --version
# 预期输出：2026.4.1

# 全面健康检查
openclaw doctor

# 查看 Gateway 运行状态
openclaw gateway status

# 打开 Web 控制面板
openclaw dashboard
# 或在浏览器直接访问：http://127.0.0.1:18789

在浏览器中打开 http://127.0.0.1:18789，粘贴 Token 后点击 Connect，看到 Gateway 状态为 Connected，说明安装完全成功。

七、从旧版本升级到 2026.4.1

# 升级到最新稳定版
npm install -g openclaw@latest

# 或使用内置升级命令（保持当前更新频道）
openclaw update --channel stable

# 切换到 Beta 频道（体验新功能）
openclaw update --channel beta

# 切换回稳定版
openclaw update --channel stable

# 升级后务必运行健康检查
openclaw doctor

升级提示：v2026.4.1 对执行权限逻辑有调整，升级后运行 openclaw doctor 检查是否出现权限配置不一致警告，并根据提示调整 exec-approvals.json。

八、各平台常见报错速查

通用报错

macOS 专属

• Apple Silicon PATH 问题：确认 /opt/homebrew/bin 已在 PATH 中（执行 brew doctor 检查）
• Gateway 重启后不自动启动：重新执行 openclaw onboard --install-daemon 重新注册 launchd 服务

Linux 专属

• systemd 守护进程加载失败：检查是否以 root 用户运行（不推荐），改用普通用户 + sudo
• VPS 上的 SQLite 临时文件报错（2026.2.19+ 已修复）：确认 TMPDIR 环境变量正确设置

Windows 专属

• WSL2 安装后无法访问 127.0.0.1:18789：在 Windows 浏览器中访问时，需将 127.0.0.1 替换为 WSL2 的实际 IP（执行 wsl hostname -I 查看）
• 原生 Windows 端口被占用：见上方”已知问题”，建议改用 WSL2

九、安装后推荐的第一步

1. 运行 openclaw doctor 确认所有配置项通过
2. 在 Web 控制面板的 Skills 中安装 weather 技能，发一句”今天天气怎么样”测试连通性
3. 连接一个消息平台（推荐 Telegram，5 分钟内完成），体验手机端控制 AI 的感觉
4. 创建第一条 HEARTBEAT.md 任务，设置每日早报，感受 AI 主动推送的体验
5. 定期更新：npm install -g openclaw@latest（建议每周检查一次，安全补丁频繁发布）

总结

三个平台的安装核心流程是一致的：安装 Node.js v24 → 一行命令安装 OpenClaw → 引导向导完成配置 → openclaw doctor 验证。主要差异在于：macOS 用 launchd、Linux 用 systemd、Windows 强烈建议通过 WSL2 获得与 Linux 相同的体验。

如果在安装过程中遇到任何问题，优先运行 openclaw doctor 获取自动诊断，或访问 OpenClaw 中文版官网 查阅完整文档和中文社区支持。