安装备用方式：桌面应用、Docker 与 npm

上一课用官方安装器跑通了主路径；但 OpenClaw 下载与安装不止那一条路——公司电脑不让跑脚本、想要个桌面 App 常驻托盘、服务器上要容器化、或者你自己管 Node 不想被安装器代劳。这一课把桌面应用、Docker、npm / pnpm / Bun 直装、源码编译四条备用路线一次讲清，8 分钟后按你的场景挑一条走。本页基于 v2026.10.9。

学完你能做什么

下载并装上 Windows Hub（x64 / ARM64 签名安装包）或 macOS 菜单栏应用——全程不碰终端的 OpenClaw 下载方式
用 Docker 跑起容器化 Gateway：setup 脚本自动完成 onboarding，浏览器打开 18789 端口的 Control UI
用 npm / pnpm / Bun 三种包管理器直装 OpenClaw，并记住各自必带的那个参数
从源码编译安装，把 openclaw CLI 链接到自己的 checkout
用一张对照表按场景选出自己的路线（桌面版 / Docker / 直装 / 源码）

你现在的困境

公司电脑不让跑 curl | bash 这种脚本，想找个正经安装包双击装
我是 Windows / macOS 桌面用户，就想有个 App 在托盘或菜单栏待着，不想开终端
服务器上要容器化跑 7×24，或者我自己管 Node——安装器那套「自动补 Node」反而碍事

什么时候用这一招

当你需要：

一个图形界面的 OpenClaw 下载与安装方式（桌面应用）
一个隔离的、可抛弃的、不污染本机的 Gateway 环境（Docker）
用自己的包管理器装（npm / pnpm / Bun），或直接跑最新 main 分支（源码编译）

而且不想：

再走上一课的 curl | bash 官方安装器主路径
在系统里装一套 Node 运行时（桌面应用和 Docker 都自带运行时）

🎒 开始前的准备

走过安装：5 分钟跑通 OpenClaw——本页是它的备用路线补充；主路径能走就不用换
按你要走的路线备好环境（见下表）
一张「模型通行证」备着：桌面 App 首跑、Docker setup、openclaw onboard 都会引导你配模型凭据（Claude Code / Codex CLI 登录或 API Key，去处见连接模型总览）

各路线的环境要求

路线	你要先有
桌面应用	能下载安装包就行：Windows 10 20H2+ / Windows 11（Hub），macOS 26.2（Tahoe）+（菜单栏 App）
Docker	Docker Desktop 或 Docker Engine + Docker Compose v2；本地构建镜像至少 6 GB 内存
npm / pnpm / Bun 直装	Node 24.16.0+（24.x）或 26.1.0+（建议 24.22.1+ / 26.12.1+）；Bun 路线要 Bun 1.4.4+
源码编译	Node + Corepack（或自装 pnpm 12）+ git

⚠️ 国内网络

官方文档没有提供国内镜像或下载加速方案，本文不猜测镜像地址。从 GitHub Releases 下载桌面安装包、从 GHCR 拉镜像如果超时，先检查网络环境再重试；持续失败去装不上怎么办对照排查。

核心思路

所有安装方式装的都是同一样东西：一个 Gateway 进程 + openclaw CLI + 一份配置。四条备用路线的区别只在「Gateway 跑在哪、运行时谁来管」：

路线	Gateway 跑在哪	运行时	适合谁
官方安装器（上一课主路径）	本机后台服务	安装器缺 Node 自动补	想最快跑通
桌面应用	App 首跑时配置本地 Gateway，或连接已有远程 Gateway	App 自管运行时，不依赖系统 Node	不想碰终端的桌面用户
Docker / Podman	容器里	镜像自带	隔离环境、服务器、无本地安装
npm / pnpm / Bun 直装	本机（`--install-daemon` 装成服务）	你自己管	开发者、CI 批量装
源码编译	本机	你自己管 + pnpm	贡献者、要跑最新 main

四条路线互相独立，按你的场景选一条走就行；下面步骤编号连续，方便交叉引用。

跟我做

第 1 步：下载 OpenClaw 桌面版——Windows Hub 与 macOS 菜单栏应用

为什么：桌面应用是官方给「不碰终端」用户准备的 OpenClaw 下载方式——下载安装包、图形界面引导。Windows Hub 和 macOS 菜单栏 App 这两个原生桌面应用，都能在首跑设置时配好本地 Gateway，或者直接连一个已有的远程 Gateway。

