第一步:彻底卸载旧版 Node.js
为确保安装过程顺利,避免版本冲突,我们首先需要完全移除系统中可能存在的旧版本 Node.js 及其关联组件。
请打开终端,依次执行以下命令:
apt remove --purge -y nodejs libnode-dev npm
该命令将彻底卸载 Node.js 核心程序、开发库及包管理器。随后,清理因卸载而产生的冗余依赖包:
apt autoremove -y
最后,可选择性清理本地软件包缓存以释放磁盘空间:
apt autoclean
第二步:安装新版 Node.js 22
完成清理后,即可安装最新的 Node.js 22 LTS 版本。我们推荐通过 NodeSource 官方仓库获取,以确保获得稳定且及时的安全更新。
运行以下命令添加 Node.js 22 的官方软件源:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
仓库添加成功后,执行安装命令:
sudo apt-get install -y nodejs
此命令将自动安装 Node.js 22 及其内置的 npm 包管理工具。
第三步:验证 Node.js 22 安装结果
安装完成后,需要确认 Node.js 版本是否已成功升级至 22 或更高。
在终端中输入版本查询命令:
node -v
若终端显示类似 v22.x.x 的版本信息,则表明 Node.js 22 已正确安装并配置完成。
第四步:通过 npm 安装 OpenClaw
基础运行环境就绪后,即可安装 OpenClaw 应用。我们使用 npm 进行全局安装,以获取最新稳定版本。
执行全局安装命令:
npm install -g openclaw@latest
参数 -g 表示全局安装,安装后可在系统任意路径下直接调用 openclaw 命令。
第五步:完成 OpenClaw 初始化配置
安装后首次使用前,必须进行初始化设置。此步骤将引导您配置核心参数,如选择 AI 模型、设置 API 密钥、绑定消息频道等。
若需 OpenClaw 以守护进程模式在后台持续运行(适用于自动化任务或长期服务),请在初始化命令中加入 --install-daemon 参数。
完整的初始化命令如下:
openclaw onboard --install-daemon
请根据终端中的交互提示逐步完成配置。完成后,OpenClaw 即处于就绪状态,可供使用。
