本页内容
本页内容
安装概述
安装
系统要求
- 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(推荐):本机 Windows Hub 配套应用程序 — 您可以像任何 Windows 应用程序一样下载和运行的签名安装程序,具有设置、托盘状态、聊天和节点模式:
- macOS:macOS 菜单栏应用程序 — 从以下位置下载
OpenClaw-<version>.dmg(首选)或.zip资源OpenClaw GitHub 发布,然后安装并启动OpenClaw.app。有关详细信息,请参阅 macOS 应用程序页面,包括当最新版本未提供 macOS 资产时应执行的操作。
在 Windows 上,跨平台 Tauri 桌面应用程序 是备份选项。其 OpenClaw-<version>-windows-x86_64.exe 安装程序随常规 OpenClaw 版本 一起提供,并且可以设置带有捆绑的 Bun 的本地 Windows 网关或远程连接。
两个本机桌面应用程序都可以在首次运行设置期间配置本地网关,或连接到现有的远程网关。
推荐:安装脚本
最快的安装方式。它会检测您的 OS,根据需要安装 Node,安装 OpenClaw,然后启动登录。
macOS / Linux / WSL2
Windows (PowerShell)
若要安装但不运行引导流程:
macOS / Linux / WSL2
Windows (PowerShell)
对于所有标志和 CI/automation 选项,请参阅 Installer 内部 。
其他安装方式
本地前缀安装器(install-cli.sh)
当你希望将 OpenClaw 和 Node 保持在本地前缀下,例如 ~/.openclaw,而不依赖系统级 Node 安装时,请使用此方式:
默认支持 npm 安装,并且也支持在相同前缀流程下进行 git 检出安装。完整参考:安装程序内部机制。
已经安装好了?可通过 openclaw update --channel dev 和 openclaw update --channel stable 在包安装和 git 安装之间切换。请参阅 更新。
npm、pnpm 或 bun
如果你已经自行管理 Node:
npm
On npm 12 or npm 11.16+:
在 npm 11.15 及更早版本上,使用相同的命令而不使用 --allow-scripts=openclaw。
pnpm
包子
来自源码
适用于贡献者或任何想要从本地检出版本运行的人:
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 不可用,请从结帐中读取该版本并显式安装它:
+ 后缀记录 Corepack 的完整性哈希,不是 npm 包说明符的一部分。保持 npm 安装脚本和可选依赖项启用,以便 pnpm 可以配置其本机可执行文件。
或者跳过全局安装并从存储库内部使用 pnpm openclaw ...。有关完整的开发工作流程,请参阅 Setup。
独立构建
对于没有单独安装 Node 或 Bun 的应用程序打包或部署,请从源构建可执行文件和配套运行时目录。有关模式、输出文件、签名和更新边界,请参阅 Standalone builds。
从 GitHub main 检出版本安装
容器和包管理器
自动化集群配置。
可选依赖安装器和包脚本运行器。
容器化或无头部署。
通过 Nix flake 进行声明式安装。
Docker 的无 root 容器替代方案。
验证安装
如果你希望安装后由系统托管启动:
- 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 模板。
实验性的 Worker + Container 部署。
共享 Docker 步骤。
K8s 部署。
隔离本地或托管 macOS 部署。
通过 SSH- 隧道访问托管 Linux 主机。
选择一个提供商。
备份、更新、迁移或卸载
故障排查:找不到 openclaw
这几乎总是一个 PATH 问题:npm 的全局 bin 目录不在你的 shell 的 PATH 中。请参阅 Node.js 故障排查 获取完整修复方法,包括 Windows 路径。