一步一步带你安装并解构 Hermes Agent (图文详解)
零、介绍

如果把 DeepSeek,ChatGPT 比作“江湖百晓生”,那 Hermes Agent 更像一个“能文能武的秘书”:
- 能连接外部工具或服务,比如连接微信
- 能根据你的指令执行定期任务:比如定时总结并提醒股市行情
- 能通过 MCP 等方式扩展能力:比如连接专业数据库
- 适合做自动化、工作流编排、AI 助手后端
简而言之就是:
“Hermes Agent 是一个让 AI 不只会聊天,还能真正帮你“办事”的智能代理框架。”
有意思的事,Hermes 指的就是希腊神话中的赫尔墨斯,玩过战神游戏,看过奥林匹斯星传的老铁应该不陌生。

他是希腊众神中速度最快的神,有“快速传递信息、连接不同系统、执行任务”的含义。 这也是作者使用 Hermes 命名的用意。
相较于 OpenClaw,Hermes Agent 优势是什么?
- 消耗 token 少,消耗 token 少,消耗 token 少,相对来说省钱还快
- 内置自学习循环,可以自动进化,自动从交互中生成 Skill
- 持久化知识库和用户偏好
- 跨会话构建对用户的深度理解
一、安装
1.1 安装前准备
- 安装无需翻墙
- 如果你之前用过 WSL,那么关闭 WSL 内的 pip 和 npm 的国内镜像,使用原生配置,
Window 安装 WSL
如果是 Linux 跳过这一步,直接进行安装。
参考之前的博客,我们不需要图形化界面,直接安装完命令行界面就可以了。
https://zhuanlan.zhihu.com/p/258563812
1.2 安装 Hermes Agent
如果是 Window 用户,点击 Win 键,搜索 WSL打开 WSL 终端。
如果是 Linux 用户,打开终端。

第一次 WSL 安装成功后,需要设置用户名和密码

在 终端中输入以下命令,开始安装
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装完成后,开始配置

需要配置主力模型,我们选择 DeepSeek

先换到 DeepSeek 的 API Keys 界面

创建 API Key

复制生成的 API Key 到刚刚的界面中

BaseURL 直接回车,选择 deepseek-v4-pro模型,高性价比

选择在本地运行

下一步设置信息交互平台,我们选择跳过
如果选错,使用 Ctrl+ C退出就可以了

安装完成后,输入下面命令让配置生效
source ~/.basrhc

在命令行输入下面内容,启用 hermes
hermes

可以看到启用的 deepseek-v4-pro模型,并可以进行简单对话

退出使用 Ctrl+ C
1.3 配置消息交互平台
在在终端输入以下命令
hermes gateway setup
比如,选择微信。

我们使用 QR 扫码进行绑定

如果出现二维码渲染失败,我们需要安装对应的包,正好可以测试 Hermes 的 AI 功能

使用 退出使用 Ctrl+ C 退出当前操作
在终端输入 hermes,可以进入命令行。正好这这里尝试 Hermes 是否可以作为自动化 AI 工作。我们输入下面的提示词。
帮我在 Hermes python 环境中安装 python 包 qrcode pillow

当安装完成后,退出当前界面,再次使用命令进入配置界面
hermes gateway setup

在手机端接受连接,默认回车

默认回车

默认回车

允许运行在后台

确认

在微信随便输入一行内容,会给你一行命令,将其输入在 Hermes 的窗口,完成配对:
hermes pairing approve weixin XXXXXXXX

二、Hermes 性格设置(灵魂)
SOUL.md 用于取代机械式的回复,赋予 Agent 性格特征。
设置文件的路径在,该文件定义内容位于系统提示词的 top 位置:
~/.hermes/SOUL.md
SOUL.md 的文件内容不会在上下文中重复出现,避免不必要的 token 消耗。
SOUL.md 中的内容包括:
- 身份职业:比如,工程师,作家
- 语气,语调:比如,青年男性,委婉
- 语义的不确定性,模糊性:比如,详尽的解释
- 避免内容:比如,人身攻击
一个例子:
# SOUL
## 个性
你是一位务实的生物信息学专家和资深的程序员,名字叫小白。
你优先考虑真实性、清晰度和可执行性,而不是客套或空泛表达。
## 风格
- 直接,但不冷漠
- 简洁,少说废话
- 重点放在问题本身
- 不确定时明确说明
- 发现错误时直接指出,并给出更好的方案
## 专长
你主要帮助处理生物信息学相关问题:
- 优先使用 Python、R、Nextflow 和 HPC 使用
- 生物信息学脚本编写、排错和优化
- 科研写作、邮件、图注和结果解释
## 回答原则
- 优先给出可直接运行的命令或代码
- 解释要够用,不要过度展开
- 不要编造不存在的结果、参数或文献
- 对高风险或不确定内容,要提示验证方法
- 用户的思路有问题时,不要顺着说,要指出问题
## 避免
- 阿谀奉承
- 夸张的语言
- 空泛总结
- 过度解释显而易见的内容
- 在没有证据时给出确定结论
再次启动 Hermes,询问你是谁:

最佳实践
先使用几天 Hermes,它会记住你的喜好,然后让 Hermes 帮你生成 SOUL.md 文件
提示词如下
读取我们的历史会话和记忆,基于我们的对话内容,生成并写入 ~/.hermes/SOUL.md
三、Hermes 皮肤设置(外貌)
需要你输入下面内容加空格,就会显示皮肤名称,上下箭头可以切换,回车选择
/skin

主题文件在
~/.hermes/skins
四、Hermes 副驾模型(秘书的秘书)
由于主力模型需要消耗 token 完成大部分任务,为了减少 token 消耗,我们可以将低复杂度的活交给便宜的模型去做。
Auxiliary 是 Hermes 的 LLM 路由中心,也就是它可以决定将需求推给主力模型还是辅助模型。
设置可以在对话中可以完成
压缩对话的辅助模型可以使用 deepseek-v4-flash
五、Hermes 工具(生产资料)
默认工具的列表
| 类别 | 示例 | 描述 |
|---|---|---|
| 网络 | web |
网络搜索与网页内容抓取。 |
| 浏览器 | browser |
浏览器自动化操作。 |
| 终端与文件 | terminal, file, code_execution |
执行命令、操作文件和运行代码。 |
| 媒体 | vision, video, image_gen, video_gen, tts |
图片/视频分析与生成,以及文本转语音。 |
| Agent 编排 | todo, clarify, delegation, moa |
任务规划、澄清问题、任务委托和多 Agent 协作。 |
| 记忆与搜索 | memory, session_search |
持久化记忆与历史会话搜索。 |
| 自动化与交付 | cronjob, messaging, computer_use |
定时任务、消息发送和电脑自动化操作。 |
| 集成 | homeassistant, spotify, yuanbao, x_search |
第三方服务或平台集成。 |
| Skills | skills |
管理和调用 Skills 能力。 |
查看所有工具
hermes tools list

关闭工具
hermes tools disable browser

启用工具
hermes tools enable browser

可以在 hermes 页面中交互式查看
但是这种方式比较慢
/tools list

启用和关闭
/tools enable web
/tools disable web

六、Hermes 技能(员工能力)
skills 的路径
~/.hermes/skills

查看 Skills
hermes skills list

搜索和安装 Skills
浏览
hermes skills browse # 查看所有 hub skills
hermes skills browser --source --official # 查看官方 skills

搜索
hermes skills search image

安装前预览
hermes skills inspect clip

安装
hermes skills install bioinformatics

七、Hermes MCP(扩展能力)
配置 Github MCP
- 进入 Github Setting 页面

- 在左侧栏最下面,选择
Developer settings

- 生成 Token

- 按照你的需求,选择权限。如不不知道怎么选,避免选择 Delete 相关内容,防止删除重要内容

- 记录生成的 token

- 打开配置文件
~/.hermes/config.yaml
- 复制下面的内容(注意缩进),并加入你自己的 token
更多 Github mcp tools 可以查看:https://github.com/github/github-mcp-server
mcp_servers:
github:
command: "npx"
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_PERSONAL_ACCESS_TOKEN: "your_token"
tools:
include: [list_issues, create_issue, search_code]
在 config 文件中加入,注意缩进

- 检测是否设置成功,你可以使用命令
hermes tools list

- 使用这个 MCP
总结 hermes-agent github 最近的 Issues 问题集中在什么地方
其他 MCP 服务器
| MCP 服务器 | 功能 | 安装命令 |
|---|---|---|
server-github |
GitHub 仓库操作 | npx @modelcontextprotocol/server-github |
server-postgres |
PostgreSQL 查询 | npx @modelcontextprotocol/server-postgres |
server-sqlite |
SQLite 操作 | npx @modelcontextprotocol/server-sqlite |
server-filesystem |
文件系统操作 | npx @modelcontextprotocol/server-filesystem |
server-brave-search |
Brave 搜索 | npx @modelcontextprotocol/server-brave-search |
playwright-mcp |
浏览器自动化 | npx @playwright/mcp@latest |
八、Hermes 定时任务 Cron
Corn 由后台网关守护进程执行。网关每 60s 触发依次调度器,如果有定时任务则触发。
你可以在对话中直接说
每天早上发给我今天的天气和穿搭
Agent 会自动创建一个 cron
在对话框中管理定时任务:
/cron list # 查看定时任务
/cron pause <job_id> # 暂停任务
/cron resuem <job_id> # 恢复任务
/cron remove <job_id> # 删除任务
/cron add "every 24h" --skill weather # 指定技能用于定时任务
在命令行中
hermes cron list # 查看定时任务
hermes cron pause <job_id> # 暂停任务
hermes cron resuem <job_id> # 恢复任务
hermes cron remove <job_id> # 删除任务
九、Hermes 记忆 Memory
Hermes Agent 用于受限且经过精选的记忆,这些记忆可以跨会话持久存在。
Hermes 有两个文件存储记忆:
| 文件 | 用途 | 字符限制 |
|---|---|---|
MEMORY.md |
Agent 的个人笔记:环境事实、规则约定、已学习知识 | 2,200 字符(约 800 tokens) |
USER.md |
用户画像:偏好、沟通风格、期望 | 1,375 字符(约 500 tokens) |
这些内容会在每个会话开始前作为冻结快照注入系统提示词。
如果字符到达限制,Agent 会自动合并记忆内容。
目录位置
~/.hermes/memories
Memory Provider
Hermes 还可以支持 Memory 插件,一般用不上。可以使用下面的命令来配置
hermes memory setup
十、Hermes 会话
会话在目录,这是一个 SQLite 轻量级数据库,也是作为 Memory 的一部分。
~/.hermes/state.db
使用 FTS5 关键词全文检索 + LLM 二次摘要
十一、Hermes Web 界面化
运行命令
hermes dashboard
第一次运行会先构建网页内容,第二次运行就可以访问网址了

更多推荐


所有评论(0)