Windows 用户：Windows Hub（官方推荐）

Windows 上官方最推荐 Windows Hub——原生 WinUI 伴侣应用，覆盖 Windows 10 20H2+ 和 Windows 11，免管理员安装，x64 / ARM64 安装包都带签名：

下载安装后，从开始菜单或系统托盘启动 OpenClaw Companion（安装器也会给 Gateway Setup、Chat、Settings、检查更新、卸载加快捷方式）。首次启动时如果没发现可用的 Gateway，会自动进入设置：最快的路是 Set up locally——它创建一个应用自管的 OpenClawGateway WSL 发行版，把 Gateway 装进去并完成配对，不动你已有的 Ubuntu 发行版。已有 Gateway 的选 Advanced setup，可以连本机 / WSL / 远程（URL + token）或走 SSH 隧道的 Gateway。

你应该看到：设置完成后托盘图标变绿；从托盘打开 Command Center，能看到连接、配对、节点状态和渠道健康都正常。

💡 直链 404 了？

Windows Hub 的发布节奏独立于 OpenClaw CLI 和 Gateway。上面的直链失效时，去 Windows Hub releases 页打开最新的稳定版。细节见官方 Windows 平台文档。

Windows 备选：跨平台 Tauri 桌面应用——安装包 OpenClaw-<version>-windows-x86_64.exe 随 OpenClaw 正式版发布（GitHub Releases），可以用内置 Bun 配一个本地 Windows Gateway，或连接远程 Gateway。

macOS 用户：菜单栏应用

macOS 桌面版是菜单栏伴侣应用：从 OpenClaw GitHub Releases 下载 OpenClaw-<version>.dmg（首选）或 .zip，安装并启动 OpenClaw.app。

系统要求：macOS 26.2（Tahoe）或更高。

你应该看到：全新安装首次启动时出现进度窗口——App 准备自带的运行时、在「This Mac」上启动 Gateway、打开 dashboard 的 onboarding 对话框；就绪后窗口自动关闭。之后菜单栏常驻 OpenClaw 图标，Quick Chat 默认按 ⌥Space 呼出。

💡 最新 Release 没有 macOS 包？

有些 Release 只带 CLI 或 Windows 资产。官方指引：用最新的带 macOS 包的版本——官方 macOS 应用页当前钉着 2026.10.3 的三个 DMG（Apple Silicon / Intel / Universal），细节见官方 macOS app 文档。

桌面 App 已启动：Windows 托盘图标变绿，或 macOS 菜单栏出现 OpenClaw 图标

第 2 步：用 Docker 跑起容器化 Gateway

为什么：官方对 OpenClaw Docker 路线的定位是「可选」——适合要一个隔离的、可抛弃的 Gateway 环境，或一台不做本地安装的主机。在自己开发机上日常用，官方建议走正常安装流程（上一课）。

先备好前提：

Docker Desktop（或 Docker Engine）+ Docker Compose v2
本地从源码构建镜像至少 6 GB 内存——用官方预构建镜像可以避开这条
磁盘空间够放镜像和日志

然后四条命令（setup 脚本要从仓库根目录跑，先克隆）：

bash

git clone https://github.com/openclaw/openclaw.git
cd openclaw
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh

OPENCLAW_IMAGE 指向官方预构建镜像（GitHub Container Registry 是主发布渠道，包页面）；不设置时脚本会在本地构建 openclaw:local。同一 Release 也在 Docker Hub 发布镜像 openclaw/openclaw。官方明确提醒：只用这两个官方地址，避开第三方镜像——它们的发布节奏和保留策略都不同步。要钉版本就用具体版本标签（如 2026.9.3）；变体有 slim、-browser（内置 Chromium）等，默认镜像捆绑 codex 和 diagnostics-otel 插件。

你应该看到：setup 自动完成 onboarding——提示输入 provider API Key → 生成 Gateway token 写进 .env → 通过 Docker Compose 启动 Gateway。

打开 Control UI：浏览器访问 http://127.0.0.1:18789/，把 .env 里的 token 粘贴进 Settings。忘了地址就重拿一次：

bash

docker compose run --rm openclaw-cli dashboard --no-open

容器健康检查（免认证，镜像内置的 HEALTHCHECK 打的就是它）：

bash

