安装 Homebrew

开始之前，请确认你的 macOS 系统已经成功安装了 Homebrew。作为 Mac 平台最专业、最常用的软件包管理器，Homebrew 是进行后续所有开发工作的重要基础。请打开终端应用程序，直接复制并运行以下官方安装命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装脚本执行完毕后，为确保能在任何终端会话中直接使用 brew 命令，你需要将其路径添加到系统的环境变量中。请按顺序执行以下两条配置命令：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrceval "$(/opt/homebrew/bin/brew shellenv)"

安装 Node.js 与 npm

接下来，我们将利用刚刚配置好的 Homebrew 来安装 Node.js 运行环境及其包管理工具 npm。通过 Homebrew 安装 Node.js 通常会附带对应版本的 npm，但为了确保后续步骤的兼容性，我们可能需要手动管理 npm 的具体版本。

在终端中运行以下安装命令：

brew install node

基础安装完成后，建议你立即检查当前 npm 的版本是否符合要求（例如，某些项目可能需要特定的 npm 版本，如 v24）。如果发现版本不符，可以通过以下指定版本安装命令进行快速升级或切换：

npm install -g npm@24

版本更新操作完成后，请使用验证命令确认 npm 已正确升级到目标版本：

npm --version

当终端输出显示为预期的版本号（例如 `24.x.x`）时，表明你的 Node.js 与 npm 环境已经就绪，完全满足安装 openclaw 的前提条件。此时，便可继续执行 openclaw 的安装流程。