[特殊字符] OpenClaw（小龙虾）CentOS 7 完整安装手册

🔧 **适用系统**：CentOS 7.x（本文基于 CentOS 7.9 编写）  
🏗️ **架构要求**：x86_64  
👤 **操作用户**：root（为简化操作，本文全程使用 root 用户）

—

## 📑 目录

– [一、环境准备](#一环境准备)
– [二、安装 Node.js 22.16.0](#二安装-nodejs-22160)
– [三、安装 CMake 3.28.3](#三安装-cmake-3283)
– [四、升级 GCC 到 9.x 版本](#四升级-gcc-到-9x-版本)
– [五、安装 OpenClaw](#五安装-openclaw)
– [六、配置 OpenClaw 网关服务](#六配置-openclaw-网关服务centos-7-专用)
– [七、配置外部访问](#七配置外部访问从物理机访问虚拟机)
– [八、常用管理命令](#八常用管理命令)
– [九、常见问题排查](#九常见问题排查)
– [十、安全建议](#十安全建议)

—

## 一、环境准备

### 📦 安装基础工具
```bash
# 安装必要的基础工具
yum install -y wget curl tar net-tools
```

✅ **验证方法**：
```bash
wget –version | head -1
curl –version | head -1
```

—

## 二、安装 Node.js 22.16.0

> 💡 **说明**：使用官方非标准构建版本，适配 CentOS 7 的 glibc 2.17

### 2.1 下载 Node.js 二进制包
```bash
# 创建下载目录
mkdir -p /usr/local/src/nodejs && cd /usr/local/src/nodejs

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

### 2.2 安装 Node.js
```bash
# 解压到目标目录
tar -zxf node-v22.16.0-linux-x64-glibc-217.tar.gz -C /opt/local/

# 创建软链接
ln -s /opt/local/node-v22.16.0-linux-x64-glibc-217 /usr/local/nodejs

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

### 2.3 验证安装
```bash
node -v  # 预期输出：v22.16.0
npm -v   # 预期输出：10.x.x
```

📌 **成功标志**：
```
v22.16.0
10.8.2
```

—

## 三、安装 CMake 3.28.3

### 3.1 下载 CMake 二进制包
```bash
mkdir -p /usr/local/src/cmake && cd /usr/local/src/cmake

wget https://github.com/Kitware/CMake/releases/download/v3.28.3/cmake-3.28.3-linux-x86_64.tar.gz
```

### 3.2 安装 CMake
```bash
# 解压到 /usr/local
tar -zxf cmake-3.28.3-linux-x86_64.tar.gz -C /usr/local/

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

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

### 3.3 验证安装
```bash
cmake –version  # 预期输出：cmake version 3.28.3
```

📌 **成功标志**：
```
cmake version 3.28.3
```

—

## 四、升级 GCC 到 9.x 版本

### 4.1 配置 SCL 软件源

```bash
# 创建 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
```

### 4.2 导入正确的 GPG 密钥

```bash
# 下载正确的 SCLo 密钥
curl -o /etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-SIG-SCLo \\
     https://www.centos.org/keys/RPM-GPG-KEY-CentOS-SIG-SCLo

# 导入密钥
rpm –import /etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-SIG-SCLo

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

### 4.3 安装 GCC 9

```bash
# 安装 devtoolset-9 套件
yum install -y devtoolset-9-gcc devtoolset-9-gcc-c++ \\
               devtoolset-9-binutils scl-utils

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

# 验证 GCC 版本
gcc –version  # 应显示 gcc 9.x.x
```

📌 **成功标志**：
```
gcc (GCC) 9.3.1 20200408 (Red Hat 9.3.1-2)
```

—

## 五、安装 OpenClaw

### 5.1 执行官方安装脚本

```bash
# 安装最新版 OpenClaw
export OPENCLAW_VERSION=2026.3.8
curl -fsSL https://openclaw.ai/install.sh | bash
```

⏱️ **安装耗时**：约 3-5 分钟，取决于网络速度

### 5.2 验证安装

```bash
openclaw –version  # 应显示 2026.3.8
```

📌 **成功标志**：
```
2026.3.8
```

—

## 六、配置 OpenClaw 网关服务（CentOS 7 专用）

> ⚠️ **重要说明**：**CentOS 7 不支持 `systemctl –user`**，必须将服务转换为系统服务。

### 6.1 转换服务为系统级

```bash
# 复制服务文件到系统目录
sudo cp /root/.config/systemd/user/openclaw-gateway.service /etc/systemd/system/

# 重新加载 systemd 配置
sudo systemctl daemon-reload

# 启动服务
sudo systemctl start openclaw-gateway

# 设置开机自启
sudo systemctl enable openclaw-gateway
```

### 6.2 验证服务状态

```bash
# 查看服务状态（应显示 active (running)）
sudo systemctl status openclaw-gateway

# 查看网关详细状态
openclaw gateway status –deep
```

📌 **预期输出**：
```
Runtime: running
RPC probe: ok
```

### 6.3 查看访问令牌

```bash
# 从配置文件中获取令牌
cat ~/.openclaw/openclaw.json | grep token
```

📌 **示例输出**：
```
"token": "0f79a5210512af21cccf1622c02492cf7d587096a894bc84"
```

🔐 **请保存好此令牌**，后续登录 Web 界面需要。

—

## 七、配置外部访问（从物理机访问虚拟机）

### 7.1 获取虚拟机网络信息

```bash
# 查看虚拟机 IP 地址
ip addr show | grep inet
```

📌 **示例输出**：
```
inet 192.168.184.153/24 brd 192.168.184.255 scope global dynamic ens33
```
👉 记录下类似 `192.168.184.153` 的 IP 地址

### 7.2 SSH 端口转发（推荐方式）

> ✅ **优点**：安全，兼容 loopback 模式，无需修改防火墙

在**物理机**的终端中执行：

```bash
# 语法：ssh -L 本地端口:localhost:远程端口 用户名@虚拟机IP -N
ssh -L 8888:localhost:18789 xiaolongxia123@192.168.184.153 -N
```

| 参数 | 说明 |
|:—|:—|
| `8888` | 物理机的本地端口（可自定义） |
| `18789` | OpenClaw 网关端口 |
| `xiaolongxia123` | 虚拟机用户名 |
| `192.168.184.153` | 虚拟机 IP 地址 |
| `-N` | 仅转发，不执行远程命令 |

⚠️ **注意**：该终端需保持运行，关闭即断开隧道

### 7.3 访问 OpenClaw Web 界面

1. 在物理机打开浏览器
2. 访问：`http://localhost:8888`
3. 输入第 6.3 步获取的令牌登录

🎉 **登录成功**！你将看到 OpenClaw 的控制面板。

—

## 八、常用管理命令

### 8.1 服务管理

| 操作 | 命令 |
|:—|:—|
| 启动服务 | `sudo systemctl start openclaw-gateway` |
| 停止服务 | `sudo systemctl stop openclaw-gateway` |
| 重启服务 | `sudo systemctl restart openclaw-gateway` |
| 查看状态 | `sudo systemctl status openclaw-gateway` |
| 查看日志 | `journalctl -u openclaw-gateway -n 100 -f` |

### 8.2 OpenClaw 命令

| 操作 | 命令 |
|:—|:—|
| 查看节点列表 | `openclaw nodes list` |
| 查看技能列表 | `openclaw skill list` |
| 运行安全审计 | `openclaw security audit –quick` |
| 查看完整状态 | `openclaw status –all` |
| 查看帮助 | `openclaw –help` |

—

## 九、常见问题排查

### 9.1 网关无法启动

```bash
# 检查端口是否被占用
ss -tlnp | grep 18789

# 查看详细日志
journalctl -u openclaw-gateway -n 50 –no-pager
```

### 9.2 SSH 隧道连接失败

```bash
# 在虚拟机中检查 SSH 服务状态
sudo systemctl status sshd

# 检查防火墙是否允许 SSH
sudo firewall-cmd –list-all

# 临时关闭防火墙测试（如必要）
# sudo systemctl stop firewalld
```

### 9.3 Web 界面无法访问

🔍 **排查清单**：
– [ ] SSH 隧道终端是否保持运行？
– [ ] 令牌输入是否正确？
– [ ] 虚拟机 IP 是否变化？
– [ ] 网关服务是否运行？(`sudo systemctl status openclaw-gateway`)

```bash
# 重启网关试试
sudo systemctl restart openclaw-gateway
```

### 9.4 GCC 9 未生效

```bash
# 手动启用 GCC 9
source /opt/rh/devtoolset-9/enable

# 检查版本
gcc –version

# 重新检查 /etc/profile 配置
cat /etc/profile | grep devtoolset
```

—

## 十、安全建议

### 🔐 基础安全配置

1. **定期更新**
   ```bash
   openclaw update  # 更新 OpenClaw
   ```

2. **令牌管理**
   – 妥善保管访问令牌
   – 建议每 3 个月更换一次
   ```bash
   # 生成新令牌
   openclaw token generate
   ```

3. **防火墙配置**
   ```bash
   # 仅开放必要端口
   sudo firewall-cmd –permanent –add-port=22/tcp  # SSH
   sudo firewall-cmd –reload
   ```

4. **日志监控**
   ```bash
   # 定期检查异常
   tail -f /var/log/messages | grep openclaw
   ```

### 📚 参考文档

– [OpenClaw 官方文档](https://docs.openclaw.ai/)
– [安全配置指南](https://docs.openclaw.ai/security)
– [故障排查手册](https://docs.openclaw.ai/troubleshooting)

—

## 🎉 结语

恭喜你！🎊 至此，你已成功在 CentOS 7 上完成 OpenClaw 的完整安装和配置。现在可以通过 Web 界面开始使用你的 AI 助手了！