Hermes Agent 从零部署：5步上手，技术小白也能跑起来

摘要： Hermes Agent虽然功能强大，但官方文档的部署流程对新手不够友好。本文以铠盒AIBOX为例，梳理从下载到跑起来的完整流程，标注每个环节可能遇到的坑和解决方法。即使是没接触过Linux的小白，也能按步骤完成部署。

一、部署前的准备

1.1 硬件要求

Hermes Agent对硬件有一定要求，但不算苛刻：

组件	最低要求	推荐配置
CPU	4核	8核+
内存	4GB	4GB+
存储	10GB	50GB+
网络	宽带连接	宽带连接

铠盒AIBOX A1完全可以运行Hermes的所有功能，包括持久记忆模块。

1.2 部署模式选择

Hermes提供两种部署模式：

• Docker模式（推荐）：一键部署，自动配置依赖，适合大多数用户
• 源码模式：手动编译安装，适合需要定制化的技术用户

本教程以Docker模式为主，源码模式作为扩展参考。

二、第一步：获取Hermes Agent

打开终端或SSH连接到设备，执行：

# 克隆仓库
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# 切换到最新稳定版
git checkout v0.4.0-stable

常见问题

• 网络超时：使用国内镜像加速下载
• 权限不足：ssh时使用非root用户，然后用sudo切换到安装目录
• Git版本过低：升级到2.30+

三、第二步：配置大模型API

Hermes需要一个LLM后端来驱动Agent推理。支持的API提供商：

提供商	推荐模型	配置方式
OpenAI	GPT-4o / GPT-4.1	填写API Key
Anthropic	Claude 4 Sonnet / Claude 3.5 Opus	填写API Key
DeepSeek	DeepSeek-V3	填写API Key
本地模型	Qwen 2.5 (7B-14B)	需要本地GPU

# 复制配置文件
cp config.example.yaml config.yaml

# 编辑config.yaml，填入API Key
nano config.yaml

关键配置项

配置文件中需要特别注意的几项：

1. llm.provider：选择API提供商
2. llm.api_key：填入你的API Key
3. memory.enabled：是否启用持久记忆（建议true）
4. memory.storage_path：记忆存储路径（建议放在SSD上）

四、第三步：启动Hermes Agent

# Docker模式（推荐）
docker compose up -d

# 或源码模式
pip install -r requirements.txt
python run.py

首次启动需要下载约2GB的依赖包，耗时5-15分钟（取决于网络速度）。

验证是否启动成功

访问 http://localhost:1987/health，如果返回 {"status": "ok"} 即表示部署成功。

在浏览器中打开 http://localhost:1987 进入Hermes管理界面。

五、第四步：创建第一个Persona

Hermes的核心单元是Persona（人设）。部署完成后，创建一个简单的Persona：

1. 登录管理界面
2. 点击"创建Persona"
3. 填写名称、角色描述（例如："你是一个市场分析助手"）
4. 选择API模型
5. 启用持久记忆
6. 保存

建议：先创建一个测试Persona，熟悉基本操作后再创建正式使用的Persona。

六、第五步：连接铠盒Web界面

铠盒AIBOX用户有额外优势——通过铠盒Web管理界面可以直接管理Hermes Agent，无需在终端操作：

1. 访问铠盒Web界面（设备IP:3987）
2. 在"Agent管理"页面添加Hermes连接
3. 填写Hermes的API地址（默认 http://localhost:1987）
4. 点击"验证连接"，确认绿色勾号出现

至此，Hermes Agent已成功部署并接入铠盒管理系统。

七、踩坑指南

以下是部署过程中最常见的10个问题和解决方案：

问题	原因	解决
Docker拉取超时	网络问题	配置国内镜像源
API Key无效	密钥格式错误	检查是否有多余空格
管理界面空白	浏览器兼容	使用Chrome或Edge最新版
记忆不生效	memory.enabled未开	检查配置文件
Agent响应慢	模型选择过大	改用中小模型
端口冲突	1987已被占用	修改port配置
配置文件语法错误	YAML缩进不对	使用在线YAML验证器
Persona创建失败	必填项缺失	检查所有字段

八、铠盒预装：跳过5步直接到第6步

铠盒AIBOX用户还有一条捷径——E1及以上型号预装Hermes Agent，直接跳过步骤1-5：

步骤	自己部署	铠盒E1
环境准备	20-60分钟	无需（已预装）
配置API	5分钟	3分钟（Web界面配置）
启动服务	10分钟	无需（服务已运行）
创建Persona	10分钟	10分钟（一样）
接入管理	5分钟	无需（已集成）
总计	50-90分钟	13分钟

如果你拥有铠盒E1，可以直接从"创建Persona"开始，省下最繁琐的部署环节。

九、写在最后

Hermes Agent的部署本身不复杂，但坑多且碎。如果你是技术负责人技术背景好，自己部署很快。如果你只想快速使用Hermes的能力，铠盒E1的预装方案让你省下部署的时间，直接进入使用环节。

---

铠盒智能 | 让AI 7×24小时替你干活的智能体计算机 · Hermes专区