Hermes Agent v0.18.2安装时Node.js冲突需升级至≥20.10：先用node --version检查版本，若低于20.10则通过nvm install 20.10 && nvm use 20.10切换；再cd ~/.hermes/gateway后rm -rf node_modules package-lock.json，最后npm ci重装依赖。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
装Hermes Agent v0.18.2时遇到Node.js冲突，通常表现为启动失败、gateway模块报错或安装卡在“Installing Node.js dependencies (browser tools)”阶段，根本原因是新版本强制要求Node.js ≥20.10，而系统中残留的18.x或更低版本会触发AbortError、crypto.randomUUID未定义等运行时异常。
确认并切换Node.js版本
第一步：检查当前Node.js版本，执行命令：node --version。如果输出为v18.19.1、v16.20.2等低于20.10的版本，必须升级。
第二步：使用nvm统一管理版本（避免多版本共存干扰）。执行以下命令安装并启用v20.10：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash → 重启终端 → nvm install 20.10 → nvm use 20.10。
第三步：验证生效，再次运行node --version，确保返回v20.10.x。这一步不可跳过，否则后续所有依赖重装都会在错误版本下执行，白费时间。
清理网关模块残留依赖
Node.js版本升级后，旧版构建产物仍可能被缓存调用，导致gateway子系统初始化失败。必须彻底清除旧依赖：
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
进入Hermes Agent网关目录：cd ~/.hermes/gateway。
删除整个node_modules和package-lock.json：rm -rf node_modules package-lock.json。【不删干净会导致npm ci仍加载旧版polyfill】
执行npm ci重新安装——注意必须用ci而非install，它严格按lock文件还原，避免引入不兼容的间接依赖。
验证Node.js环境是否真正隔离
方法一：直接运行网关测试脚本
在~/.hermes/gateway目录下执行：node --experimental-json-modules src/index.js --help。若输出帮助信息，说明Node.js环境已就绪；若报错Cannot find module 'node:fs'，说明仍混用了低版本runtime。
方法二：检查进程实际使用的Node路径
启动Hermes后，执行ps aux | grep node，找到gateway进程PID，再运行readlink -f /proc/<pid>/exe</pid>。返回路径必须指向nvm管理的v20.10二进制文件，例如/home/xxx/.nvm/versions/node/v20.10.0/bin/node。
