OpenClaw Linux 系统安装

本文为个人实操记录，详细讲解 OpenClaw 在 Linux 系统下的安装、配置全流程，包含 Swap 分区创建、Node.js 环境部署、软件安装与初始化配置。

适用环境

- 系统：Linux 全发行版（Ubuntu/Debian/CentOS 等）
- 内存建议：≥2GB（2GB 内存必须创建 Swap 分区）
- 权限：需要 root/sudo 管理员权限

步骤 1：创建 Swap 空间（可选）

如果你的服务器内存为 2GB，建议创建 4GB Swap 空间避免安装报错，执行以下命令：

bash

# 创建 4GB Swap 文件
sudo fallocate -l 4G /swapfile

# 设置文件权限
sudo chmod 600 /swapfile

# 格式化 Swap
sudo mkswap /swapfile

# 启用 Swap
sudo swapon /swapfile

# 设置开机自动挂载 Swap
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

步骤 2：安装 Node.js 22+ 版本

OpenClaw 依赖 Node.js 22 及以上版本，使用 nvm 一键安装：

bash

# 安装 nvm 工具
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 刷新环境变量
source ~/.bashrc

# 安装 Node.js 22
nvm install 22

# 切换使用 Node.js 22
nvm use 22

步骤 3：安装 OpenClaw（最新版）

官方一键脚本安装：

bash

curl -fsSL https://openclaw.ai/install.sh | bash

步骤 4：安装 OpenClaw 指定版本（可选）

如需安装固定版本（示例：2026.3.13），使用 npm 命令安装：

bash

npm install -g [email protected]

步骤 5：运行初始化配置向导

安装完成后，执行配置命令完成初始化；使用官方一键脚本安装一般会自动进入引导，手动指定版本安装后通常需要手动执行该命令：

bash

openclaw onboard --install-daemon

步骤 6：验证安装

执行以下命令，正常输出版本号即代表安装成功：

bash

openclaw --version

注意事项

1. 所有命令建议搭配 sudo 权限执行，避免权限不足引发报错；
2. 若网络问题导致资源下载失败，可重新执行对应命令重试；
3. 本教程仅为个人实操记录，仅供学习参考。