不需要手动安装 node.js——官方桌面客户端和 docker 部署均已内置 node.js；命令行（cli）或源码部署则必须自行安装 node.js ≥ 22.16.0。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
部署 AionClaw 时是否需要手动安装 Node.js，取决于你选择的安装方式——官方桌面客户端已内置运行时，而命令行或自定义部署路径仍需自行准备 Node.js 环境。
用官网下载的桌面客户端（Windows/macOS）
不需要自己安装 Node.js。AionClaw 桌面版是 Electron 封装的全集成应用，Node.js 运行时已打包进安装包内，双击安装后即可直接启动，无需额外配置环境变量或验证 node -v 输出。
这一步操作起来很简单，直接从 aionclaw.ai 下载对应系统安装包，按向导完成安装，打开即用。
注意：若你后续想通过终端调用 openclaw CLI 命令（如 openclaw gateway start），则仍需本地 Node.js ≥ 22，因为 CLI 是 npm 全局包，和桌面客户端互不干扰。
通过 npm 全局安装 openclaw CLI 或源码部署
必须自己安装 Node.js ≥ 22。AionClaw 的 CLI 工具依赖 Node.js 运行时，且明确要求 v22.x LTS 或更高版本。
第一步：确认当前 Node.js 版本
在终端执行：node -v，输出应为 【v22.16.0 或更高】；若显示 v18.x、v20.x 或 command not found，则必须升级。
第二步：安装 Node.js 22（推荐二进制方式，避免 apt/yum 包管理器版本滞后）
Linux/macOS 执行：curl -fsSL https://nodejs.org/dist/v22.16.0/node-v22.16.0-linux-x64.tar.xz | sudo tar -xJ -C /usr/local
Windows 用户请前往 nodejs.org/zh-cn/download 下载 Windows Installer (.msi)，勾选“Add to PATH”选项安装。
第三步：验证并设为默认
执行 node -v && npm -v，两行均需成功输出；若使用 nvm，请补上 nvm alias default 22，否则新终端会回落到旧版本。
用 Docker 部署 AionClaw
不需要自己安装 Node.js。Docker 镜像中已预装适配版本的 Node.js 和所有依赖，只需确保宿主机已安装 Docker Engine 即可。
拉取并运行镜像：docker run -d --name aionclaw -p 18789:18789 -v $(pwd)/aionclaw-data:/app/data aionclaw/engine:latest
该容器基于 Debian + Node.js 22.16 构建，启动后自动监听 18789 端口，访问 http://localhost:18789 即可进入控制台。
