本页内容

本页内容

安装概述

安装

系统要求

  • Node 24.16+ or 26.1+ - Node 26被推荐;安装者规定Node 26 on macOS和Node 24 LTS on Linux什么时候Node缺失(参见Node.js兼容性)。
  • macOS、Linux 或 Windows - Windows 用户可以从原生 Windows Hub 应用、PowerShell CLI 安装程序或 WSL2 Gateway 开始。请参阅 Windows。
  • 只有在从源代码构建时才需要 pnpm。

下载桌面应用程序

更喜欢普通的应用程序下载而不是 CLI? OpenClaw 附带桌面伴侣:

在 Windows 上,跨平台 Tauri 桌面应用程序 是备份选项。其 OpenClaw-<version>-windows-x86_64.exe 安装程序随常规 OpenClaw 版本 一起提供,并且可以设置带有捆绑的 Bun 的本地 Windows 网关或远程连接。

两个本机桌面应用程序都可以在首次运行设置期间配置本地网关,或连接到现有的远程网关。

推荐:安装脚本

最快的安装方式。它会检测您的 OS,根据需要安装 Node,安装 OpenClaw,然后启动登录。

macOS / Linux / WSL2

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

Windows (PowerShell)

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

若要安装但不运行引导流程:

macOS / Linux / WSL2

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

Windows (PowerShell)

powershell
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

对于所有标志和 CI/automation 选项,请参阅 Installer 内部 。

其他安装方式

本地前缀安装器(install-cli.sh)

当你希望将 OpenClaw 和 Node 保持在本地前缀下,例如 ~/.openclaw,而不依赖系统级 Node 安装时,请使用此方式:

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

默认支持 npm 安装,并且也支持在相同前缀流程下进行 git 检出安装。完整参考:安装程序内部机制。

已经安装好了?可通过 openclaw update --channel dev 和 openclaw update --channel stable 在包安装和 git 安装之间切换。请参阅 更新。

npm、pnpm 或 bun

如果你已经自行管理 Node:

npm

On npm 12 or npm 11.16+:

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

在 npm 11.15 及更早版本上,使用相同的命令而不使用 --allow-scripts=openclaw。

pnpm

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

包子

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

来自源码

适用于贡献者或任何想要从本地检出版本运行的人:

bash
git clone https://github.com/openclaw/openclaw.gitcd openclawcorepack enablepnpm install && pnpm build && pnpm ui:buildpnpm add --global "openclaw@link:$PWD"openclaw onboard --install-daemon

pnpm add --global "openclaw@link:$PWD" 将 CLI 链接到此签出,而不更改其包文件。如果 pnpm 报告其全局 bin 目录不在 PATH 上,请运行 pnpm setup,重新打开 shell,然后重试。

对于仅运行 OpenClaw 的服务器签出,请使用 pnpm build:runtime 构建 JavaScript、插件、Control UI 和元数据,而无需 TypeScript 声明。使用pnpm build进行需要声明及其验证的开发或包装; CI 类型检查仍然适用于仅运行时的构建。

Corepack 从 package.json(当前为 pnpm 12)中选择确切的 pnpm 版本。如果 Corepack 不可用,请从结帐中读取该版本并显式安装它:

bash
pnpm_spec=$(node -p "require('./package.json').packageManager.split('+')[0]")npm install -g "$pnpm_spec" --allow-scripts="$pnpm_spec"

+ 后缀记录 Corepack 的完整性哈希,不是 npm 包说明符的一部分。保持 npm 安装脚本和可选依赖项启用,以便 pnpm 可以配置其本机可执行文件。

或者跳过全局安装并从存储库内部使用 pnpm openclaw ...。有关完整的开发工作流程,请参阅 Setup。

独立构建

对于没有单独安装 Node 或 Bun 的应用程序打包或部署,请从源构建可执行文件和配套运行时目录。有关模式、输出文件、签名和更新边界,请参阅 Standalone builds。

从 GitHub main 检出版本安装

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

容器和包管理器

验证安装

bash
openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw gateway status # verify the Gateway is running

如果你希望安装后由系统托管启动:

  • macOS:通过 openclaw onboard --install-daemon 或 openclaw gateway install 创建 LaunchAgent
  • Linux/WSL2:通过相同命令创建 systemd 用户服务
  • 原生 Windows:优先使用计划任务;如果创建任务被拒绝,则回退为每用户的 Startup 文件夹登录项

Next:运行载入并连接通道

托管与部署

在云服务器或VPS上部署OpenClaw。请参阅 Linux 服务器 了解完整的提供商选择器(DigitalOcean、Hetzner、Hostinger、Fly.io、GCP、Azure、Railway、Northflank、Oracle Cloud、 Raspberry Pi 等),在 Render 上以声明方式部署,或尝试实验性 Cloudflare Containers 模板。

备份、更新、迁移或卸载

故障排查:找不到 openclaw

这几乎总是一个 PATH 问题:npm 的全局 bin 目录不在你的 shell 的 PATH 中。请参阅 Node.js 故障排查 获取完整修复方法,包括 Windows 路径。

bash
node -v           # Node installed?npm prefix -g     # Where are global packages?echo "$PATH"      # Is the global bin dir in PATH?
本页有帮助吗?