Hermes Agent 从入门到上手：30分钟搭建你的 AI 智能体平台

最近试用了 Hermes Agent，没想到用起来之后确实有点东西。这篇文章就把我从安装到上手的完整过程记录下来，希望能帮你少走点弯路。

为什么选择 Hermes Agent

现在 AI Agent 框架挺多的，为什么选 Hermes？说说我看重的几点：

• 安装真的简单：一行命令就能装好，没有 Docker 那套繁琐配置，也不用折腾半天环境变量
• Web UI 太好用：有个可视化面板，8个平台（Telegram、Discord、微信等）统一管理
• 功能实用：多 Agent 群聊、定时任务、Web 终端这些功能，不是花架子
• 三层记忆系统：内建自改进学习循环，这个是 Nous Research 的特点

准备工作

我是在 Windows + WSL 环境下安装的，如果你用纯 Linux 或者 macOS，流程基本一样。

前提条件：

• WSL 或 Linux 环境
• 能访问外网（用来下载安装包）
• 至少一个第三方模型 API Key（我用的是 Claude，OpenAI 也支持）

第一步：安装 Hermes Agent

官方给的安装脚本，直接跑就行：

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

安装过程中会有配置向导，跟着走就行：

? 请选择语言 › 中文
? 请输入你的 API Key › sk-...
? 请选择默认模型 › claude-3-5-sonnet

装好后验证一下：

hermes doctor

如果看到一堆绿色的 ✓，说明安装成功了。

第二步：安装 Web UI（强烈推荐）

这步是我觉得最值的，有了 Web UI，用起来舒服太多。

先配置一下 npm 镜像（国内网络你懂的）：

npm config set registry https://registry.npmmirror.com

然后一键安装启动：

npm install -g hermes-web-ui && hermes-web-ui start

或者用官方的一键脚本（连 Node.js 都自动装）：

bash <(curl -fsSL https://cdn.jsdelivr.net/gh/EKKOLearnAI/hermes-web-ui@main/scripts/setup.sh)

启动成功后，打开浏览器访问：http://localhost:8648

你会看到一个清爽的面板，这时候就能开始玩了。

Web UI 核心功能

左边侧栏能看到所有聊天记录，按平台分组：Telegram、Discord、Slack、WhatsApp、Matrix、飞书、微信、企业微信。微信是网页扫码登录，不用开着微信 PC 端，这点挺方便。

对话是 SSE 流式的，打字一样一个字一个字往外蹦，体验很流畅。还有个全局搜索功能，Ctrl+K 就能搜之前的对话，不用翻半天。

用量分析面板是杀手级功能：每个模型的 token 用量、费用估算、缓存命中率、30天趋势图。同时用好几个模型的话，能清楚知道钱花在哪了。

多 Agent 群聊功能一开始以为是噱头，试了之后发现挺有意思：建一个聊天室，里面放多个 Agent，@某个 Agent 他就会回复你，多个 Agent 之间还能互相配合。我试了下放了一个写代码的 Agent 和一个审阅的 Agent，写完自动审阅，挺丝滑的。

定时任务用 Cron 表达式配置，还能一键触发立即执行。我设置了一个每天早上9点总结新闻的任务，挺好用。

面板里直接嵌了个终端，node-pty 驱动的，不用再开 SSH 窗口了，直接在浏览器里敲命令。

文件管理支持四种后端：本机、Docker、SSH、Singularity。上传下载重命名移动，全部在网页里搞定。

常用命令整理

安装好后，这些命令会经常用到：

命令	说明
hermes	开始聊天
hermes -c	继续上次对话
hermes -q "问题"	单次问答
hermes setup	完整配置向导
hermes model	选模型
hermes config	看配置
hermes config set KEY VAL	设配置项
hermes doctor	健康检查
hermes status	看状态
hermes skills search 关键词	搜技能
hermes skills install ID	装技能
hermes skills list	查看装了哪些技能
hermes gateway setup	配置消息平台
hermes gateway start	启动网关
hermes update	更新到最新版
hermes memory stats	看记忆统计
hermes memory prune	清理记忆
hermes sessions list	看会话历史

我的使用建议

1. 先从简单场景开始

不用一上来就搞复杂的 multi-agent，先让 Hermes 帮你做些简单的事：

• 写脚本
• 查资料
• 整理笔记

熟悉了再玩高级功能。

2. 技能市场有好东西

去技能市场逛逛：

• https://skillhub.cn/
• https://clawhub.ai/

找到合适的技能直接装，能省不少事。

3. 用好记忆系统

Hermes 有三层记忆系统，用久了它会越来越懂你，别随便清记忆，这点挺有意思。

常见问题

安装卡住了？

先试试配置 npm 镜像：

npm config set registry https://registry.npmmirror.com

Web UI 打不开？

检查 8648 端口有没有被占用，或者防火墙有没有开。

模型调用失败？

运行 hermes doctor 检查配置，看看 API Key 对不对。

有用的资源

整理了一些我常用的网址：

资源	地址	说明
官网	https://hermes-agent.nousresearch.com/	官方文档
中文文档	https://hermesagent.org.cn/docs/getting-started/setup-wizard	中文安装指南
GitHub 主仓库	https://github.com/NousResearch/hermes-agent	源码、更新日志
中文社区 FAQ	https://hermesagent.org.cn/docs/reference/faq	常见问题解答
Skills 市场	https://agentskills.io/home	插件、技能市场
Hermes 橙皮书	https://www.huasheng.ai/orange-books/hermes-agent/	从入门到精通

总结

Hermes Agent 给我的感觉是：简单、实用、不折腾。

如果你想找一个能快速上手、功能又比较全的 AI Agent 框架，值得一试。安装加上 Web UI 那套组合拳，确实能省不少事。