在 CentOS 7.9 上安装 OpenClaw：完整指南(此文章由openclaw生成)
在 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" // 或 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" // 或内网 IP
}
# 定期备份配置
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 等受支持的系统以获得安全更新。
