OpenCLAW 在 CentOS 7 环境下的安装（版本 2026.2.26）
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 [email protected] # 可选：配置 SSH 免密登录（避免每次输入密码） # ssh-copy-id [email protected]
参考文档
- 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），建议配置免密登录提升易用性。
