跳转至

安装程序内部

OpenClaw 提供三个安装脚本,托管于 openclaw.ai。

源代码检出中的 shell 入口点共享 scripts/install-policy.sh。在复制、管道传递或发布之前,运行 node scripts/build-installers.mjs 可在 dist/installers/ 中组装独立副本。网站同步和原生构建使用这些组装好的脚本。为了与已安装的更新程序兼容,npm 包将两个源文件保存在一起。通过网站安装时,绝不会下载单独的策略辅助程序。

脚本 平台 功能说明
install.sh macOS / Linux / WSL 按需安装 Node,通过 npm(默认)或 git 安装 OpenClaw,可运行入门引导。
install-cli.sh macOS / Linux / WSL / FreeBSD 通过 npm(FreeBSD)或 npm/git(macOS/Linux/WSL)将 Node + OpenClaw 安装到本地前缀(~/.openclaw)。无需 root。
install.ps1 Windows(PowerShell) 按需安装 Node,通过 npm(默认)或 git 安装 OpenClaw,可运行入门引导。

三者均支持 Node 24.16+ 或 26.1+,并带有 WAL 重置安全的链接 SQLite 库。当缺少 Node 且未检测到 nvm 时,install.sh 会在 macOS 上通过 Homebrew 提供 Node 26,在 Linux 上通过 NodeSource 提供受支持的 Node 24 LTS 系列。当受支持的、由 RPM 管理的 Node 链接了不安全的 SQLite 时,install.sh 会保留发行版软件包,并通过 install-cli.sh 提供用户空间的 Node 运行时。无需 root 的 install-cli.sh 会在 macOS 和 glibc Linux 上下载 Node 24.21.0。FreeBSD 使用已安装的系统运行时。不支持 Linux ARMv7。在 Windows 上,winget/Chocolatey/Scoop 会安装受支持的 Node LTS 系列,便携式回退方案则会下载 Node 26。

在更改软件包之前,每个安装程序都会检查它将要使用的确切 npm 可执行文件。npm 11.15 及更早版本正常安装;npm 11.16 及更高版本(包括 npm 12)接收 --allow-scripts,且仅作用于 npm 解析出的 OpenClaw 候选身份。无法读取的 npm 版本会在软件包变更之前停止。残留的 .openclaw-lifecycle-pending 标记或旧版 dist/openclaw-install-guard 会使安装失败,而不是将跳过生命周期检查的软件包报告为成功。

在 npm 12 上,本地 .tgz 和 .tar.gz 的安装和更新需要不含逗号的归档文件名和父路径。npm 使用逗号分隔生命周期审批项,因此请在重试之前将归档移动到不含逗号的路径。仍然支持相对的 tarball 参数;安装程序会解析其完整路径以供审批。

安装方式的切换会在淘汰当前所有者之前验证替代品。源代码包装器使用同一目录下的原子替换;当 npm shim 与该路径共享时,安装程序只会将身份匹配的源代码包装器移到一边,并在 npm 安装、生命周期检查或候选验证失败时将其恢复。升级时,install.sh 和 install.ps1 会运行 openclaw doctor --fix;修复或最终验证失败会以非零状态退出,并且只有在这些步骤完成后才会显示成功横幅。

私有 Node 恢复

当当前活动的 Node.js 不受支持时,CLI 可以在加载 OpenClaw 之前提供 Update NodeJS: Y/N [N]: 提示。输入 Y 可安装经校验和验证的私有运行时,并重试同一命令。资源调配不会改动系统 Node.js、shell 设置、OpenClaw 软件包和 Gateway 服务;重试的命令保持其正常行为。输入 N、按 Enter 或取消,即可获得手动升级说明。

该安装提示要求 stdin 和 stderr 均为交互式终端。在 CI 环境或使用 --json、--yes、--non-interactive 时,CLI 绝不会提示或安装运行时。恢复功能支持 x64/ARM64 macOS、Windows 和 glibc Linux;Alpine/musl 及其他架构需要手动安装。具有严格进程身份要求的命令(包括 hooks relay 和 webhooks gmail run)会保持其现有的运行时要求。

CLI 将私有运行时存储在 ~/.openclaw/tools/cli-node 下;当设置了 OPENCLAW_HOME 时,使用它替代主目录。之后需要受支持运行时的启动(包括非交互式启动)会复用该位置中的兼容运行时,而不会再次出现安装提示。受支持的活动 Node.js 优先。下文中的仅 Node 安装程序示例会显式填充此位置;如果使用 OPENCLAW_HOME,请调整其中的主路径。手动安装指导请参阅 Node.js。

