OpenCLAW 在 CentOS 7 环境下的安装（版本 2026.2.26）

OpenCLAW 安装部署文档（CentOS 7 环境）

环境说明

操作系统：CentOS 7
glibc 版本：2.17
内核版本：3.10
目标软件：OpenCLAW（版本 2026.2.26）

前置依赖安装

1. 安装 Node.js 22.16.0

步骤1：下载安装包

复制代码


# 创建临时下载目录（可选）
mkdir -p /usr/local/src/nodejs && cd /usr/local/src/nodejs

# 下载适配 glibc 2.17 的 Node.js 包
wget https://unofficial-builds.nodejs.org/download/release/v22.16.0/node-v22.16.0-linux-x64-glibc-217.tar.gz

# 校验包完整性（可选，需提前获取sha256值）
# sha256sum node-v22.16.0-linux-x64-glibc-217.tar.gz

步骤2：解压并配置环境变量

复制代码


# 解压到指定目录
tar -zxf node-v22.16.0-linux-x64-glibc-217.tar.gz -C /opt/local/

# 创建软链接（方便版本切换）
ln -s /usr/local/node-v22.16.0-linux-x64-glibc-217 /usr/local/nodejs

# 配置环境变量（临时生效）
export PATH=/usr/local/nodejs/bin:$PATH

# 配置环境变量（永久生效）
echo 'export PATH=/usr/local/nodejs/bin:$PATH' >> /etc/profile
source /etc/profile

步骤3：验证安装

复制代码


node -v  # 预期输出：v22.16.0
npm -v   # 验证npm是否正常

2. 安装 CMake 3.28.3

步骤1：下载安装包

复制代码


mkdir -p /usr/local/src/cmake && cd /usr/local/src/cmake

# 下载CMake二进制包
wget https://github.com/Kitware/CMake/releases/download/v3.28.3/cmake-3.28.3-linux-x86_64.tar.gz

步骤2：解压并配置环境变量

复制代码


# 解压到指定目录
tar -zxf cmake-3.28.3-linux-x86_64.tar.gz -C /usr/local/

# 创建软链接
ln -s /usr/local/cmake-3.28.3-linux-x86_64 /usr/local/cmake

# 配置环境变量
export PATH=/usr/local/cmake/bin:$PATH
echo 'export PATH=/usr/local/cmake/bin:$PATH' >> /etc/profile
source /etc/profile

步骤3：验证安装

复制代码


cmake --version  # 预期输出：cmake version 3.28.3

3. 配置 npm 镜像（加速依赖下载）

复制代码


# 设置国内镜像源
npm config set registry https://registry.npmmirror.com

# 验证配置
npm config get registry  # 预期输出：https://registry.npmmirror.com

4. 升级 GCC 到 9.x 版本（OpenCLAW 编译依赖）

步骤1：配置 SCL 源（解决 CentOS 7 官方源 GCC 版本过低问题）

复制代码


# 创建 SCLo-scl 源配置文件
cat > /etc/yum.repos.d/CentOS-SCLo-scl.repo << EOF
[centos-sclo-sclo]
name=CentOS-7 - SCLo sclo
baseurl=http://vault.centos.org/centos/7/sclo/x86_64/sclo/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-SIG-SCLo
enabled=1
EOF

# 创建 SCLo-rh 源配置文件
cat > /etc/yum.repos.d/CentOS-SCLo-rh.repo << EOF
[centos-sclo-rh]
name=CentOS-7 - SCLo rh
baseurl=http://vault.centos.org/centos/7/sclo/x86_64/rh/
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-SIG-SCLo
enabled=1
EOF

步骤2：导入 GPG 密钥并刷新 yum 缓存

复制代码


# 下载并导入密钥
curl -o /etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-SIG-SCLo https://vault.centos.org/centos/7/os/x86_64/RPM-GPG-KEY-CentOS-7
rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-SIG-SCLo

# 清理并重建 yum 缓存
yum clean all && yum makecache

步骤3：安装 GCC 9 及依赖工具

复制代码


# 安装 devtoolset-9 套件（包含 GCC 9）
yum install -y devtoolset-9-gcc devtoolset-9-gcc-c++ devtoolset-9-binutils scl-utils

# 临时启用 GCC 9（当前会话生效）
scl enable devtoolset-9 bash

# 永久启用 GCC 9（所有会话生效）
echo "source /opt/rh/devtoolset-9/enable" >> /etc/profile
source /etc/profile

步骤4：验证 GCC 版本

复制代码


gcc --version  # 预期输出：gcc (GCC) 9.x.x
g++ --version  # 验证 g++ 版本

OpenCLAW 核心安装

1. 执行官方安装脚本

复制代码


# 定义版本号并执行安装脚本
export OPENCLAW_VERSION=2026.2.26
curl -fsSL https://openclaw.ai/install.sh | bash

# 检查安装脚本执行结果（非零则说明安装失败）
if [ $? -ne 0 ]; then
    echo "OpenCLAW 安装脚本执行失败，请检查日志！"
    exit 1
fi

2. 配置 DBUS 环境变量（解决服务启动依赖）

复制代码


# 写入 bash 配置文件（永久生效）
echo "export DBUS_SESSION_BUS_ADDRESS=unix:path=/run/dbus/system_bus_socket" >> ~/.bashrc

# 立即生效配置
source ~/.bashrc

# 验证环境变量
echo $DBUS_SESSION_BUS_ADDRESS  # 预期输出：unix:path=/run/dbus/system_bus_socket

3. 配置系统服务（设置开机自启）

复制代码


# 复制服务文件到系统服务目录
cp /root/.config/systemd/user/openclaw-node.service /usr/lib/systemd/system/

# 重新加载系统服务配置
systemctl daemon-reload

# 设置开机自启
systemctl enable openclaw-node

# 验证服务状态（可选）
systemctl is-enabled openclaw-node  # 预期输出：enabled

4. 安装并配置 OpenCLAW Node 服务

复制代码


# 安装 Node 服务并指定端口（18790）
openclaw node install --port 18790

# 启动服务（补充原文档缺失步骤）
systemctl start openclaw-node

# 验证服务启动状态
systemctl status openclaw-node  # 预期输出：active (running)

系统环境优化

1. 时间同步（避免证书/签名验证失败）

复制代码


# 安装 ntp 工具（若未安装）
yum install -y ntpdate

# 同步时间（使用亚洲时区 NTP 服务器）
ntpdate 0.asia.pool.ntp.org

# 设置定时同步（可选，添加到 crontab）
echo "*/30 * * * * /usr/sbin/ntpdate 0.asia.pool.ntp.org > /dev/null 2>&1" >> /var/spool/cron/root
service crond restart

2. 配置端口转发（远程访问 Node 服务）

复制代码


# 建立 SSH 隧道（将本地 18790 端口转发到 192.168.11.179 的 18789 端口）
# 说明：-N 不执行远程命令，-L 本地端口转发，需保持终端运行（可加 -f 后台运行）
ssh -N -L -f 18790:127.0.0.1:18789 root@192.168.11.179

# 可选：配置 SSH 免密登录（避免每次输入密码）
# ssh-copy-id root@192.168.11.179

参考文档

OpenCLAW 官方 CLI 文档：https://docs.openclaw.ai/zh-CN/cli/node

总结

核心依赖：需先安装 Node.js 22.16.0（适配 glibc 2.17）、CMake 3.28.3、GCC 9.x，且必须配置国内 npm 镜像加速下载；
关键配置：安装后需配置 DBUS 环境变量、系统服务自启，并通过时间同步避免服务异常；
访问方式：通过 SSH 端口转发实现远程访问 OpenCLAW Node 服务（端口 18790），建议配置免密登录提升易用性。