🚀 云服务器部署 Hermes Agent 全指南：从入门到实战避坑

Hermes Agent 作为一款具备“自进化”能力的开源 AI 智能体，最近热度极高。它不仅支持持久化记忆，还能自主创建技能，甚至能接入微信、钉钉等平台。

虽然官方提供了一键安装脚本，但在国内云服务器环境下直接部署，往往会遇到网络阻断、依赖缺失等“拦路虎”。本文将手把手教你在云服务器（以 Ubuntu 22.04 为例）上完美部署 Hermes Agent，并详细记录网络与插件问题的解决方案。

📋 准备工作

在开始之前，请确保你拥有一台 Linux 云服务器（推荐 Ubuntu 22.04 或 Debian 11+），并已获取 root 权限。

  • 硬件要求：建议 2核 CPU / 4GB 内存及以上（内存不足可能导致运行卡顿）。

  • 软件依赖：Git, Curl。

🛠️ 第一步：环境初始化与网络优化

国内服务器直接连接 GitHub 往往会被阻断（403 Forbidden）或速度极慢，这是部署失败的头号原因。

1. 更新系统并安装基础工具

sudo apt update && sudo apt install -y git curl wget

2. 解决 GitHub 网络连接问题

如果官方脚本无法下载，通常是因为 GitHub 的 SSH 端口被墙。我们可以手动通过 HTTPS 克隆仓库来绕过这个问题。

  • 方案 A（推荐）：手动 HTTPS 克隆

官方脚本默认尝试 SSH 克隆，我们可以先手动下载代码，再执行安装脚本：

1. 使用 HTTPS 递归克隆（包含子模块）
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git

2. 进入目录
cd hermes-agent

3. 执行安装脚本
./scripts/install.sh

  • 方案 B：配置代理（如果你有 HTTP 代理）

如果你的服务器配置了代理（如 Clash 等），可以在执行安装前设置环境变量：

export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890
# 然后再执行官方一键安装命令
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

📥 第二步：安装 Hermes Agent

如果你采用了方案 A，执行完上述步骤后，安装脚本会自动运行。它会利用 uv 自动配置 Python 3.11 虚拟环境并安装依赖，无需手动干预。

验证安装：

安装完成后，如果提示 command not found，请刷新环境变量：

source ~/.bashrc

然后检查版本：

hermes --version
hermes doctor

🔌 第三步：插件与依赖问题排查

Hermes Agent 的功能依赖于多种外部工具和插件。如果 hermes doctor 报错，通常是缺少以下组件。

1. 常见缺失依赖及修复

  • ripgrep (rg)：用于快速文件搜索，很多技能依赖它。

  • ffmpeg：用于处理音频/视频。

  • nodejs/npm：部分前端或工具链依赖。

修复命令（Ubuntu/Debian）：

sudo apt install -y ripgrep ffmpeg nodejs npm

2. Python 版本冲突

Hermes Agent 强依赖 Python 3.11 或 3.12。如果你的服务器默认是 Python 3.13 或更低版本，可能会导致 C 扩展库编译失败。

  • 解决方案：官方安装脚本使用的 uv 工具会自动管理 Python 版本。如果遇到报错，请确保不要手动创建虚拟环境，而是让安装脚本自动处理。

3. 技能无法自动生成

如果你发现 Hermes 无法自动创建技能，可能是权限问题。

  • 检查：确保当前用户有权限执行终端命令。

  • 配置：检查 ~/.hermes/config.yaml 中是否禁用了相关技能配置。

🔑 第四步：核心配置（对接大模型）

Hermes 本身只是一个框架，你需要为它接入“大脑”。这里以阿里云百炼（通义千问）为例。

1. 运行配置向导

hermes setup

2. 配置 API Key

在交互式菜单中，选择模型提供商。

  • 关键点：不要选择 Custom endpoint（自定义端点），这容易导致 404 错误。请直接选择内置的提供商，如 Alibaba Cloud / DashScope。

  • 输入密钥：填入你的 API Key（如 sk-xxxx）。

你也可以手动编辑配置文件 ~/.hermes/.env：

# 阿里云百炼配置示例
DASHSCOPE_API_KEY=你的API_KEY

🏃 第五步：后台运行与网关启动

为了让 Hermes 在云服务器上 24 小时运行，并接入微信等即时通讯工具，我们需要使用后台运行工具。

1. 使用 tmux（推荐）

tmux 可以让你在断开 SSH 连接后，程序依然在后台运行。

# 1. 创建一个新的 tmux 会话，命名为 hermes
tmux new -s hermes

# 2. 启动 Hermes 网关（用于接入微信/Telegram等）
hermes gateway

# 3. 退出 tmux（不关闭程序）
# 按下 Ctrl+b，然后按 d

2. 微信接入

在 hermes gateway 启动后，选择微信通道，扫码登录即可。

  • 注意：如果扫码后无反应，请检查服务器防火墙是否放行了相关端口，或尝试重启网关。

🚧 常见“致命”坑与解决方案

为了方便大家排错，我总结了部署过程中最容易遇到的几个问题：

问题现象

可能原因

解决方案

安装脚本 403/卡住

GitHub SSH 端口被墙

使用 git clone --recurse-submodules https://... 手动拉取代码

command not found

环境变量未生效

执行 source ~/.bashrc 或重启终端

模型调用 404

端点配置错误

在 hermes model 中选择内置厂商（如 DashScope），不要手动填 URL

Python 报错

版本不兼容

确保使用 Python 3.11/3.12，不要强制使用 3.13

微信无响应

网络或配对问题

检查 hermes pairing list，确认账号已授权

📌 总结

在云服务器上部署 Hermes Agent 并不复杂，核心在于解决网络连通性和Python 环境这两个关键点。

一旦部署成功，你就可以通过微信随时随地唤醒你的 AI 助手，让它帮你写代码、做总结、甚至管理服务器。随着使用时间的推移，Hermes 会积累记忆和技能，变得越来越懂你。

评论