不受支持的 Node 上的诊断

启动器首先复用兼容的私有运行时,包括用于诊断。如果没有此类运行时,诊断则需要 Node 22 或更高版本,并具备可用的 node:sqlite。较旧的运行时在加载任何诊断代码之前,仍会显示交互式恢复提示或非交互式拒绝提示。

在具备相应能力但不受支持的运行时上,openclaw --version(-V 或 -v)、--help(-h)、gateway status、doctor --lint、update status 以及 triage --json 或 triage --non-interactive 仍然可用。普通的 doctor 会在不受支持的 Node 上运行只读的 lint 检查。修复标志、Gateway 启动和 triage 代理执行仍然需要受支持的运行时。openclaw update 可以在允许更新或写入其运行台账之前,报告确切的 Node 安装说明。

这些命令会打印 Running on an unsupported Node (<version>); diagnostics may show truncated text。发现结果仍然可见,包括 CLI 和已记录的服务的 Node 版本及其修复说明。update status --json 在存在时会包含 runtimeFindings;更新失败的问题报告会记录报告进程的 Node 版本。仅靠一次成功的 npm 安装并不能确定运行时兼容性:npm 可能会跳过预安装检查。

诊断读取器保留正在使用的 SQLite 文件。它们可以恢复一次性私有副本,因此崩溃后已提交的状态仍然可读;运行时豁免不允许对活动数据库进行可写访问。

源代码构建工具链

在 FreeBSD 上,使用 install-cli.sh 中描述的 npm 方法。 目前不支持通过源码/git 方式安装。

对于源码安装,安装程序在选择 checkout ref 后选择 pnpm。 它使用 Corepack 在安装程序拥有的临时目录中创建 pnpm shim,然后从该检出目录运行这些 shim,使 Corepack 读取目标目录的 package-manager 固定版本。 同一目录会位于嵌套安装和构建命令的 PATH 最前面;工作区和 lockfile 的环境变量覆盖仅绑定到目标检出目录,且仅对子命令生效。 环境中较旧的 pnpm --version 不是一项安全的选择检查:其版本切换路径可能修改目标 lockfile。

如果缺少 Corepack 或无法提供固定版本,安装程序会使用所选 npm 可执行文件将该确切 pnpm 版本安装到临时前缀中,并保留 npm 对特定版本的生命周期批准。 它们直接使用该前缀中的可执行文件,包括用于嵌套命令。 此引导过程既不会激活全局 Corepack shim,也不会更改用户 pnpm 配置;临时 shim 和包会在安装程序退出后清理干净。

这不会安装或替换 shell 的全局 pnpm 命令。在之后手动构建前,请按照从源码构建选择该检出目录固定的工具链,而不要复用环境中较旧的启动器。

快速命令

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --help
iwr -useb https://openclaw.ai/install.ps1 | iex
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta -NoOnboard -DryRun

Note

如果安装成功但在新终端中找不到 openclaw,请参阅 Node.js 故障排查。


install.sh

Tip

推荐用于 macOS/Linux/WSL 上的大多数交互式安装。

流程 (install.sh)

安装程序的网络操作允许连接或停滞传输的等待时间为五分钟。由安装程序管理的下载在数据持续到达时可能花费更长时间;它们没有固定的总下载截止时间。注册表元数据检查也默认为五分钟。

1. 检测操作系统

支持 macOS 和 Linux(包括 WSL)。

2. 确保受支持的 Node.js 运行时

检查 Node 版本和链接的 SQLite 库,然后在需要时安装 Node(macOS 上通过 Homebrew node 安装 Node 26;Linux apt/dnf/yum 上通过 NodeSource 安装脚本安装 Node 24 LTS)。在基于 RPM 的 Linux 上,链接不安全 SQLite 的受支持发行版 Node 仍会保留,而 OpenClaw 会获得一个用户态 Node 运行时。在 macOS 上,只有安装程序因 Node 或 Git 需要时才会安装 Homebrew。 支持 Node 24.16+ 和 Node 26.1+;不支持 Node 22、23 和 25。 在 Alpine/musl Linux 上,安装程序使用 apk 包而不是 NodeSource,并验证实际链接的 SQLite 版本。当前稳定的 Alpine 包流可能会提供版本足够新但带有易受攻击的系统 SQLite 的 Node;如果遇到这种情况,请改用官方的 node:26-alpine 容器或基于 glibc 的主机。

