OpenCLAW 在 CentOS 7 环境下的安装部署

步骤 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 18790:127.0.0.1:18789 -f [email protected]

# 可选：配置 SSH 免密登录（避免每次输入密码）
# ssh-copy-id [email protected]

参考文档

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

总结

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