OpenClaw 怎么安装：命令行与桌面版系统对照

OpenClaw 是可在本机运行的开源 AI 助手，以下步骤可完成安装并启动首次配置。

先选安装方式：按系统和熟悉程度选

OpenClaw 的安装入口分为命令行安装、桌面应用和源码运行三类。官方首页目前列出的桌面版本包括 macOS v2026.10.10、Windows v2026.9.8-1，以及 Linux v2026.10.10；因此现在优先看桌面应用和命令行安装，不必先配置源码环境。

你的情况	推荐方式	适合原因	安装后主要操作
macOS 或 Linux，第一次安装	官方一键脚本	脚本会准备 Node.js 等运行环境	执行 openclaw onboard
已装好 Node.js，想保留版本控制	npm	命令直接，便于后续升级	执行 openclaw onboard
想修改 OpenClaw 本身	源码检出	可以查看和修改仓库内容	执行 pnpm openclaw onboard
Windows 用户不想配置终端	Windows 原生桌面应用	安装向导、托盘状态和聊天功能集成在应用中	启动应用完成设置

桌面应用不是另一套产品。官方说明，macOS、Windows 和 Linux 的应用会安装所需的 Node.js、网关、聊天和设置功能；如果应用安装顺利，就不必再执行一遍 npm 安装。Linux 页面提供 AppImage 和 Debian 包，Windows 页面提供原生 Hub、PowerShell CLI 安装器和 WSL2 网关等路径。

先完成三个前置检查

1. 确认系统类型。 macOS 和 Linux 可以直接使用官方脚本；Windows 10/11 可以使用桌面应用、PowerShell CLI 或 WSL2。官方安装文档要求 macOS、Linux 或 Windows。
2. 确认 Node.js 版本。 官方文档写明需要 Node 24.16.0+ 的 24.x，或 26.1.0+；官方更推荐 Node 26，并建议使用 24.22.1+ 或 26.12.1+ 以获得安全性改进。运行 node -v 查看版本；没有 Node.js 时，官方安装器会在 macOS 上配置 Node 26，在 Linux 上配置 Node 24 LTS。
3. 确认安装权限。 首次运行 macOS 安装时可能需要 Homebrew 的管理员权限。Windows 原生应用直接下载并运行安装程序；如果改用命令行，则在有权限的 PowerShell 中执行。

pnpm 只有从源码构建时才需要。不要为了普通安装提前安装 pnpm，否则只是增加排错路径。

方式一：macOS、Linux 用官方脚本安装

这是 macOS 和 Linux 最省步骤的方式。官方首页给出的命令是：

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

这条命令会下载官方安装脚本并执行。安装完成后，运行首次配置：

openclaw onboard

onboard 是首次启动向导，用来完成 OpenClaw 的初始化设置。执行前不要把“安装成功”和“配置完成”混为一谈：脚本结束后，还要看到向导启动，才算走到可使用状态。

如果已经安装过 Node.js，也希望使用 npm 管理 OpenClaw，则使用另一套官方命令：

npm i -g openclaw
openclaw onboard

不要在同一台机器上反复执行脚本和 npm 安装。若已经用脚本装好，继续用 openclaw update --channel stable 更新；如果需要测试开发通道，官方首页提供的是 openclaw update --channel dev。这两个通道的用途不同，普通安装不要为了“试试新功能”切到 dev。

方式二：Windows 下载桌面应用或用 PowerShell

Windows 10/11 用户可以先走桌面应用路径。官方首页列出的 Windows 版本为 v2026.9.8-1，提供 x64 和 ARM64 两种安装包：

• x64：下载 Windows x64 安装包
• ARM64：下载 Windows ARM64 安装包

下载后双击安装程序，安装完成后从开始菜单启动 OpenClaw。官方安装文档把原生 Windows Hub companion app 作为 Windows 的推荐选项，界面包含 setup、tray status、chat 和 node mode。

如果明确要在 PowerShell 中安装，官方文档提供的命令是：

