Nova AI脚本运行错误主因是环境问题而非脚本本身：Node.js必须为v22.14.2 LTS，ohpm registry需设为https://repo.openharmony.cn，脚本别名须小写且符合命名规范，NPU场景需专用用户hwhiaiuser执行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Nova AI提示运行脚本错误，通常不是脚本本身写错了，而是底层环境缺失关键依赖、版本错配或权限异常导致脚本根本无法加载或解析——比如Node.js版本不对、ohpm未初始化、用户无权访问NPU设备节点，这些都会让脚本在启动前就报错退出。
验证并锁定基础运行时版本
打开终端（PowerShell或CMD），执行node -v。若输出不是v22.x格式（如v20.18.0或v24.5.0），则直接导致Nova AI脚本解析失败；v24+版本会触发ohpm run内部hook崩溃，v20及以下则缺少ES2023语法支持。
卸载当前Node：Windows用户运行msiexec /x {Node.js GUID} /quiet（从控制面板获取真实GUID），macOS执行brew uninstall node node@24。
安装官方v22.14.2 LTS：Windows前往https://www.php.cn/link/9d5f802718a8d7139caa9addd293483e下载.msi，安装时务必勾选【Add to PATH】；macOS执行brew install node@22。
重启终端后运行node -v && npm -v，确认输出为v22.14.2和npm 9.9.0+。若仍显示旧版本，Windows需手动检查系统环境变量中PATH是否包含C:\Program Files\nodejs\，macOS执行echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc。
修复ohpm registry与脚本别名规范
运行ohpm config get registry。若返回空或https://repo.openharmony.cn以外的地址，说明registry未正确配置，会导致ohpm run找不到脚本入口。
方法一：执行ohpm config set registry https://repo.openharmony.cn强制指定官方源。
方法二：若企业内网需代理，先配置全局代理ohpm config set proxy http://10.1.1.100:8080，再重设registry。
检查oh-package.json5中scripts字段下的脚本别名：首字母必须小写，长度1–128，不能以(、[、{开头，且不能含中文或空格。例如"testAI": "..."非法，应改为"testai": "..."。
OpenClaw 跨平台配置备份与网关监控。自动备份 openclaw.json，每分钟检测 gateway 状态，宕机时自动恢复。支持 Linux/macOS/Windows。触发：配置备份、gateway 监控、自动恢复、看门狗、watchdog。
GPU/NPU直通场景专属用户权限校验
若脚本涉及Atlas 300i Pro等AI加速卡调用（如npu-smi info或模型推理），必须使用驱动要求的专属用户执行——root或普通用户直接运行会因设备节点权限校验失败而报错00611001 Script Fail。
第一步：登录Nova AI所在虚拟机或宿主机，执行groupadd hwhiaiuser创建用户组。
第二步：执行useradd -g hwhiaiuser hwhiaiuser创建用户，并设置密码passwd hwhiaiuser。
第三步：切换用户su - hwhiaiuser，验证身份id输出含hwhiaiuser组ID。
第四步：在hwhiaiuser环境下重新执行脚本，例如ohpm run testai。这一步不可跳过——【使用root临时执行脚本不会绕过权限校验，只会让错误日志更难定位】。
跳过环境配置的一键部署验证
Windows 11用户可直接使用Nova AI官方一键包验证是否为环境问题：访问https://openclaw.ikidi.top/api/download/package/14?下载NovaAI-Win11-Deploy-v22.14.2.zip，解压后双击launch.bat。
该包内置Node v22.14.2、Git、ohpm及适配层，自动处理Defender误报、中文路径、权限提升等问题。若一键包能正常运行脚本，则100%确认是本地环境配置偏差。
运行成功后，对比一键包内node_modules/.bin路径与你本地项目的差异，重点检查@ohos/hvigor和@ohos/ohpm版本号是否一致。
