OpenClaw 安装教程：桌面版、脚本、npm 与源码方式对比

安装 OpenClaw 前，先决定你要的是普通桌面体验、本机命令行 Gateway、可复现的服务器部署，还是参与源码开发。不同方式最终可能运行相同核心能力，但更新渠道、Node.js 管理、权限边界和排障方法并不相同。

以下命令按 2026 年 9 月 1 日官方文档核验。安装脚本、最低版本和下载文件会变化，执行前请确认域名是 openclaw.ai、docs.openclaw.ai 或官方 GitHub 组织。

OpenClaw 系统要求

官方目前支持 macOS、Linux 与 Windows。Windows 用户可以选择原生 Windows Hub、PowerShell 安装器或 WSL2 Gateway。命令行安装需要受支持的 Node.js：Node 22.22.3+、24.15+ 或 25.9+（包含 Node 26）；官方当前推荐 Node 26。

运行以下命令查看现有环境：

node -v
uname -a

Windows PowerShell 可使用 node -v 和系统设置确认架构。只有从源码构建时才必须准备 pnpm；普通官方脚本会处理主要依赖。

方法一：下载桌面应用

不希望先管理终端和 Node.js 的用户，可以从OpenClaw 官网提供的官方入口下载 macOS 或 Windows 应用。Windows Hub 包含设置、托盘状态、聊天和 node mode；macOS 使用 .dmg 或 .zip 安装包。

桌面应用首次运行时可以配置本机 Gateway，或连接现有远程 Gateway。下载后检查发布者和代码签名，不要使用网盘重新打包的“中文版”或第三方破解安装器。

方法二：使用官方安装脚本

这是官方推荐的命令行路径。macOS、Linux 或 WSL2 运行：

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

Windows PowerShell 运行：

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

脚本会识别系统，在缺少 Node.js 时按平台配置受支持版本，安装 OpenClaw 并启动引导。安全要求较高时，可先下载脚本并人工检查，再在测试账户中执行；不要把审查脚本简化为只确认文件名。

方法三：使用 npm 或 pnpm

已经自行管理 Node.js 的开发者，可以用包管理器全局安装。当前 npm 12 或 npm 11.16+ 的官方命令要求明确允许 OpenClaw 生命周期脚本：

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

使用 pnpm 时，构建脚本也需要显式批准：

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

不要为了绕过权限错误而长期使用 sudo npm install -g。优先使用版本管理器或用户可写的全局前缀，并继续查看OpenClaw Node.js 环境配置。

容器、源码与本地前缀怎么选

服务器或隔离部署可以评估 Docker、Podman、Nix、Ansible 或官方托管指南。容器并不会自动解决凭据、持久化和网络暴露问题；部署前仍要规划状态卷、备份、Gateway 认证和升级策略。

贡献者可以从官方 GitHub 克隆源码，使用仓库锁定的 pnpm 构建。普通用户不应把 main 分支当作稳定发行版。若希望避免系统级 Node 和全局目录，官方 install-cli.sh 可把 Node 与 OpenClaw 放在 ~/.openclaw 本地前缀。

安装后如何验证

完成任一方式后依次运行：

openclaw --version
openclaw doctor
openclaw gateway status

版本命令确认 CLI 可用；doctor 检查配置与依赖；Gateway 状态用于确认后台服务。然后打开 Control UI，完成一次低风险对话，并检查工具调用是否经过预期审批。

如果终端提示 openclaw: command not found，通常是全局 bin 目录没有进入 PATH。运行 npm prefix -g 找到前缀，再按所用 shell 或 Windows 环境变量设置路径。不要重复安装多个副本来掩盖 PATH 问题。

推荐的安装选择

• 普通 macOS/Windows 用户：优先官方桌面应用。
• 希望运行本机 Gateway 的开发者：优先官方安装脚本。
• 已有成熟 Node.js 管理规范的团队：使用 npm/pnpm 并锁定通道。
• 服务器与可复现部署：采用官方容器或平台指南，并配置持久化与认证。
• OpenClaw 贡献者：从源码构建，使用隔离开发环境。

无论选择哪种方式，都应记录安装来源、版本通道、配置位置和卸载方法。可维护的安装不只是“命令成功”，而是下次升级或故障时，仍能解释当前环境来自哪里。

发布日期

2026年9月1日

信息核验

2026年9月1日

作者

AI Tool Blog 编辑部