必须彻底卸载系统级node.js并清理残留路径，再安装nvm管理多版本；通过nvm install/use切换至项目所需版本（如v14.21.3），配合.nvmrc实现自动绑定，国内用户需配置镜像源避免超时。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在Codex项目里执行npm install或yarn start时突然报错“Unsupported engine”，或者VS Code终端里node -v显示的版本和项目require的Node.js版本不一致，说明你正被Node.js版本冲突卡住——这通常是因为系统全局安装了高版本Node，而老项目只兼容v14或v16。
彻底卸载系统级Node.js（Windows/macOS/Linux通用）
不清理干净旧Node，nvm后续所有操作都会失效。nvm无法覆盖系统PATH中已存在的node命令。
Windows：打开控制面板 → 卸载程序 → 找到所有Node.js条目并卸载；再手动删除C:\Program Files\nodejs和C:\Users\{用户名}\AppData\Roaming\npm两个目录。
macOS/Linux：运行which node确认路径后，用sudo rm -rf $(which node)和sudo rm -rf $(which npm)清除二进制文件；再执行rm -rf ~/.npm ~/.nvm。
【必须重启终端或命令行窗口】，否则旧PATH缓存仍在，nvm将无法接管node命令。
安装nvm并验证基础功能
macOS/Linux用户直接运行：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
Windows用户请前往GitHub Releases下载nvm-setup.exe，安装时务必勾选Add to PATH，且安装路径不要含空格或中文（如D:\nvm）。
安装完成后，关闭并重新打开终端，执行nvm --version。若返回类似0.39.7的数字，说明nvm已就位。
若提示'nvm' is not recognized，检查是否遗漏了重启终端，或Windows用户未以管理员身份运行安装程序。
安装并切换到目标低版本Node.js
第一步：查看可安装的稳定旧版本
nvm list available
第二步：从中选择一个兼容Codex项目的版本，例如v14.21.3（Vue 2项目常用）或v16.20.2（部分Next.js 12项目适用），执行：
nvm install 14.21.3
第三步：立即激活该版本
配置 OpenClaw 多提供商认证与 OpenAI Codex OAuth 备用方案，实现自动模型切换，适用于多 OpenAI Codex 账户设置。
nvm use 14.21.3
第四步：验证是否生效
node -v应输出v14.21.3，npm -v也应同步更新为对应版本的npm（如6.14.18）。若仍显示高版本号，说明当前终端未加载nvm环境，需执行source ~/.bashrc（macOS/Linux）或重启CMD/PowerShell（Windows）。
让Codex项目自动绑定Node版本
方法一：在项目根目录创建.nvmrc文件
用任意文本编辑器新建文件，写入一行：14.21.3，保存为.nvmrc（注意开头是点，无扩展名）。
方法二：进入项目目录后手动触发绑定
cd /path/to/your/codex-project → nvm use
nvm会自动读取.nvmrc中的版本号并切换。此后每次进入该目录，只需执行nvm use即可秒切回指定版本，无需记忆具体数字。
注意：VS Code内置终端默认不会自动执行nvm use，需在设置中启用“Terminal › Integrated › Automation: Shell Integration”并重启终端，否则仍需手动运行一次。
解决国内网络导致的安装失败
执行nvm install 14.21.3时若卡在“Downloading node binary…”或报TLS handshake timeout，说明nvm无法访问nodejs.org官方源。
临时修复：运行以下两条命令配置国内镜像
nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/
之后再执行安装，速度将明显提升，且不再超时。该配置会写入nvm安装目录下的settings.txt（Windows）或~/.nvm/.nvmrc（macOS/Linux），永久生效。