curl -fsS http://127.0.0.1:18789/healthz

你应该看到：healthz 正常返回；/startupz（启动检查）和 /readyz（深度就绪）也在同一端口。

curl http://127.0.0.1:18789/healthz 正常返回，Control UI 用 .env 里的 token 能登进去

💡 要在服务器上 7×24 跑？

本步只带你跑通容器化 Gateway。VPS 选型、compose 运维、公网暴露的安全规则（含 Docker DOCKER-USER 防火墙链），见服务器部署：Docker/VPS 上 7×24 运行与安全加固（一）。

第 3 步：npm / pnpm / Bun 直装

为什么：自己管 Node 的开发者不需要安装器代劳——OpenClaw npm 安装（pnpm / Bun 同理）一条命令装完，再跑 onboarding 把 Gateway 装成后台服务。这也是 CI / 批量机器上的标准路。

前提：Node 24.16.0+（24.x）或 26.1.0+（官方强烈建议 24.22.1+ / 26.12.1+）。先 node --version 核对。

方式 A：npm（npm 12 或 11.16+）

bash

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

npm 11.15 及更早：去掉 --allow-scripts=openclaw（那个版本既没有这个策略也没有这个选项）。

为什么带 --allow-scripts：npm 12 默认拦截未批准的包生命周期脚本，不加的话 OpenClaw 的 preinstall / postinstall 会被报 blocked because they are not covered by allowScripts。npm 11.16 接受这个选项但只警告、照样执行。

方式 B：pnpm

bash

pnpm add -g --allow-build=openclaw openclaw@latest
openclaw onboard --install-daemon

pnpm 对带构建脚本的包要求显式批准，而 approve-builds -g 不支持全局安装——所以把 --allow-build=openclaw 直接写在安装命令上。

方式 C：Bun

bash

bun add -g --trust openclaw@latest
bun run --bun openclaw onboard --install-daemon --daemon-runtime bun

--trust 放行 OpenClaw 的包生命周期脚本；bun run --bun 强制用 Bun 运行时，--daemon-runtime bun 把受管 Gateway 装在 Bun 下。Bun 1.4.4 及以上才能跑 OpenClaw 的 CLI、本地 agent 和 Gateway；Node 仍是主运行时——裸的 openclaw 可执行文件保持 Node shebang。

你应该看到：三种方式装完的结果一样——openclaw 命令可用，onboarding 引导照常走，Gateway 装成后台服务。

终端里 openclaw --version 能打印版本号

💡 手动 npm 安装与「新鲜度」策略

官方托管安装器会为 OpenClaw 包清除 min-release-age 这类 npm 新鲜度过滤；你手动 npm install -g 时，自己的 npm 策略照常生效。策略卡住安装时，先检查 npm 配置。

第 4 步：OpenClaw 源码编译安装

为什么：贡献者、想跑最新 main、或要改源码的人走这条——从 GitHub 克隆源码，pnpm 构建，把 CLI 链接到这份 checkout。

bash

git clone https://github.com/openclaw/openclaw.git
cd openclaw
corepack enable
pnpm install && pnpm build && pnpm ui:build
pnpm add --global "openclaw@link:$PWD"
openclaw onboard --install-daemon

三个细节：

pnpm add --global "openclaw@link:$PWD" 把 CLI 链接到当前 checkout，不改包文件；pnpm 报全局 bin 目录不在 PATH 时，跑 pnpm setup、重开终端再试
Corepack 会按 package.json 选定精确的 pnpm 版本（当前是 pnpm 12）
只跑 Gateway 的服务器 checkout 可用 pnpm build:runtime（不产出 TypeScript 声明）；不想全局安装就在仓库里直接 pnpm openclaw ...

你应该看到：构建无报错完成，openclaw 指向你本地的这份源码。

pnpm build 与 pnpm ui:build 都无报错结束

第 5 步：验证安装——三条命令确认 Gateway 活着

为什么：不管走哪条路线，装完都要用同一组命令确认——CLI 在、配置没毛病、Gateway 在跑。

bash

openclaw --version      # CLI 可用
openclaw doctor         # 检查配置问题
openclaw gateway status # Gateway 正在运行

你应该看到：--version 打印版本号（本教程基准 v2026.10.9）；doctor 给出体检结果；gateway status 显示 Gateway 正在运行、监听 18789。

