REA 安装失败：Node.js 版本不受支持

你看到的情况

运行 npx rea-agents setup 后什么都没装，输出里有 status: needs_human，最后一行要求你安装另一个版本的 Node.js。

报错原文

status: needs_human
plannedActions: []
appliedActions: []
...
remediation: "Install Node.js 22.x (>=22.23.4), 24.x (>=24.22.1), or 26.12.1+ and rerun setup."

{"name": "node", "ok": false, "classification": "missing_dependency", "detail": "22.17.1", "remediation": "Install Node.js 22.x (>=22.23.4), 24.x (>=24.22.1), or 26.12.1+."}

实测：2026-10-27，macOS 15.6.1，REA 6.8.0。这段输出来自本机自带的 Node.js 22.17.1。

原因

你的 Node.js 版本低于 REA 的最低要求。REA 6.8.0 支持 22.x（22.23.4 及以上）、24.x（24.22.1 及以上）或 26.12.1 及以上；23、25 和预发布版本也不支持。

注意：npx rea-agents --version 在旧版本 Node 上照样能输出版本号，所以它能运行并不代表你的 Node 合格。

解决步骤

1. 查看当前版本：

   终端复制

   node -v

2. 安装受支持的版本：从 nodejs.org 下载 24 LTS，或者用你的版本管理工具。比如 nvm：

   终端复制

   nvm install 24
   nvm use 24

3. 打开一个新终端，确认版本已经变了：

   终端复制

   node -v

4. 重新运行 setup：

   终端复制

   npx rea-agents setup

5. 从 Dock 或开始菜单打开的桌面版助手，拿到的 PATH 可能和你的终端不一样，仍会用到旧版 Node。如果 setup 成功了但助手启动不了 REA，完全重启助手；还不行就看官方文档的 Launchers and PATH（英文）。