Hermes Agent：从安装、模型配置到 Skills / Memory / Tools 的实用上手指南

Hermes Agent 是 Nous Research 开源的自改进 AI Agent。它和普通聊天机器人最大的区别，不是“能不能聊天”，而是能否长期运行、使用工具、记住关键上下文、沉淀可复用技能，并通过 CLI、桌面端和消息平台持续处理任务。

摘要

最近 GitHub 上的 Hermes Agent 关注度很高。它的项目描述是 “The agent that grows with you”，核心卖点是自改进：在任务执行过程中积累记忆、沉淀技能、调用工具、接入消息平台，并支持长时间运行的自动化任务。

本文不做空泛概念介绍，而是从工程使用角度拆解 Hermes Agent：

• Hermes Agent 解决什么问题
• 它和普通 ChatGPT / Claude 聊天窗口有什么区别
• 如何在 Windows、macOS、Linux 上安装
• 如何配置模型 Provider
• 如何使用 CLI / TUI 开始第一轮任务
• Tools、Skills、Memory、Gateway、Cron 分别是什么
• 为什么必须重视安全边界
• 新手应该按什么顺序上手

截至 2026-07-07，GitHub 页面显示 NousResearch/hermes-agent 已有超过 20 万 Star，是近期 AI Agent 方向非常值得关注的开源项目。

目录

• 一、Hermes Agent 是什么
• 二、为什么它和普通聊天机器人不一样
• 三、整体架构理解
• 四、安装前的准备
• 五、Windows / macOS / Linux 安装方式
• 六、第一次启动：配置模型 Provider
• 七、CLI / TUI 基本使用
• 八、Tools：让 Agent 真正能做事
• 九、Skills：把经验沉淀成可复用流程
• 十、Memory：跨会话记忆是怎么工作的
• 十一、Gateway：把 Agent 接到 Telegram、Discord、Slack 等平台
• 十二、Cron：让 Agent 定时执行任务
• 十三、安全边界：不要一上来就开最大权限
• 十四、新手推荐上手路线
• 十五、常见问题
• 十六、总结

一、Hermes Agent 是什么

Hermes Agent 是 Nous Research 开源的 AI Agent 框架。它不是单纯的大模型，也不是一个普通聊天前端，而是一个围绕“长期任务执行”设计的 Agent 系统。

它的核心能力可以概括为：

对话入口
↓
模型推理
↓
工具调用
↓
文件 / 终端 / 浏览器 / Web / MCP / 消息平台
↓
记忆沉淀
↓
技能沉淀
↓
下次任务复用经验

简单说，普通聊天机器人更像一次性问答工具，而 Hermes Agent 更像一个可以持续工作的任务助手。

它可以运行在：

• 本地电脑
• VPS
• Docker 环境
• SSH 远程服务器
• 部分云端沙箱环境

也可以通过多种入口交互：

• CLI
• TUI
• 桌面端
• Telegram
• Discord
• Slack
• WhatsApp
• Signal
• Email

二、为什么它和普通聊天机器人不一样

普通聊天窗口通常是这样的：

用户提问
↓
模型回答
↓
会话结束

Hermes Agent 更接近：

用户提出目标
↓
Agent 拆解任务
↓
调用工具检查环境
↓
执行命令或读取文件
↓
必要时追问用户
↓
完成任务
↓
保存关键记忆或技能
↓
下次遇到类似问题时复用

差别主要在四点：

能力	普通聊天窗口	Hermes Agent
工具调用	通常有限	内置终端、文件、浏览器、MCP、消息平台等工具
长期记忆	多数依赖当前会话	有持久化 Memory 和 Session Search
经验复用	主要靠用户重复提示	可以沉淀 Skills
自动化	多数需要人一直盯着	支持 Gateway 和 Cron 定时任务

所以 Hermes Agent 的重点不是“回答得更像人”，而是“更像一个能持续执行任务的系统”。

三、整体架构理解

从官方架构文档看，Hermes Agent 的核心可以拆成几层：

入口层：
CLI / Gateway / ACP / API Server / Batch Runner

核心层：
AIAgent
├── Prompt Builder
├── Provider Resolution
├── Tool Dispatch
├── Compression & Caching
└── Tool Registry

存储层：
SQLite + FTS5 Session Storage

工具层：
Terminal / Files / Browser / Web / MCP / Vision / Memory / Cron

这个结构说明 Hermes Agent 不是简单把 Prompt 发给模型，而是有完整的 Agent Loop：

构造上下文
↓
选择模型 Provider
↓
发送请求
↓
解析工具调用
↓
执行工具
↓
把结果回传给模型
↓
继续下一轮推理

这也是为什么它适合处理长任务、多步骤任务和跨会话任务。

四、安装前的准备

安装之前建议先明确三件事。

1. 你准备用哪个模型

Hermes Agent 支持很多 Provider，例如：

• Nous Portal
• OpenAI
• Anthropic
• OpenRouter
• Gemini
• Qwen
• DeepSeek
• Kimi
• Hugging Face
• Ollama / LM Studio / 自定义 OpenAI-compatible endpoint

官方文档建议模型上下文长度至少 64K，因为多步工具调用需要足够长的上下文窗口。

2. 你准备让 Agent 访问哪里

不要一开始就让它访问整个电脑。更合理的方式是只在某个工作目录中使用，例如：

D:\ai-agent-workspace

或者：

C:\Users\用户名\Desktop\hermes_workspace

这样即使工具调用出问题，也能把影响范围限制在一个目录里。

3. 你是否需要消息平台

如果只是学习，先用 CLI / TUI。

如果后续想让它长期运行，再考虑接 Telegram、Discord、Slack 等 Gateway。

新手不要一上来就同时打开模型、终端、浏览器、消息平台、定时任务和全部工具。先让一个普通会话跑通，再逐步加功能。

五、Windows / macOS / Linux 安装方式

官方提供了安装脚本。

1. Linux / macOS / WSL2

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装完成后重新加载 shell：

source ~/.bashrc

或者：

source ~/.zshrc

2. Windows PowerShell

官方给出的 PowerShell 安装方式是：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

如果你对安全比较敏感，可以先把脚本内容下载下来检查，再执行：

irm https://hermes-agent.nousresearch.com/install.ps1 -OutFile install-hermes.ps1
notepad .\install-hermes.ps1
powershell -ExecutionPolicy Bypass -File .\install-hermes.ps1

Windows 原生安装会放在：

%LOCALAPPDATA%\hermes

这点很重要，因为后续如果要清理空间，可以优先检查这个目录。

六、第一次启动：配置模型 Provider

安装完成后，建议先运行：

hermes model

这个命令用于选择模型 Provider 和具体模型。

如果只想快速完成配置，可以使用：

hermes setup

官方文档中提到，hermes setup 会提供不同配置模式，包括快速配置、完整配置和 Blank Slate。

新手建议：

先让最小能力跑通，再逐步打开工具

一个比较稳的顺序是：

1. 配置模型
2. 跑通普通对话
3. 打开文件工具
4. 打开终端工具
5. 打开 Web / Browser
6. 再考虑 Gateway、Cron、MCP、Skills Hub

不要模型还没配置好，就先折腾消息平台和自动化任务。

七、CLI / TUI 基本使用

启动普通 CLI：

hermes

启动 TUI：

hermes --tui

建议第一次输入一个容易验证的任务：

查看当前目录，告诉我这个目录下有哪些主要文件。

或者：

总结当前项目结构，并指出可能的入口文件。

如果 Agent 能正确读取目录、调用工具、返回结果，就说明基础环境可用。

常用命令：

hermes doctor

用于诊断配置问题。

hermes --continue

用于恢复最近一次会话。

hermes tools

用于配置可用工具。

hermes update

用于更新 Hermes Agent。

八、Tools：让 Agent 真正能做事

Tools 是 Hermes Agent 的核心能力之一。

官方文档中提到，Hermes 的工具能力覆盖：

• Web 搜索
• 网页内容提取
• 终端执行
• 文件读取和编辑
• 浏览器自动化
• 图像理解和生成
• 文本转语音
• 任务规划
• 代码执行
• 子 Agent 委派
• Memory
• Session Search
• Cron 定时任务
• Home Assistant
• MCP Server 集成

你可以通过：

hermes tools

查看和配置工具。

也可以在启动时指定工具集：

hermes chat --toolsets "web,terminal"

这里要注意：工具不是越多越好。工具越多，Agent 能做的事情越多，风险也越高。

推荐配置策略：

阶段	建议打开的工具
初次体验	file、safe
代码项目分析	file、terminal、search
信息检索	web
自动化任务	cron、messaging
高阶集成	MCP、browser、delegation

九、Skills：把经验沉淀成可复用流程

Skills 是 Hermes Agent 非常值得关注的设计。

普通 Prompt 是一次性的，而 Skill 更像一个可复用的任务说明文件。官方文档中说，Skill 是按需加载的知识文档，用渐进披露减少 token 消耗。

可以理解为：

Skill = 任务说明 + 操作步骤 + 注意事项 + 可复用经验

例如你可以有这些 Skills：

code-review
fastapi-deploy
docker-debug
weekly-report
csdn-article-outline
github-pr-workflow

Hermes 的 Skill 通常是一个 SKILL.md 文件，存放在：

~/.hermes/skills/

可以浏览 Skills：

hermes skills browse

搜索 Skills：

hermes skills search docker

安装某个 Skill：

hermes skills install openai/skills/k8s

实际使用时，Skill 会变成 slash command：

/k8s deploy the staging manifest

它的价值在于：
如果某类任务反复出现，就不应该每次都重新写 Prompt，而应该沉淀成 Skill。

十、Memory：跨会话记忆是怎么工作的

Memory 是 Hermes Agent 区别于普通聊天工具的另一个关键点。

官方文档中提到，Hermes 的持久记忆主要由两个文件组成：

MEMORY.md
USER.md

默认存放在：

~/.hermes/memories/

它们的职责不同：

文件	作用
MEMORY.md	记录环境、项目、工具习惯、任务经验
USER.md	记录用户偏好、沟通风格、工作习惯

一个好的 Memory 不是聊天记录堆积，而是压缩后的关键事实。

例如适合保存：

这个项目使用 pnpm 管理前端依赖，测试命令是 pnpm test。

用户偏好简洁回答，除非主动要求，不要展开太多背景知识。

不适合保存：

用户今天问了一个问题。

某次终端输出的完整日志。

Hermes 还有 Session Search，可以搜索过去会话。它和 Memory 的区别是：

能力	Memory	Session Search
内容	精炼事实	历史会话
是否进入系统提示词	是	否，按需搜索
适合用途	长期关键偏好	查找过去某次讨论

Memory 很有用，但也有风险：如果错误信息被写进记忆，后面可能持续影响 Agent。所以建议新手打开记忆写入审批：

memory:
  write_approval: true

如果 Skill 也要审批：

skills:
  write_approval: true

十一、Gateway：把 Agent 接到 Telegram、Discord、Slack 等平台

Hermes Agent 不只支持命令行，还可以通过 Gateway 接入消息平台。

配置入口：

hermes gateway setup

启动 Gateway：

hermes gateway

适合场景：

• 在手机上给 Agent 发任务
• 定时推送日报
• 在团队群里接收问题
• 让 Agent 处理固定流程

但这里要非常谨慎。消息平台接入后，Agent 的入口变多了，攻击面也会扩大。

建议：

只允许自己的账号访问
不要把 Bot 拉进陌生群
不要给消息平台会话开放全部工具
先关闭高风险命令执行能力

如果只是学习，CLI / TUI 已经足够。

十二、Cron：让 Agent 定时执行任务

Cron 是 Hermes 的自动化能力之一。

它可以让 Agent 做定时任务，例如：

每天早上 9 点总结昨天的项目变更

每周五生成一份周报草稿

每天检查某个目录下是否有新日志

这类功能很诱人，但也最容易出安全问题。

新手不要一上来就让 Agent 在无人值守状态下执行终端命令。更稳妥的做法是：

第一阶段：只生成草稿，不执行外部动作
第二阶段：允许读取文件，不允许修改
第三阶段：允许执行低风险命令
第四阶段：关键操作必须人工确认

十三、安全边界：不要一上来就开最大权限

Hermes Agent 官方安全文档把安全模型拆成多层，包括：

• 用户授权
• 危险命令审批
• 容器隔离
• MCP 凭据过滤
• 上下文文件扫描
• 跨会话隔离
• 输入参数校验

这说明一件事：
Agent 能力越强，安全边界越重要。

尤其要注意 YOLO 模式。

YOLO 模式会绕过危险命令审批。官方文档也明确提醒，只应该在可信环境中谨慎使用。

新手建议：

不要开 YOLO
不要把 approvals.mode 设置为 off
不要让 Agent 操作整个 C 盘
不要在主力系统上测试危险自动化
优先使用 Docker / SSH / 独立工作区隔离

推荐配置思路：

approvals:
  mode: manual
  cron_mode: deny

memory:
  write_approval: true

skills:
  write_approval: true

terminal:
  backend: docker

如果暂时不用 Docker，也至少把工作目录控制在一个专门目录里。

十四、新手推荐上手路线

不要试图一天内把所有功能都打开。推荐按下面顺序来：

第 1 步：只跑通 CLI

hermes

测试：

请总结当前目录结构。

第 2 步：配置模型

hermes model

确认模型能正常对话。

第 3 步：诊断环境

hermes doctor

把明显配置错误先处理掉。

第 4 步：打开必要 Tools

hermes tools

只打开你确实需要的工具。

第 5 步：尝试文件和终端任务

例如：

读取当前项目的 README，总结项目用途。

查看 package.json，告诉我有哪些常用脚本。

第 6 步：尝试 Skills

hermes skills browse

先从已有 Skills 里选，不急着自己写。

第 7 步：再考虑 Gateway 和 Cron

只有当前面都稳定后，再接消息平台和定时任务。

十五、常见问题

1. Hermes 和 Claude Code / Codex / Cursor 有什么区别？

Cursor 更偏 IDE 内代码编辑，Claude Code / Codex 更偏代码任务执行。Hermes Agent 更强调长期运行、记忆、Skills、消息平台、工具集合和自动化。

可以简单理解：

IDE Agent：更适合写代码
Hermes Agent：更适合长期任务助手和自动化工作流

2. 必须用 Hermes 系列模型吗？

不必须。

Hermes Agent 支持多种模型 Provider。你可以用 OpenAI、Anthropic、OpenRouter、Qwen、DeepSeek、Gemini、本地 OpenAI-compatible endpoint 等。

它不是只能配 Nous 的模型。

3. 为什么要求长上下文模型？

Agent 需要在一个任务中处理：

• 系统提示词
• 工具说明
• 当前会话
• 文件内容
• 工具返回结果
• Memory
• Skills
• 多轮推理过程

上下文太短，很容易在多步任务中丢信息。

4. Windows 能不能用？

可以。官方 README 中提供了 Windows 原生 PowerShell 安装方式，也说明 Windows 安装会处理 uv、Python 3.11、Node.js、ripgrep、ffmpeg 和 Git Bash 等依赖。

5. 它会不会很占硬盘？

会产生本地目录和依赖缓存。Windows 原生安装主要关注：

%LOCALAPPDATA%\hermes

Linux / macOS 通常关注：

~/.hermes

如果要卸载或清理，需要重点检查这些目录。

6. 可以接 MCP 吗？

可以。官方文档中提供了 MCP Server 配置示例。Hermes 可以通过 MCP 扩展外部工具能力，例如 GitHub、数据库、内部系统、浏览器控制等。

十六、总结

Hermes Agent 的火，不只是因为它又是一个 AI Agent 项目，而是因为它把几个关键能力组合在了一起：

模型 Provider 可切换
工具系统可配置
Skills 可沉淀流程
Memory 可保存关键上下文
Gateway 可接入消息平台
Cron 可做定时自动化
MCP 可扩展外部工具
安全机制可分层控制

如果只把它当聊天工具，它的价值其实发挥不出来。更合理的定位是：

一个可以长期运行、逐步积累经验、能调用工具的个人自动化 Agent

但也正因为它能力很强，使用时更要克制：

先小范围试用
先打开少量工具
先保留人工审批
先限定工作目录
先验证每一步结果

AI Agent 的核心不是让模型“自由发挥”，而是让模型在明确权限、清晰工具和可审计流程下完成任务。Hermes Agent 值得关注，也值得谨慎上手。

参考资料

• Hermes Agent GitHub：https://github.com/NousResearch/hermes-agent
• Hermes Agent Quickstart：https://hermes-agent.nousresearch.com/docs/getting-started/quickstart
• Hermes Agent Architecture：https://hermes-agent.nousresearch.com/docs/developer-guide/architecture
• Hermes Agent Tools & Toolsets：https://hermes-agent.nousresearch.com/docs/user-guide/features/tools
• Hermes Agent Memory：https://hermes-agent.nousresearch.com/docs/user-guide/features/memory
• Hermes Agent Skills：https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
• Hermes Agent Security：https://hermes-agent.nousresearch.com/docs/user-guide/security