在 CentOS 7.9 上安装 OpenClaw:完整指南
CentOS 7.9 虽然已经停止维护,但在许多企业环境中仍在运行。本文将详细介绍如何在这个经典系统上部署现代化的 AI 助手框架 OpenClaw。
为什么选择 OpenClaw?
OpenClaw 是一个开源的 AI 助手运行时,支持多模型、多通道、技能扩展,让你可以轻松构建个性化的 AI 助手。主要特性:
- 🧠 支持 Kimi、Gemini、Claude 等多种大语言模型
介绍在已停止维护的 CentOS 7.9 系统上部署 OpenClaw AI 助手框架的步骤。主要流程包括升级 Node.js 至 18+ 版本,通过 npm 或手动方式安装 OpenClaw,配置飞书等通讯通道,设置 systemd 服务实现开机自启,以及扩展技能功能。同时提供了常见问题排查及安全加固建议,确保在老系统上稳定运行。
CentOS 7.9 虽然已经停止维护,但在许多企业环境中仍在运行。本文将详细介绍如何在这个经典系统上部署现代化的 AI 助手框架 OpenClaw。
OpenClaw 是一个开源的 AI 助手运行时,支持多模型、多通道、技能扩展,让你可以轻松构建个性化的 AI 助手。主要特性:
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 -
# 使用 npm 安装 OpenClaw(使用国内镜像加速)
npm config set registry https://registry.npmmirror.com
sudo npm install -g openclaw@latest
# 验证安装
openclaw --version
# 创建安装目录
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. 启用通道插件
编辑配置文件:
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 凭证:
# 测试运行(前台)
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
常用技能推荐:
# 检查服务状态
openclaw status
# 查看已启用的通道
openclaw gateway status
# 测试发送消息(如果配置了消息通道)
openclaw message --channel feishu --target your-user "Hello from OpenClaw!"
错误:Node.js version >= 18.0.0 required 解决:使用 NodeSource 源安装新版 Node.js,见环境准备章节
错误:EACCES: permission denied 解决:
# 不要以 root 运行,使用普通用户
# 如果需要,修复 npm 权限
sudo chown -R $USER:$USER ~/.npm
错误:JavaScript heap out of memory 解决:
# 增加 Node.js 内存限制
export NODE_OPTIONS="--max-old-space-size=4096"
解决:
# 配置 npm 使用国内镜像
npm config set registry https://registry.npmmirror.com
# 或临时使用
npm install -g openclaw --registry=https://registry.npmmirror.com
错误: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 --version
# 升级到新版本
sudo npm update -g openclaw
# 检查配置兼容性
openclaw config validate
# 停止服务
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),但整体过程相对简单。关键是:
OpenClaw 的灵活架构让你可以轻松接入各种 AI 模型和通讯工具,是构建企业级 AI 助手的理想选择。即使是在 CentOS 7.9 这样的老系统上,也能焕发新的活力。提示:CentOS 7.9 已于 2024 年 6 月停止维护,建议尽快迁移到 CentOS Stream、Rocky Linux、AlmaLinux 或 RHEL 9 等受支持的系统以获得安全更新。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online