Docker 路线的对应操作（Gateway 在容器里，宿主机没有它）：

bash

docker compose run --rm openclaw-cli dashboard --no-open   # 重新拿到 Control UI 地址
curl -fsS http://127.0.0.1:18789/healthz                   # 容器健康检查

三条验证命令都通过（Docker 路线用 healthz + dashboard）

检查点 ✅

桌面版路线：Windows Hub 托盘图标变绿，或 macOS 菜单栏 App 打开了 dashboard onboarding
Docker 路线：http://127.0.0.1:18789/healthz 正常返回，Control UI 用 .env 里的 token 登进去了
npm / pnpm / Bun 路线：openclaw --version 有输出，onboarding 走完
源码路线：pnpm build && pnpm ui:build 无报错，openclaw 链接到本地 checkout
我能对着「核心思路」的表说出自己场景该选哪条路线

踩坑提醒

❌ npm 12 直装报 `blocked because they are not covered by allowScripts`

原因：npm 12 默认拦截未批准的包生命周期脚本，OpenClaw 的 preinstall / postinstall 被拦下。

bash

# ❌ npm 12 不带参数
npm install -g openclaw@latest
# → blocked because they are not covered by allowScripts

# ✅ 带上允许脚本的参数
npm install -g openclaw@latest --allow-scripts=openclaw

版本差异要记牢：npm 11.16 接受该选项但只警告、照样执行；npm 11.15 及更早既无此策略也无此选项，命令里不要带它。另外，npm 11.16 建议的 npm approve-scripts openclaw 对全局安装无效——会报 ENOMATCH No installed packages match: openclaw。

❌ macOS 系统不够新，装不上菜单栏 App

原因：OpenClaw.app 要求 macOS 26.2（Tahoe）或更高，这个硬门槛不因 CLI 能跑而降低——官方 Node 24 / 26 的 macOS 二进制支持 macOS 13.5+，但「CLI 能跑」不等于「原生 App 兼容」。

正确做法：旧 Mac 走上一课的 CLI 安装路线（Node 官方二进制支持 macOS 13.5+）。

❌ Docker 本地构建镜像：内存不够或构建失败

原因：本地从源码构建 Gateway 镜像至少需要 6 GB 内存。

正确做法：用官方预构建镜像——export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest" 再跑 setup；同时只用 ghcr.io/openclaw/openclaw 或 Docker Hub 的 openclaw/openclaw，避开第三方镜像。

❌ pnpm 全局装完 `openclaw: command not found`

原因：pnpm 的全局 bin 目录不在 PATH 里。

正确做法：跑 pnpm setup，重开终端再试（官方源码安装一节的原话）。npm 全局装的同类问题（也是 PATH 居多）见装不上怎么办。

进阶技巧（可选）

本地前缀安装器：不碰系统 Node。 想把 OpenClaw 和 Node 一起收在 ~/.openclaw 本地前缀下、不依赖系统级 Node：

bash

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

它默认走 npm 安装，也支持同一前缀下的 git checkout 安装；装过之后用 openclaw update --channel dev / --channel stable 在包安装与 git 安装之间切换。

Bun-only 安装（官方 pinned fork）。 macOS 和 glibc Linux（arm64 / x64）上可以整条安装不落 Node：

bash

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

它下载该 Release 钉住的 OpenClaw Bun fork 并校验；省略 --runtime 时默认仍是 Node。macOS 上它会按需装 Homebrew SQLite（OpenClaw on Bun 拒绝 Apple 系统 SQLite）。细节见官方 Bun 文档。

跑最新 main（不手动编译）。 不想完整源码编译、又想跟 main 分支：

bash

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

Podman / Nix / 云平台。 不想用 Docker？官方另有 Podman rootless 路线（./scripts/podman/setup.sh，宿主机 CLI 做控制面）；Nix 用 flake 声明式安装；Ansible 做批量部署。云平台（Cloudflare、Render、Fly、Railway 等）与 VPS 上的 7×24 部署见服务器部署。

本课小结

✅ OpenClaw 下载的备用路线全铺开了：桌面版（Windows Hub / macOS 菜单栏 / Windows 备选 Tauri）、Docker 容器化、npm / pnpm / Bun 直装、源码编译——四条路装的都是同一个 Gateway + CLI + 配置，按场景挑一条。