iwr -useb https://openclaw.ai/install.ps1 | iex

这条命令只适合已经确认采用 PowerShell CLI 的用户。普通用户优先下载桌面应用，因为它不需要自己处理终端脚本、Node.js 和网关配置的组合问题。

Windows 10/11 还支持 WSL2 网关。官方文档将其列为 Windows 的另一种运行方式；如果你需要在 Linux 环境里运行 OpenClaw，再按 Windows 平台文档配置 WSL2，而不是先把桌面应用和 WSL2 两套实例同时启动。

方式三：从源码运行，适合需要改代码的人

源码方式适合要检查插件、修改 OpenClaw 或参与开发的人。官方首页给出的完整检出步骤如下：

git clone https://github.com/openclaw/openclaw.git
cd openclaw && corepack enable && pnpm install
pnpm openclaw onboard

这里的第一行是 git clone，第二行进入仓库并启用 Corepack、安装 pnpm 依赖，第三行直接从源码启动首次配置。官方说明源码检出采用 pnpm workspace（pnpm 工作区），因此 pnpm install 不能替换成 npm install。

如果只想使用 OpenClaw，不准备修改仓库，跳过源码方式。源码路径的维护成本更高，升级时还要处理仓库变更、依赖和本地开发状态；这是根据官方把源码列为独立安装入口，以及其使用 pnpm workspace 的说明作出的使用边界判断，不是官方对升级难度的承诺。

常见卡点：先分清安装器和运行环境

第一个容易混淆的卡点是“安装完成后没有 openclaw 命令”。官方首页把一键脚本、npm、源码和桌面应用列为不同入口：桌面应用不一定会向系统终端注册同名命令；npm 安装后应能使用 npm 全局 bin 目录中的命令；源码方式则通过 pnpm openclaw 运行。先判断当前走的是哪条路径，再决定是否需要补装 CLI。

第二个卡点是 Node.js 版本不匹配。官方安装文档明确列出了 Node 24.16.0+ 的 24.x 或 26.1.0+，并说明安装器可在缺少 Node.js 时为 macOS 配置 Node 26、为 Linux 配置 Node 24 LTS。遇到与 Node 运行时相关的问题，先运行：

node -v

再对照官方要求升级或切换版本；不要直接混用不同 Node 大版本排查 npm 全局包问题。

第三个卡点是平台下载错架构。官方首页分别列出 Windows x64、ARM64，以及 Linux x64 的 AppImage 和 Debian 包。下载前在系统设置中确认架构：普通 Intel/AMD 电脑选 x64，Apple Silicon 选 ARM64，Linux 按发行版选择 AppImage 或 .deb。这是按官方下载项做的选择，不是额外推测。

怎么算安装成功

命令行路径的成功标志有三个：

1. 安装命令执行完毕，没有停留在下载或依赖安装阶段；
2. openclaw onboard 能启动，并进入首次设置向导；
3. 首次配置完成后，桌面应用或命令行能够继续使用 OpenClaw，而不是停在“找不到命令”或 Node.js 错误提示。

源码路径则应看到 pnpm openclaw onboard 启动向导。桌面应用路径应能看到 OpenClaw 应用窗口；Windows 用户还应能看到安装后的应用入口，macOS 用户可从应用菜单启动 OpenClaw.app。

完成后可按需要更新：

openclaw update --channel stable

不要把“脚本返回成功”当成全部完成；真正的验收点是首次向导能运行，并且应用或 CLI 能继续执行后续设置。

延伸入口：安装后继续配置

安装和首次配置完成后，先看官方 Getting Started 文档，再按需要阅读 安装说明。平台细节分别进入 Windows 文档 和 Linux 文档；macOS、Linux 桌面包及发布文件可从 OpenClaw 官方仓库 和 官方发布页 获取。

如果需要在本地环境中继续检查项目代码，直接使用源码检出命令；如果只想快速把 OpenClaw 跑起来，选择对应系统的桌面应用，或执行官方脚本后运行 openclaw onboard。