3. 确保 Git

如果缺少 Git,则使用检测到的包管理器安装 Git,包括 macOS 上的 Homebrew 和 Alpine 上的 apk。

4. 安装 OpenClaw

  • npm 方法(默认):全局 npm 安装
  • git 方法:克隆/更新仓库,使用 pnpm 安装依赖,构建,然后将包装器安装到 ~/.local/bin/openclaw

5. 安装后任务

  • 解析刚刚安装的 openclaw 二进制文件以供后续命令使用
  • npm-prefix 和守护进程状态检查使用默认的五秒超时;已完成的检查返回时不会等待该超时时间。
  • 对于未配置的安装,会在 doctor 或 gateway 检查之前启动引导流程。使用 --no-onboard 或没有 TTY 时,它会打印稍后完成设置的命令。
  • 对于已配置的安装,尽力刷新并重启已加载的 gateway 服务,然后运行修复 Doctor。升级修复失败会导致致命错误;插件更新失败仅作为警告。
  • 当运行 --verify 时,它会检查已安装的版本,并且仅在存在配置后才检查 gateway 健康状态。

现有的 nvm 安装

install.sh 会保留当前激活的兼容 Node,包括 nvm use system 所选择的 Node。 如果当前激活的运行时不受支持,它会首先检查已安装的 nvm 版本,然后检查其他可用的 Node 二进制文件,包括 Homebrew。每个候选都必须通过版本和 SQLite 能力两项检查。选择现有的 nvm 版本只会更改安装程序会话;脚本会为后续命令打印 nvm use <version>,并保持默认别名和 shell 配置文件不变。

安装程序通过 NVM_DIR、~/.nvm 和 shell 启动钩子检测 nvm。它以 --no-use 方式加载 nvm.sh,而不会激活默认版本。启动文件永远不会被用于发现而执行。如果自定义或延迟钩子是唯一可用的位置,请在重新运行安装程序之前,先在 shell 中加载 nvm。

当存在 nvm 但没有兼容的运行时可用时,安装程序会提供在该现有安装中运行 nvm install 26 的选择。由于 nvm 会刷新 LTS 别名,如果刷新会改变当前默认版本的解析,提示也会询问是否通过固定其别名来保留当前默认版本。即使下载失败,该同意也适用。当不存在默认版本时,提示会明确包含 nvm 创建默认版本这一操作。安装程序会记录任何被批准的别名更改以及最终的默认版本。拒绝或在非交互模式下运行会以非零状态退出,并显示需要运行的确切命令,同时不会部署 Node,也不会更改 nvm、npm 配置或 shell 配置文件。安装程序绝不会安装第二个 nvm。

在 Linux 上,不可写的系统 npm 前缀也会通过现有的 nvm 安装进行路由。安装程序会复用兼容的 nvm Node,或请求安装一个;它不会写入会破坏后续 nvm use 命令的 npm prefix 设置。如果没有 nvm,现有的用户本地 npm 前缀设置仍然适用。

源代码检出检测

如果在 OpenClaw 检出目录中运行(package.json + pnpm-workspace.yaml),脚本会提供:

  • 使用检出(git),或
  • 使用全局安装(npm)

如果没有可用的 TTY,且未设置安装方法,则默认使用 npm 并发出警告。

对于无效的方法选择或无效的 --install-method 值,脚本以退出码 2 退出。

使用 --install-method git 时,install.sh 和 install-cli.sh 通过 --version 接受完整的 40 字符提交 SHA。安装程序会使用现有对象,或从 origin 获取该确切提交,以分离头指针方式检出,并使用冻结的 lockfile 安装依赖项。同名分支无法替换所请求的提交。--no-git-update 会跳过分支变基;它不会阻止获取缺失的所请求提交。如果所请求的对象不可用或无法解析为提交,安装将失败。

示例(install.sh)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard --verify
标志参考
标志 描述
--install-method \| --method npm\|git 选择安装方法(默认:npm)
--npm npm 方法的快捷方式
--git \| --github git 方法的快捷方式
--version <version\|dist-tag\|spec> npm 版本、dist-tag 或包规范(默认:latest)
--beta 如果可用则使用 beta dist-tag,否则回退到 latest
--git-dir \| --dir <path> 检出目录(默认:~/openclaw)
--no-git-update 对现有检出跳过 git pull
--no-prompt 禁用提示
--no-onboard 跳过入门
--onboard 启用入门
--verify 运行安装后冒烟验证(--version,如果已加载则检查 gateway 健康状态)
--dry-run 打印操作而不应用更改
--verbose 启用调试输出(set -x,npm notice 级别日志)
--help \| -h 显示用法
环境变量参考
变量 描述
OPENCLAW_INSTALL_METHOD=git\|npm 安装方法
OPENCLAW_VERSION=latest\|next\|<semver>\|<spec> npm 版本、dist-tag 或包规范
OPENCLAW_BETA=0\|1 如果可用则使用 beta
OPENCLAW_HOME=<path> OpenClaw 状态以及默认 git/入门路径的基础目录
OPENCLAW_GIT_DIR=<path> 检出目录
OPENCLAW_GIT_UPDATE=0\|1 切换 git 更新
OPENCLAW_NO_PROMPT=1 禁用提示
OPENCLAW_VERIFY_INSTALL=1 运行安装后冒烟验证
OPENCLAW_NO_ONBOARD=1 跳过入门
OPENCLAW_DRY_RUN=1 试运行模式
OPENCLAW_VERBOSE=1 调试模式
OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice npm 日志级别(默认:error,隐藏 npm 弃用噪音)

install-cli.sh

Info

专为希望将所有内容置于本地前缀下的环境设计(默认 ~/.openclaw)。默认支持 npm 安装,此外在 macOS/Linux/WSL 上支持 git 检出安装。FreeBSD 使用 npm 方法。FreeBSD 和 Alpine 使用系统 Node 包。

流程(install-cli.sh)

1. 安装本地 Node 运行时

下载固定版本的支持的 Node LTS tarball(版本嵌入在脚本中并独立更新,默认 24.21.0)到 <prefix>/tools/node-v<version>,并验证 SHA-256。 Linux ARMv7 会在安装前停止,因为官方不提供 Node 24+ 的 ARMv7 二进制文件。请在兼容硬件上使用 64 位操作系统,或使用其他受支持的主机。 在 Alpine/musl Linux 上,由于 Node 未为固定运行时发布兼容的 tarball,脚本会使用 apk 安装 nodejs 和 npm,然后验证 Node 以及实际链接的 SQLite 库。当前稳定的 Alpine 软件包流即使 Node 版本足够新,仍可能链接存在漏洞的 SQLite;当安全检查拒绝该软件包时,请使用官方 node:26-alpine 容器或基于 glibc 的主机。

2. 确保 Git

如果缺少 Git,会尝试在 Linux 上通过 apt/dnf/yum/apk 安装,或在 macOS 上通过 Homebrew 安装。 在 FreeBSD 上,请先使用 pkg install git 安装 Git,然后再重试。

3. 在 prefix 下安装 OpenClaw

  • npm 方法(默认):使用 npm 在 prefix 下安装,然后将包装器写入 <prefix>/bin/openclaw
  • git 方法:克隆/更新一个检出(默认 ~/openclaw),并且仍将包装器写入 <prefix>/bin/openclaw

4. 验证已安装的 CLI

运行 <prefix>/bin/openclaw --version,除非已安装的包装器成功退出并返回非空版本,否则以错误停止。

5. 刷新已加载的 Gateway 服务

如果同一 prefix 下已经加载了 Gateway 服务,脚本会运行 openclaw gateway install --force,以启用替换服务, 然后尽力检查 Gateway 健康状态。

在 FreeBSD 上,请使用默认 npm 方法(--install-method npm)配合已发布 版本或兼容的已构建 .tgz 软件包。不支持源码/git 安装。 如果 OpenClaw 由 pkg 或 Ports 管理,请继续使用该软件包所有者,而不是 在其上安装。

在 FreeBSD 上,运行安装程序之前,请通过 pkg 安装 bash、node24、npm-node24、git、python3 和 gmake。 Python 和 GNU Make 用于支持原生 npm 依赖构建。 如果运行时检查失败,请系统管理员更新这些软件包。 安装程序要求 PATH 中存在受支持的 Node 和 npm 命令,并验证实际的 SQLite 库。 它会将该运行时链接到本地 prefix,而不更改系统软件包。 显式指定 --node-version 会设置 FreeBSD 上接受的最低系统版本。

上游 Codex CLI 不提供 FreeBSD 二进制目标。 安装成功或 openclaw doctor --fix 都不会验证原生 Codex 执行。 对于 OpenAI API 模型,请配置 API-key 身份验证配置。 请为你使用的模型显式选择 agentRuntime.id: "openclaw"。 API-key 访问使用 OpenAI Platform 计费,与 ChatGPT/Codex 订阅相互独立。 参见 OpenAI 设置 和 运行时选择。

使用 --node-only 时,install-cli.sh 会在将 Node 配置到 <prefix>/tools/node-v<version> 并更新 <prefix>/tools/node 别名后停止。它会跳过 Git、OpenClaw 安装、引导设置以及 Gateway 服务工作。此模式拒绝 musl Linux 和 FreeBSD。请手动更新它们的系统 Node 软件包。

使用 --runtime-only 时,脚本会安装 Node 和 CLI,但会跳过 Gateway 服务发现、刷新和引导设置,即使同时提供了 --onboard 也是如此。 npm 路径还会跳过系统 Git 配置。桌面浏览器设置会使用 此选项,并配合 --npm、精确的应用版本以及独立的应用专属 prefix;它不会 替换独立管理的 Gateway 运行时。正常安装会保留 其现有的服务刷新行为。

示例(install-cli.sh)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --node-only --prefix "$HOME/.openclaw/tools/cli-node"
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --install-method git --git-dir ~/openclaw
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboard
标志参考
标志 描述
--prefix <path> 安装 prefix(默认:~/.openclaw)
--install-method \| --method npm\|git 选择安装方法(默认:npm)
--npm npm 方法的快捷方式
--git \| --github git 方法的快捷方式
--git-dir \| --dir <path> Git 检出目录(默认:~/openclaw)
--no-git-update 对现有 git 检出跳过 git pull
--version <ver> OpenClaw 版本或 dist-tag(默认:latest)
--compatible-with <ver> 拒绝无法修改由 <ver> 写入的配置的 CLI
标志 描述
--node-version <ver> Node 版本(默认:24.21.0)
--node-only 仅在 --prefix 下安装私有 Node 运行时;不更改系统包
--runtime-only 安装 Node 和 CLI,但不执行 Gateway 检查、服务刷新或引导设置
--json 输出 NDJSON 事件
--onboard 安装后运行 openclaw onboard
--no-onboard 跳过引导设置(默认)
--set-npm-prefix 在 Linux 上,如果当前前缀不可写,则强制 npm 前缀为 ~/.npm-global
--help \| -h 显示用法
环境变量参考
变量 描述
OPENCLAW_PREFIX=<path> 安装前缀
OPENCLAW_INSTALL_METHOD=git\|npm 安装方法
OPENCLAW_VERSION=<ver> OpenClaw 版本或 dist-tag
OPENCLAW_NODE_VERSION=<ver> Node 版本
OPENCLAW_HOME=<path> OpenClaw 状态以及默认 git/引导设置路径的基础目录
OPENCLAW_GIT_DIR=<path> git 安装的 Git 检出目录
OPENCLAW_GIT_UPDATE=0\|1 切换现有检出的 git 更新
OPENCLAW_NO_ONBOARD=1 跳过引导设置
OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice npm 日志级别(默认:error)

Note

openclaw@main 和其他 GitHub 源规范不是 npm 安装的有效 --version 目标。在 macOS/Linux/WSL 上,请改用 --install-method git --version main。FreeBSD 需要已发布的 npm 版本或兼容的构建包。


install.ps1

流程(install.ps1)

1. 确保 PowerShell + Windows 环境

需要 PowerShell 5+。

2. 确保受支持的 Node.js 运行时

如果缺失,则尝试通过 winget、然后 Chocolatey、然后 Scoop 安装。如果这些方法不可用、失败,或留下不受支持的运行时,脚本会将官方 Node.js 26 Windows zip 下载到 %LOCALAPPDATA%\OpenClaw\deps\portable-node,并将其添加到当前进程和用户 PATH。支持 Node 24.16+ 和 Node 26.1+;不支持 Node 22、23 和 25。

3. 安装 OpenClaw

  • npm 方法(默认):使用所选 -Tag 进行全局 npm 安装,从可写的安装程序临时目录启动,以便在受保护文件夹(如 C:\)中打开的 shell 仍然可用
  • git 方法:克隆/更新仓库,使用 pnpm 安装/构建,并在 %USERPROFILE%\.local\bin\openclaw.cmd 安装包装器。如果缺少 Git,脚本会在 %LOCALAPPDATA%\OpenClaw\deps\portable-git 下引导用户本地 MinGit,并将其添加到当前进程和用户 PATH。

4. 安装后任务

  • 在可能时将所需 bin 目录添加到用户 PATH
  • 尽力刷新已加载的 Gateway 服务(openclaw gateway install --force,然后重启)
  • 在升级和 git 安装时运行 openclaw doctor --fix --non-interactive;失败会阻止升级成功结果

5. 处理失败

iwr ... | iex 和脚本块安装会报告终止错误,而不会关闭当前 PowerShell 会话。直接 powershell -File / pwsh -File 安装仍会以非零退出码退出,以便自动化。

使用 -NodeOnly 时,install.ps1 会下载官方 Node 存档,验证其 SHA-256 校验和以及运行时兼容性,然后将 Node 及其匹配的 npm/npx 安装到 -NodePrefix。前缀必须是绝对私有目录,而不是文件系统根目录。此模式会跳过包管理器、OpenClaw 安装、引导设置和 Gateway 服务工作,并保持进程、用户和机器 PATH 不变。-NodePrefix 需要 -NodeOnly;-DryRun 会预览目标位置而不安装。

Note

完整的原生 Windows 启动器 → PowerShell → 下载的 Node 交接流程在原生 Windows 上仍未得到验证。PowerShell 安装程序测试夹具覆盖校验和失败和安装隔离,但并未证明该完整恢复流程。

示例(install.ps1)

iwr -useb https://openclaw.ai/install.ps1 | iex
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NodeOnly -NodePrefix "$HOME\.openclaw\tools\cli-node\tools\node"
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -Tag main
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw"
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -DryRun
标志参考
标志 描述
-InstallMethod npm\|git 安装方式(默认:npm)
-Tag <tag\|version\|spec> npm dist-tag、版本或包规范(默认:latest)
-GitDir <path> 检出目录(默认:%USERPROFILE%\openclaw)
-NoOnboard 跳过引导
-NoGitUpdate 跳过 git pull
-DryRun 仅打印操作
-NodeOnly 仅安装私有 Node 运行时;保持 PATH 不变
-NodePrefix <path> -NodeOnly 所需的绝对私有目录
-Help 显示已下载 scriptblock 调用的用法
环境变量参考
变量 描述
OPENCLAW_INSTALL_METHOD=git\|npm 安装方式
OPENCLAW_GIT_DIR=<path> 检出目录
OPENCLAW_NO_ONBOARD=1 跳过引导
OPENCLAW_GIT_UPDATE=0 禁用 git pull
OPENCLAW_DRY_RUN=1 试运行模式

Note

按名称传递安装程序选项。未知选项和位置参数会在下载、PATH 更改或安装开始之前被拒绝。对于已保存的 install.ps1 文件,请使用 -?;对于已下载的 scriptblock 形式,请使用 -Help。

Note

如果使用 -InstallMethod git 且缺少 Git,脚本会先尝试用户本地的 MinGit 引导,然后再打印 Git for Windows 链接。


CI 与自动化

使用非交互式标志/环境变量,以获得可预测的运行结果。

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard
OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \
  curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

故障排除

为什么需要 Git?

git 安装方式需要 Git。对于 npm 安装,仍会检查/安装 Git,以避免依赖使用 git URL 时出现 spawn git ENOENT 失败。

为什么 npm 在 Linux 上遇到 EACCES?

某些 Linux 配置会将 npm 的全局前缀指向 root 拥有的路径。install.sh 可以将前缀切换到 ~/.npm-global,并在 shell rc 文件中追加 PATH 导出(如果这些文件存在)。

Windows:'npm error spawn git / ENOENT'

重新运行安装程序,以便引导用户本地的 MinGit,或者安装 Git for Windows 并重新打开 PowerShell。

Windows:'openclaw is not recognized'

运行 npm config get prefix,并将该目录添加到用户 PATH(在 Windows 上无需 \bin 后缀),然后重新打开 PowerShell。

Windows:如何获取安装程序的详细输出

install.ps1 使用 CmdletBinding,因此接受 PowerShell 的通用 -Verbose 参数。安装程序目前不会写入专用的详细输出流。要进行脚本级诊断,请使用 PowerShell 跟踪:

Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0
安装后找不到 openclaw

通常是 PATH 问题。参见 Node.js 故障排除。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw