3.2 安装器内部

OpenClaw 提供了三个来自 openclaw.ai 的安装器脚本，本文详细介绍它们的内部工作原理。

概述

OpenClaw 提供三个安装器脚本：

1. install.sh - 主安装器（默认全局 npm；支持 GitHub 检出）
2. install-cli.sh - 非 root CLI 安装器（安装到指定前缀目录，使用专用 Node）
3. install.ps1 - Windows PowerShell 安装器（默认 npm；可选 git 安装）

install.sh（推荐）

核心功能：

• 检测操作系统（macOS、Linux、WSL）
• 要求 Node.js 22+
• 提供两种安装方式：
  • npm（默认）：npm install -g openclaw@latest
  • git：克隆/构建源码并创建包装脚本
• Linux：通过将前缀重定向到 ~/.npm-global 来防止 npm 权限问题
• 安装后通过 openclaw doctor --non-interactive 运行诊断检查

特殊处理：

安装器通过默认设置环境变量来忽略系统 libvips，从而"缓解原生安装的复杂性"，除非你特别需要它。

Git 安装检测：

当在 OpenClaw 源码目录内运行时，脚本会提供更新该检出版本或迁移到全局 npm 的选项。非交互式环境需要 --install-method git|npm 标志或环境变量。

install-cli.sh

将 OpenClaw 安装到用户指定的前缀目录（通常是 ~/.openclaw），同时安装专用的 Node 运行时。这对于不希望修改系统 Node 的系统非常有用。

install.ps1（Windows）

关键步骤：

• 确保 Node.js 22+ 可用
• 提供 npm 或 git 安装路径选择
• 在更新和 git 安装时运行诊断

常见故障排除：

缺少 Git 需要从 git-scm.com 下载；PATH 问题通常涉及 %AppData%\npm 目录位置。