1. 环境准备
1.1 环境说明
硬件：虚拟机 4C8G 系统：Ubuntu 24.04 LTS 网络：有线/WiFi OpenClaw 版本：2026.3.x
1.2 前置条件
- 已安装 Ubuntu 24.04 LTS 且可联网
- 拥有 sudo 权限
- 有 AI 模型账号（如 OpenAI / Qwen 等）
- 备用设备浏览器（用于 OAuth 授权和访问 Dashboard）
2. 安装操作
2.1 更新系统
sudo apt update && sudo apt upgrade -y
2.2 安装基础配置
sudo apt install -y curl git
3. 安装 Node.js
OpenClaw 要求 Node.js ≥ 22。查询当前系统的 NodeJS 版本，如果未安装请先安装。
3.1 查看当前系统是否安装
node --version
若提示找不到命令，可通过以下软件包安装。
3.2 安装 NodeJS
apt install nodejs npm
3.3 查询安装版本
npm --version
node --version
3.4 升级 Node.js
3.4.1 先卸载旧版本（可选，避免冲突）
apt remove --purge nodejs npm
apt autoremove
3.4.2 添加 NodeSource 官方源（以 v24 为例）
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
3.4.3 安装新版 Node.js
apt install -y nodejs
3.4.4 验证升级
node -v
npm -v
4. 配置 npm 全局安装目录
4.1 创建用户级全局目录
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
4.2 添加 PATH 环境变量
>> ~/.bashrc
~/.bashrc