安装
系统要求¶
- Node 24.16+ 或 26.1+ - 推荐使用 Node 26；当系统缺少 Node 时，安装程序会在 macOS 上安装 Node 26，在 Linux 上安装 Node 24 LTS（参见 Node.js 兼容性）。
- macOS、Linux 或 Windows - Windows 用户可以从原生的 Windows Hub 应用、PowerShell CLI 安装程序或 WSL2 Gateway 开始。参见 Windows。
- 仅当你从源码构建时才需要
pnpm。
下载桌面应用¶
比起 CLI，更喜欢普通的应用下载？OpenClaw 提供了桌面伴侣应用：
- Windows：Windows Hub 伴侣应用——一个已签名的安装程序，你可以像安装任何 Windows 应用一样下载并运行它，包含设置、托盘状态、聊天和节点模式：
- OpenClawCompanion-Setup-x64.exe
- OpenClawCompanion-Setup-arm64.exe
- 所有 Hub 版本：Windows Hub 发布页面
- macOS：macOS 菜单栏应用——从 OpenClaw GitHub Releases 下载
OpenClaw-<version>.dmg（推荐）或.zip资源，然后安装并启动 OpenClaw.app。详细信息请参阅 macOS 应用页面，包括当最新版本没有附带 macOS 资源时该怎么做。
两款桌面应用都可以在首次运行设置期间配置本地 Gateway，也可以连接到现有的远程 Gateway。
推荐：安装脚本¶
这是最快的安装方式。它会检测你的操作系统，在需要时安装 Node，安装 OpenClaw，并启动引导流程。
Note
Windows 桌面用户也可以安装原生的 Windows Hub 伴侣应用，其中包含设置、托盘状态、聊天、节点模式和本地 MCP 模式。
要安装但不运行引导流程：
有关所有标志和 CI/自动化选项，请参阅 安装程序内部机制。
其他安装方法¶
本地前缀安装程序（install-cli.sh）¶
当你希望将 OpenClaw 和 Node 放在 ~/.openclaw 之类的本地前缀目录下，而不依赖系统级 Node 安装时，可以使用此方式：
它默认支持 npm 安装，也支持在同一前缀流程下进行 git checkout 安装。完整参考：安装程序内部机制。
已经安装好了？可以通过 openclaw update --channel dev 和 openclaw update --channel stable 在包安装和 git 安装之间切换。参见 更新。
npm、pnpm 或 bun¶
如果你已经自行管理 Node：
在 npm 12 或 npm 11.16+ 上：
在 npm 11.15 及更早版本上，使用相同的命令但不带 --allow-scripts=openclaw。
Note
npm 12 默认会阻止未经批准的包生命周期脚本。--allow-scripts=openclaw 选项会显式允许 OpenClaw 的 preinstall 和 postinstall 步骤；没有该选项时，npm 会将这些脚本报告为 blocked because they are not covered by allowScripts。
npm 11.16 接受该选项，但只会警告这些脚本 not yet covered by allowScripts，并且仍然会运行它们。npm 11.15 及更早版本既没有该策略也没有该选项，因此它们的命令不能带该选项。npm 11.16 建议的 npm approve-scripts openclaw 命令不适用于全局安装——它会以 ENOMATCH No installed packages match: openclaw 失败。
Note
托管安装程序会清除针对 OpenClaw 包安装的 npm 新鲜度过滤器（如 min-release-age）。如果你使用 npm 手动安装，你自己的 npm 策略仍然适用。
Note
pnpm 要求显式批准带有构建脚本的包。全局安装不支持 approve-builds -g，因此请在 pnpm add -g 命令中传递 --allow-build=openclaw。
bun add -g --trust openclaw@latest
bun run --bun openclaw onboard --install-daemon --daemon-runtime bun
Note
--trust 允许 OpenClaw 的包生命周期脚本在此次安装中运行。Bun 1.4 或更新版本也可以运行 OpenClaw 的 CLI、本地 agent 和 Gateway。Node 仍然是主要运行时，因此普通的 openclaw 可执行文件会保留其 Node shebang。bun run --bun 会强制使用 Bun 运行时，而 --daemon-runtime bun 会在 Bun 下安装受管理的 Gateway。
从源码构建¶
适用于贡献者或任何想从本地检出运行的人：
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 链接到此检出目录，而不会更改其包文件。如果 pnpm 报告其全局 bin 目录不在 PATH 中，请运行 pnpm setup，重新打开 shell，然后重试。
Corepack 会从 package.json 中选择精确的 pnpm 版本（当前为 pnpm 12）。
如果 Corepack 不可用，请显式安装该版本：
npm install -g pnpm@12.3.4 --allow-scripts=pnpm@12.3.4；保持 npm 安装脚本和可选依赖处于启用状态，以便 pnpm 能够配置其原生可执行文件。
或者跳过全局安装，直接在仓库内使用 pnpm openclaw ...。完整的开发工作流请参阅 设置。
从 GitHub main 分支安装¶
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main
容器与包管理器¶
自动化集群配置。
可选的依赖安装器和包脚本运行器。
容器化或无头部署。
通过 Nix flake 进行声明式安装。
无需 root 权限的 Docker 替代容器方案。
验证安装¶
openclaw --version # confirm the CLI is available
openclaw doctor # check for config issues
openclaw gateway status # verify the Gateway is running
如果你希望在安装后由系统管理开机自启：
- macOS：通过
openclaw onboard --install-daemon或openclaw gateway install使用 LaunchAgent - Linux/WSL2：通过相同命令使用 systemd 用户服务
- 原生 Windows：首先使用计划任务；如果创建任务被拒绝，则回退到每用户“启动”文件夹中的登录项
下一步：运行引导并连接渠道¶
运行引导流程、安装 Gateway 服务，并打开仪表盘。
通过 Telegram、Discord、Slack、WhatsApp 等渠道给你的智能体发送消息。
托管与部署¶
将 OpenClaw 部署到云服务器或 VPS 上。查看 Linux 服务器 了解完整的提供商选择器（DigitalOcean、Hetzner、Hostinger、Fly.io、GCP、Azure、Railway、Northflank、Oracle Cloud、Raspberry Pi 等），或者在 Render 上声明式部署，或尝试实验性的 Cloudflare Containers 模板。
实验性的 Worker + 容器部署。
共享的 Docker 步骤。
K8s 部署。
隔离的本地或托管 macOS 部署。
具有 SSH 隧道访问权限的托管 Linux 主机。
选择提供商。
备份、更新、迁移或卸载¶
创建、验证和恢复状态存档。
让 OpenClaw 保持最新状态。
迁移到新机器。
彻底移除 OpenClaw。
故障排查：openclaw 未找到¶
几乎总是 PATH 的问题：npm 的全局 bin 目录不在你的 shell 的 PATH 中。完整修复方法（包括 Windows 路径）请参阅 Node.js 故障排查。
本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw