Installer Internals

OpenClaw 有三个小帮手脚本，它们住在 openclaw.ai 这个网站上。你可以把它们想象成三个不同的小机器人，专门帮你安装 OpenClaw。

第一个小帮手叫 install.sh，它适合大多数在苹果电脑（macOS）或普通电脑（Linux/WSL）上想安装 OpenClaw 的小朋友。它会做下面几件事：

1. 看看你的电脑是什么系统。如果是苹果电脑，它会检查并安装一个叫 Homebrew 的“软件商店”。
2. 检查 Node.js。Node.js 是 OpenClaw 需要的一个“引擎”。如果版本太旧或者没有，它会帮你安装一个合适的版本（22 或更高）。
3. 检查 Git。Git 是一个管理代码的工具，就像乐高说明书。如果没有，它会帮你装上。
4. 安装 OpenClaw。有两种方法：默认是用 npm（一个软件包管理器）直接安装；也可以用 git 方法，就是先把 OpenClaw 的代码“搬”到你的电脑上，再安装。
5. 安装后的小任务。比如，它会试着运行 openclaw doctor 检查一下，如果条件合适，还会带你做一次“新手引导”。

要使用它，你只需要在电脑的“终端”里输入一行命令，比如： curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash 这行命令就像用一根吸管（curl）从网上把脚本“喝”下来，然后立刻交给 bash 这个“小厨师”去执行。

这里要小心：如果你在安装后，新开的“终端”里输入 openclaw 却找不到，可能是路径（PATH）问题，需要去查查“Node.js 故障排除”那页。

第二个小帮手叫 install-cli.sh，它也用在苹果电脑和普通电脑上。它的特别之处是，会把所有东西（包括 Node.js 和 OpenClaw）都装在你自己的一个小文件夹里（默认是 ~/.openclaw），不会动电脑里其他地方的东西。这很适合不想影响系统其他部分的情况。它的步骤是：

1. 在你自己的文件夹里安装一个 Node.js。
2. 检查并安装 Git。
3. 在你的文件夹里安装 OpenClaw。

第三个小帮手叫 install.ps1，是专门给 Windows 电脑用的。它需要在 PowerShell（Windows 的命令窗口）里运行。步骤和第一个小帮手很像：

1. 检查 PowerShell 版本和 Windows 环境。
2. 检查并安装 Node.js 22 或更高版本（会尝试用 winget、Chocolatey、Scoop 这些“软件商店”来装）。
3. 用 npm 或 git 方法安装 OpenClaw。
4. 安装后，会试着把 OpenClaw 所在的目录加到你的“路径”（PATH）里，这样你就能在任何地方找到它了。

在 Windows 上，你可以用这行命令来安装： iwr -useb https://openclaw.ai/install.ps1 | iex

要记住的事情：

• 如果你想跳过新手引导，可以在命令后面加上 --no-onboard（对于 install.sh 和 install-cli.sh）或 -NoOnboard（对于 install.ps1）。
• 如果你想先看看小帮手会做什么而不真的安装，可以加上 --dry-run 或 -DryRun 参数。
• 在 Windows 上，如果选择 git 方法但电脑里没有 Git，脚本会停止并告诉你去下载“Git for Windows”。
• 脚本默认会设置 SHARP_IGNORE_GLOBAL_LIBVIPS=1，这是为了避免一个叫 sharp 的零件和系统里的另一个零件冲突。如果你遇到图片相关的问题，可以尝试把这个设置改成 0。

如果你在用自动化的工具（比如在服务器上安装），记得使用 --no-prompt 这类不交互的参数，或者设置像 OPENCLAW_NO_ONBOARD=1 这样的环境变量，这样安装过程就不会停下来问问题。