在 CentOS 7.9 上安装 OpenClaw：完整指南

介绍在已停止维护的 CentOS 7.9 系统上部署 OpenClaw AI 助手框架的步骤。主要流程包括升级 Node.js 至 18+ 版本，通过 npm 或手动方式安装 OpenClaw，配置飞书等通讯通道，设置 systemd 服务实现开机自启，以及扩展技能功能。同时提供了常见问题排查及安全加固建议，确保在老系统上稳定运行。

邪神洛基发布于 2026/3/23更新于 2026/10/2520K 浏览

在 CentOS 7.9 上安装 OpenClaw：完整指南

CentOS 7.9 虽然已经停止维护，但在许多企业环境中仍在运行。本文将详细介绍如何在这个经典系统上部署现代化的 AI 助手框架 OpenClaw。

为什么选择 OpenClaw？

OpenClaw 是一个开源的 AI 助手运行时，支持多模型、多通道、技能扩展，让你可以轻松构建个性化的 AI 助手。主要特性：

🧠 支持 Kimi、Gemini、Claude 等多种大语言模型
📱 内置飞书、钉钉、企微、QQ、Telegram 等通道支持
🔌 丰富的技能市场（clawhub.com）
⚡ 轻量级，资源占用低
🔧 配置简单，扩展灵活

环境准备

1. 系统要求

CentOS 7.9 或兼容版本（RHEL 7、Oracle Linux 7）
至少 2GB RAM（建议 4GB）
2GB 可用磁盘空间
网络访问权限（需要下载 Node.js 和 OpenClaw）

2. 安装 Node.js

CentOS 7.9 默认的 Node.js 版本太旧（0.10.x），我们需要安装 Node.js 18+：

# 卸载旧版本（如果有）
sudo yum remove -y nodejs npm

# 安装 NodeSource 源（Node.js 18 LTS）
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -

# 安装 Node.js
sudo yum install -y nodejs

# 验证安装
node --version # 应显示 v18.x.x 或更高
npm --version # 应显示 9.x.x 或更高

如果遇到网络问题，可以使用国内镜像：

# 使用清华大学源
curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/nodesource/rpm/setup_18.x | sudo bash -

安装 OpenClaw

方法 1：使用 npm 全局安装（推荐）

# 使用 npm 安装 OpenClaw（使用国内镜像加速）
npm config set registry https://registry.npmmirror.com
sudo npm install -g openclaw@latest

# 验证安装
openclaw --version

方法 2：手动安装（适合离线环境）

# 创建安装目录
sudo mkdir -p /opt/openclaw
cd /opt/openclaw

# 从 GitHub 下载最新版本
sudo wget https://github.com/openclaw/openclaw/archive/refs/heads/main.zip
sudo unzip main.zip
sudo mv openclaw-main/* .
sudo rm -rf openclaw-main main.zip

# 安装依赖
sudo npm install --production

# 创建软链接
sudo ln -sf /opt/openclaw/bin/openclaw /usr/local/bin/openclaw

初始化配置

# 创建配置目录
mkdir -p ~/.openclaw

# 运行初始化向导
openclaw onboarding

# 向导会引导你完成：
# 1. 选择模型提供商（Moonshot/Kimi、OpenAI、Google 等）
# 2. 输入 API 密钥
# 3. 配置默认模型
# 4. 启用通道插件

配置 Feishu/飞书通道（示例）

编辑配置文件：

nano ~/.openclaw/openclaw.json

添加 Feishu 配置：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxxxxxxxxxxx",
      "appSecret": "your-app-secret-here",
      "domain": "feishu.cn"
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "moonshot/kimi-k2-thinking-turbo"
      }
    }
  }
}

获取 Feishu 凭证：

访问飞书开放平台
创建企业自建应用
获取 App ID 和 App Secret
添加机器人能力
发布版本并启用

启动 OpenClaw

# 测试运行（前台）
openclaw gateway start

# 查看状态
openclaw gateway status

# 如果一切正常，使用 systemd 管理
sudo nano /etc/systemd/system/openclaw.service

创建 systemd 服务文件：

[Unit]
Description=OpenClaw AI Assistant Gateway
After=network.target

[Service]
Type=simple
User=your-user
WorkingDirectory=/home/your-user
ExecStart=/usr/local/bin/openclaw gateway start
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

启用并启动服务：

sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw
sudo systemctl status openclaw

安装技能

OpenClaw 的强大之处在于可扩展的技能系统：

# 搜索可用技能
openclaw skills search weather

# 安装技能
openclaw skills install weather

# 更新技能
openclaw skills update

常用技能推荐：

weather - 天气查询
web-search - 网页搜索
github - GitHub 操作
obsidian - 知识库管理
tmux - 终端会话管理

验证安装

# 检查服务状态
openclaw status

# 查看已启用的通道
openclaw gateway status

# 测试发送消息（如果配置了消息通道）
openclaw message --channel feishu --target your-user "Hello from OpenClaw!"

常见问题

1. Node.js 版本过低

错误：Node.js version >= 18.0.0 required 解决：使用 NodeSource 源安装新版 Node.js，见环境准备章节

2. 权限问题

错误：EACCES: permission denied 解决：

# 不要以 root 运行，使用普通用户
# 如果需要，修复 npm 权限
sudo chown -R $USER:$USER ~/.npm

3. 内存不足

错误：JavaScript heap out of memory 解决：

# 增加 Node.js 内存限制
export NODE_OPTIONS="--max-old-space-size=4096"

4. 网络连接超时

解决：

# 配置 npm 使用国内镜像
npm config set registry https://registry.npmmirror.com
# 或临时使用
npm install -g openclaw --registry=https://registry.npmmirror.com

5. 端口冲突

错误：Port 18789 already in use 解决：修改配置文件中的端口：

{
  "gateway": {
    "port": 18790
  }
}

安全加固建议

虽然 CentOS 7.9 已停更，但仍可采取基本安全措施：

# 启用防火墙
sudo systemctl start firewalld
sudo firewall-cmd --permanent --add-port=18789/tcp
sudo firewall-cmd --reload

# 限制监听地址（仅本地访问）
# 在 openclaw.json 中配置：
"gateway": {
  "bind": "127.0.0.1"
}

# 定期备份配置
cp ~/.openclaw/openclaw.json ~/openclaw-config-backup.json

升级 OpenClaw

# 查看当前版本
openclaw --version

# 升级到新版本
sudo npm update -g openclaw

# 检查配置兼容性
openclaw config validate

卸载 OpenClaw

# 停止服务
sudo systemctl stop openclaw
sudo systemctl disable openclaw
sudo rm /etc/systemd/system/openclaw.service

# 卸载
sudo npm uninstall -g openclaw

# 清理配置（如需）
rm -rf ~/.openclaw

总结

在 CentOS 7.9 上部署 OpenClaw 虽然需要一些额外步骤（主要是新版 Node.js），但整体过程相对简单。关键是：

升级 Node.js - 这是最重要的一步
配置通道 - 根据你的需求启用相应通道
安装技能 - 扩展功能
使用 systemd - 确保稳定运行

OpenClaw 的灵活架构让你可以轻松接入各种 AI 模型和通讯工具，是构建企业级 AI 助手的理想选择。即使是在 CentOS 7.9 这样的老系统上，也能焕发新的活力。提示：CentOS 7.9 已于 2024 年 6 月停止维护，建议尽快迁移到 CentOS Stream、Rocky Linux、AlmaLinux 或 RHEL 9 等受支持的系统以获得安全更新。