Ubuntu系统安装OpenClaw详细步骤教程

第一步：彻底卸载旧版 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 即处于就绪状态，可供使用。