在 CentOS 7.9 上安装 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 凭证：

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

启动 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），但整体过程相对简单。关键是：

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

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