✅ 桌面版会选了：Windows 官方推荐 Windows Hub（免管理员、签名安装包、自管 WSL Gateway）；macOS 菜单栏 App 要 macOS 26.2+。

✅ Docker 会跑了：OPENCLAW_IMAGE + ./scripts/docker/setup.sh，onboarding 自动完成，Control UI 在 18789。

✅ 直装的参数坑记住了：npm 12 / 11.16+ 带 --allow-scripts=openclaw，pnpm 带 --allow-build=openclaw，Bun 带 --trust。

关键命令回顾：

路线	关键命令 / 文件	说明
Windows Hub	`OpenClawCompanion-Setup-x64.exe` / `-arm64.exe`	官方推荐 Windows 桌面版；免管理员安装
macOS 菜单栏	`OpenClaw-<version>.dmg`	需 macOS 26.2（Tahoe）+
Windows 备选	`OpenClaw-<version>-windows-x86_64.exe`	Tauri 桌面 App，可内置 Bun
Docker	`OPENCLAW_IMAGE` + `./scripts/docker/setup.sh`	GHCR 为主渠道；Docker Hub 镜像 `openclaw/openclaw`
npm	`npm install -g openclaw@latest --allow-scripts=openclaw`	npm 12 / 11.16+；11.15 及更早去掉参数
pnpm	`pnpm add -g --allow-build=openclaw openclaw@latest`	`approve-builds -g` 不支持全局安装
Bun	`bun add -g --trust openclaw@latest`	Bun 1.4.4+；Node 仍是主运行时
源码	`pnpm install && pnpm build && pnpm ui:build`	Corepack 按 `package.json` 选 pnpm 版本
通用验证	`openclaw --version` / `openclaw doctor` / `openclaw gateway status`	任何路线装完都跑一遍

命令速查的完整清单见 CLI 命令与配置速查。

下一课预告

四条备用路线任选一条跑通后，兜底课压轴：装不上跑不通怎么办：安装与启动排错。

你会学到：

Node 版本不达标、openclaw command not found 这类安装期报错的排查步骤
Gateway 起不来时的诊断思路
更新失败怎么处理

安装备用方式：桌面应用、Docker 与 npm ​

学完你能做什么 ​

你现在的困境 ​

什么时候用这一招 ​

🎒 开始前的准备 ​

各路线的环境要求 ​

核心思路 ​

跟我做 ​

第 1 步：下载 OpenClaw 桌面版——Windows Hub 与 macOS 菜单栏应用 ​

Windows 用户：Windows Hub（官方推荐） ​

macOS 用户：菜单栏应用 ​

第 2 步：用 Docker 跑起容器化 Gateway ​

第 3 步：npm / pnpm / Bun 直装 ​

方式 A：npm（npm 12 或 11.16+） ​

方式 B：pnpm ​

方式 C：Bun ​

第 4 步：OpenClaw 源码编译安装 ​

第 5 步：验证安装——三条命令确认 Gateway 活着 ​

检查点 ✅ ​

踩坑提醒 ​

❌ npm 12 直装报 blocked because they are not covered by allowScripts ​

❌ macOS 系统不够新，装不上菜单栏 App ​

❌ Docker 本地构建镜像：内存不够或构建失败 ​

❌ pnpm 全局装完 openclaw: command not found ​

进阶技巧（可选） ​

本课小结 ​

下一课预告 ​

安装备用方式：桌面应用、Docker 与 npm

学完你能做什么

你现在的困境

什么时候用这一招

🎒 开始前的准备

各路线的环境要求

核心思路

跟我做

第 1 步：下载 OpenClaw 桌面版——Windows Hub 与 macOS 菜单栏应用

Windows 用户：Windows Hub（官方推荐）

macOS 用户：菜单栏应用

第 2 步：用 Docker 跑起容器化 Gateway

第 3 步：npm / pnpm / Bun 直装

方式 A：npm（npm 12 或 11.16+）

方式 B：pnpm

方式 C：Bun

第 4 步：OpenClaw 源码编译安装

第 5 步：验证安装——三条命令确认 Gateway 活着

检查点 ✅

踩坑提醒

❌ npm 12 直装报 `blocked because they are not covered by allowScripts`

❌ macOS 系统不够新，装不上菜单栏 App

❌ Docker 本地构建镜像：内存不够或构建失败

❌ pnpm 全局装完 `openclaw: command not found`

进阶技巧（可选）

本课小结

下一课预告