node.js安装失败主因是版本不足（需≥v22）、路径含中文/空格或安全软件拦截；须从官网下载v22 lts安装包、设纯英文路径、关闭防护软件并配置npm镜像源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
安装失败不是你操作错了，而是环境没准备好——90% 的失败都卡在 Node.js 版本、路径非法或安全软件拦截这三处。
检查 node --version 是否 ≥ v22
OpenClaw 系列（包括 AionClaw）强制要求 Node.js v22.x 或更高版本，低于 v18 会直接退出，v20 可能中途报错但不提示原因。
- 打开命令提示符或终端，执行
node --version，确认输出类似v22.14.2 - 如果显示
v18.20.4或更低，或提示“不是内部或外部命令”，必须卸载旧版，从 nodejs.org 下载 v22 LTS 安装包（Windows 推荐 .msi，勾选 “Add to PATH”） - 重装后重启终端再验证，别信“刚装完就生效”的直觉——PATH 缓存可能未刷新
确保安装路径是纯英文且无空格
AionClaw 启动时会加载大量本地模块和 gateway 子进程，路径含中文、空格或 ￥& 会导致文件读取失败，现象是双击启动图标后无任何窗口、任务管理器里也看不到 node.exe 进程。
- 解压或安装目录必须形如：
D:\AionClaw、E:\ai\claw、/Users/xxx/aionclaw - 绝对禁止：
D:\软件\AionClaw、C:\My Tools\AionClaw、D:\AionClaw v2.1 - 不要放在桌面或“下载”文件夹——这些路径在 Windows 下常含用户中文名，macOS 下也可能触发 SIP 限制
关掉所有安全软件再运行安装程序
AionClaw 的 gateway 进程需要监听本地端口（默认 18789）、注入浏览器、模拟键鼠，火绒、360、腾讯电脑管家甚至 Windows Defender 实时防护都会把它当成“可疑行为”静默拦截，导致安装卡在最后一步或启动后白屏。
- 临时关闭 Windows Defender：设置 → 隐私和安全性 → Windows 安全中心 → 病毒和威胁防护 → 管理设置 → 关掉“实时保护”
- 火绒/360/腾讯管家：右键任务栏图标 → “退出”或“暂停防护”，不是仅关闭弹窗
- 安装完成、首次启动成功后再开启防护，否则 gateway 服务无法注册为后台进程
npm install 卡住或报错 404/ETIMEDOUT
安装脚本内部会调用 npm install 拉依赖，国内直连 npm 官方源极不稳定，常见错误包括 ERR! network timeout、404 Not Found 或证书校验失败。
- 提前执行：
npm config set registry https://registry.npmmirror.com - 再执行：
npm cache clean --force - 如果已失败，删掉安装目录下的
node_modules和package-lock.json再重试 - 不建议手动运行
npm install -g aionclaw—— AionClaw 一键安装包走的是私有部署流程，全局安装会冲突
真正容易被忽略的是：gateway 服务启动失败不会弹明确报错，只会让整个界面打不开。确认安装路径合法、Node.js 版本达标、安全软件已退、npm 源已切之后，仍无反应，就去 gateway/ 目录下看有没有 logs/ 子文件夹，里面 error.log 的第一行通常就是真实病因。
