Linux安装Hermes Agent完整教程：Ubuntu/CentOS/Debian从零部署（2026最新）

为什么选择 Linux 部署 Hermes Agent？

Linux 是 Hermes Agent 最推荐的运行环境。相比 macOS 和 Windows，Linux 可以 24 小时稳定运行在服务器上，通过 systemd 服务实现真正的「无人值守」。你可以在本地 Linux 机器、 VPS （如腾讯云、阿里云国际版）或 Docker 容器中部署。

本文覆盖 Ubuntu 24.04 / 22.04、Debian 12、CentOS 9 四种主流发行版，从环境准备到首次启动一条龙讲解。

一、系统要求

• 系统：Ubuntu 24.04 / 22.04、Debian 12、CentOS 9 或更高版本
• CPU：2 核以上（推荐 4 核）
• 内存：4GB 以上（运行大模型需要 8GB+）
• 磁盘：至少 10GB 可用空间
• Python：3.11 或更高版本
• Node.js：v22 LTS 或更高（推荐 v24）
• 网络：能够访问 OpenAI / Anthropic / OpenRouter 等 API

二、安装步骤

1. Ubuntu / Debian（推荐方式）

第一步：安装依赖

sudo apt update
sudo apt install -y curl git build-essential

第二步：安装 Node.js 24 LTS

# NodeSource 方式安装 Node.js 24
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证版本
node -v  # 应显示 v24.x.x
npm -v

第三步：一键安装 Hermes Agent

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

脚本会自动检测系统环境，安装 Python 依赖和 Hermes 主程序。

第四步：初始化配置

# 运行安装向导
hermes setup

# 或快速初始化（跳过向导）
hermes onboard --install-daemon

2. CentOS / RHEL

# 安装 EPEL 和依赖
sudo dnf install -y epel-release
sudo dnf install -y curl git gcc gcc-c++ make

# 安装 Node.js 24
curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash -
sudo dnf install -y nodejs

# 安装 Hermes Agent
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

3. 手动安装（适用于所有 Linux 发行版）

方式一：npm 全局安装

npm install -g hermes-agent
# 或
npm install -g @nousresearch/hermes-agent

方式二：pip 安装

pip install hermes-agent

三、配置 API Key

安装完成后，需要配置大模型 API。Hermes Agent 支持 OpenRouter、OpenAI、Anthropic、MiniMax 等多种 provider。

方式一：.env 文件配置（推荐）

# 编辑配置文件
nano ~/.hermes/.env

添加以下内容（以 OpenRouter 为例）：

OPENROUTER_API_KEY=sk-or-v1-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
OPENROUTER_BASE_URL=https://openrouter.ai/api/v1

# 如果用 OpenAI
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 如果用 Anthropic
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 如果用 MiniMax（国内推荐）
MINIMAX_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

方式二：hermes setup 向导

hermes setup

运行后选择 provider，输入 API Key，全程交互式完成配置。

四、验证安装成功

# 检查版本
hermes version

# 测试运行
hermes chat "你好，测试一下"

如果 AI 正常回复，说明安装成功。

五、配置 systemd 服务（后台运行）

Linux 上最推荐的方式是用 systemd 管理 Hermes Agent，实现开机自启和后台稳定运行。

# 创建 systemd 服务文件
sudo nano /etc/systemd/system/hermes-agent.service

写入以下内容：

[Unit]
Description=Hermes Agent
After=network.target

[Service]
Type=simple
User=你的用户名
WorkingDirectory=/home/你的用户名
ExecStart=/usr/local/bin/hermes gateway --platform telegram --token 你的bot_token
Restart=always
RestartSec=10
Environment=HERMES_HOME=/home/你的用户名/.hermes

[Install]
WantedBy=multi-user.target

# 重新加载 systemd
sudo systemctl daemon-reload

# 启用开机自启
sudo systemctl enable hermes-agent

# 启动服务
sudo systemctl start hermes-agent

# 查看状态
sudo systemctl status hermes-agent

六、接入 Telegram（进阶配置）

# 在 .env 中添加
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz

# 在 config.yaml 中配置
nano ~/.hermes/config.yaml

# config.yaml 示例
model:
  default: openrouter/anthropic/claude-sonnet-4
  provider: openrouter

gateway:
  polling_timeout: 30

logging:
  level: INFO

# 重启服务
sudo systemctl restart hermes-agent

七、常见问题

Q1：安装脚本报「Permission denied」错误

# 使用 sudo 提升权限
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | sudo bash -

Q2：Node.js 版本过低

# 先卸载旧版本
sudo apt remove nodejs npm

# 重新安装 Node.js 24
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node -v  # 必须 >= v24

Q3：运行 hermes 命令提示「command not found」

# 找到 hermes 实际路径
npm list -g hermes-agent
which hermes

# 如果 npm 全局路径不在 PATH，手动添加到 .bashrc
echo 'export PATH="$(npm root -g):$PATH"' >> ~/.bashrc
source ~/.bashrc

Q4：API 调用报 401 认证错误

检查 .env 文件中的 API Key 是否正确，注意不要有多余空格：

# 查看 API Key 是否正确加载
hermes config show

Q5：systemd 服务启动失败

# 查看详细日志
sudo journalctl -u hermes-agent -n 50

# 常见原因：用户目录权限不足
chmod 755 /home/你的用户名

Q6：内存不足导致 OOM

# 创建 swap 文件
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

八、卸载方法

# 删除主程序目录
rm -rf ~/.hermes

# npm 卸载
npm uninstall -g hermes-agent

# 停止并移除 systemd 服务
sudo systemctl stop hermes-agent
sudo systemctl disable hermes-agent
sudo rm /etc/systemd/system/hermes-agent.service
sudo systemctl daemon-reload

总结

Linux 是 Hermes Agent 最稳定的运行环境。通过 systemd 服务部署，可以实现 24 小时稳定运行、开机自启。Ubuntu 和 Debian 推荐使用官方一键安装脚本，CentOS 需要额外配置 EPEL 源。安装完成后记得配置 API Key 和 systemd 服务，这才是「完整安装」的最后一公里。

相关推荐

• Hermes Agent 安装教程：Windows/Linux/macOS 详细图解
• Hermes Agent 版本升级迁移：安全升级完整步骤
• Hermes Agent 如何彻底卸载
• Hermes Agent Skills 技能扩展安装配置教程
• Hermes Agent Docker 部署完整指南