Hermes Agent 是 Nous Research 开源的 AI Agent 框架。简单说,它是一个能在你的终端、消息平台(Telegram、飞书、Discord、Slack 等)和 IDE 里跑的自主执行代理。它不只是一个聊天机器人——它能调用工具、执行命令、读写文件、搜索网络、管理定时任务,而且跨会话有记忆。
核心差异化:Skill(技能)系统——解决过的问题可以沉淀为可复用的技能,越用越聪明持久记忆——跨会话记住你是谁、你的偏好、环境信息多平台网关——同一套 Agent 跑在 Telegram、Discord、Slack、飞书等 10+ 平台上模型无关——随时切换模型和提供商,不需要改配置Profile(配置文件)——多实例隔离,不同的工作场景用不同的 profile可扩展——插件、MCP 服务器、自定义工具、Webhook 触发、定时任务
这会引导你完成模型选择、终端配置、网关设置、工具集和 Agent 行为的配置。
第一次跑完后执行这个命令,检查依赖和配置是否完整, 会自动修复常见问题。路径作用~/.hermes/config.yaml主配置文件~/.hermes/.envAPI 密钥和敏感信息$HERMES_HOME/skills/已安装的技能~/.hermes/state.db会话存储(SQLite + FTS5 全文搜索)~/.hermes/logs/网关和错误日志
Hermes 目前有 107+ 个技能。以下是实际使用中最值得安装和使用的,按场景分类:技能用途推荐指数systematic-debugging四阶段根因调试法,遇到 bug 先看这个,避免盲目改代码⭐⭐⭐⭐⭐writing-plans写实现计划,把大任务拆成可执行的小步骤,存到 .hermes/plans/⭐⭐⭐⭐⭐github-pr-workflowGitHub PR 全流程:分支、提交、打开、CI、合并⭐⭐⭐⭐github-code-reviewPR 代码审查,支持 diff 和内联评论⭐⭐⭐⭐codebase-inspection用 pygount 分析代码库:行数、语言、比例⭐⭐⭐requesting-code-review提交前自动审查:安全扫描、质量门控、自动修复⭐⭐⭐⭐技能用途推荐指数humanizer去除 AI 写作痕迹,让文本读起来像人写的⭐⭐⭐⭐⭐tech-article-writing技术文章写作:对比文章、工具介绍、分析类内容⭐⭐⭐⭐⭐architecture-diagram暗色主题 SVG 架构/云/基础设施图⭐⭐⭐⭐baoyu-image-genAI 图片生成(支持 OpenAI、DashScope、Google 等多个后端)⭐⭐⭐⭐baoyu-slide-deck从内容生成专业 PPT 图片⭐⭐⭐⭐obsidianObsidian 笔记管理:读取、搜索、创建、编辑⭐⭐⭐⭐技能用途推荐指数tavily-searchTavily API 网络搜索,返回精炼结果和摘要⭐⭐⭐⭐⭐multi-search-engine17 个搜索引擎集成(8 国内 + 9 国际),无需 API Key⭐⭐⭐⭐arxivarXiv 论文搜索:关键词、作者、分类⭐⭐⭐⭐blogwatcher监控博客和 RSS/Atom 订阅源⭐⭐⭐tech-repo-research研究 GitHub 仓库并生成对比/概览文章⭐⭐⭐⭐youtube-contentYouTube 转录转摘要、Thread、博客⭐⭐⭐技能用途推荐指数hermes-agentHermes 自身配置、扩展、贡献的全套指南⭐⭐⭐⭐⭐self-improvement自我改进:捕获错误、纠正和新发现的工作流⭐⭐⭐⭐⭐openclaw-auto-updater定时自动更新 Hermes 和技能,带可靠的重试机制⭐⭐⭐⭐kanban-workerKanban 工作流指南,多 Agent 协作任务⭐⭐⭐webhook-subscriptionsWebhook 订阅:事件驱动的 Agent 运行⭐⭐⭐技能用途推荐指数spotifySpotify 播放、搜索、队列、播放列表管理⭐⭐⭐gif-searchTenor GIF 搜索/下载⭐⭐⭐songwriting-and-ai-music歌曲创作和 Suno AI 音乐提示词⭐⭐⭐imessagemacOS 上收发 iMessage/SMS⭐⭐apple-remindersApple 提醒事项管理⭐⭐
这是 Hermes 一个非常实用的功能——通过项目根目录的约定文件,让 Agent 每次自动加载你的项目规则和偏好。
Hermes 会自动发现并加载以下文件:文件名用途推荐内容AGENTS.md项目级指令“用 pytest,不要用 unittest”、“API 在 /api/v2”CLAUDE.md兼容 Claude Code 的指令代码规范、目录结构说明SOUL.mdAgent 人格和行为准则沟通风格、决策偏好、底线原则.cursorrules兼容 Cursor 的规则IDE 行为偏好.hermes.mdHermes 专属指令特定于 Hermes 的工作流配置
如果你发现自己在重复同样的指令——“用 tab 不用空格”、“我们跑 pytest”、“API 地址是 /api/v2”——把它们写进 AGENTS.md,Agent 每次会话自动读取,零额外成本。
示例 :
SOUL.md 定义 Agent 的"人格"——沟通风格、决策偏好、底线。
示例 :
在对话中用 引用文件、文件夹、git diff 和 URL,Hermes 会自动展开内容:
限制值单文件最大字符数20,000(约 7,000 tokens)头部截断比例70%尾部截断比例20%截断标记10%(显示字符数并建议使用文件工具)
超过 20,000 字符的文件会被自动截断,保留头尾关键信息。
最常用的几个:命令作用/new新建会话/model查看或切换模型/tools管理工具集/skills搜索、安装、管理技能/usage查看 token 使用量/config查看当前配置/insights使用分析/compress手动压缩上下文
工具集的开启/关闭用 命令:
注意: 工具集变更后需要 或新建会话才能生效。这是为了保护 prompt 缓存——会话中途改工具会打断缓存命中。
Hermes 支持 20+ 个提供商,切换非常方便:
推荐做法:日常用性价比高的模型(如 Claude Sonnet 4),复杂任务切到更强大的模型,简单查询用便宜的模型。
Hermes 的持久记忆是核心亮点之一。
Agent 会在对话中自动保存以下信息:用户画像:名字、角色、偏好、沟通风格环境信息:操作系统、已安装工具、项目结构工具特性:某个工具的坑、特殊用法约定和规范:项目约定、API quirks、工作流偏好
主动纠正——当 Agent 犯错时,直接说「记住,以后别这样」,它会把纠正存到记忆里环境发现——Agent 发现你的项目约定、目录结构等会自动记录,下次不用重复说偏好沉淀——沟通风格、代码风格、工具偏好等会被自动学习别存临时信息——任务进度、PR 号、session 状态这些不要存到记忆里,它们很快过期
在对话中使用 工具可以搜索过去的对话:发现模式: — 搜索主题滚动模式:传入 + — 读取某段对话的完整上下文浏览模式:不传参数 — 浏览最近的会话列表
这是 Hermes 解决上下文窗口问题的核心能力。很多 Agent 的做法是简单截断旧消息,但 Hermes 用的是结构化压缩。
Hermes 使用两层压缩机制:层级触发时机作用Agent 压缩层上下文窗口使用率达 50%理解对话结构,保留语义连贯性Gateway 安全网上下文窗口使用率达 85%防止溢出,兜底保护
两层故意错开——如果都设成 50%,每轮对话都会过早压缩。压缩,不截断——丢掉旧消息会丢失信息。Hermes 的压缩器理解对话结构,保留语义连贯性渐进式披露——Skills、工具、上下文文件都有元数据层,按需加载完整内容预算作为一等概念——迭代次数、token 数、时间,Agent 需要预算管理和压力警告保留叙事连续性——压缩后仍然保持故事线的完整
Hermes 利用 Anthropic prompt caching 来提升长对话的效率。当压缩触发时,缓存系统会:保留最近的真实用户消息压缩中间的工具调用历史重新注入初始上下文
这是 Hermes 最实用的功能之一。
日报生成:每天早上 9 点自动汇总昨天完成的工作监控告警:每 5 分钟检查磁盘/CPU/内存,超阈值发消息内容更新:定期更新 RSS 订阅源并生成摘要技能维护:定时检查和更新已安装的技能()链式任务:Job A 收集数据 → Job B 处理 → Job C 推送通知(通过 串联)
Profile 让你在同一台机器上运行多个完全独立的 Hermes 实例。每个实例有自己的:配置(config.yaml)技能(skills)记忆(memory)会话(sessions)API 密钥(.env)内容创作 profile——安装内容生成相关的 skills,连接飞书/微信公众号开发 profile——安装开发相关的 skills,连接 GitHub家庭自动化 profile——连接智能家居设备研究 profile——安装论文搜索、数据分析 skills
Hermes 可以连接 10+ 消息平台,让 Agent 随时在线。平台说明Telegram最成熟,推荐Discord支持 Bot 和 DMSlack企业场景WhatsApp需要第三方提供商Signal隐私优先飞书国内团队协作钉钉国内企业EmailIMAP/SMTPMatrix开源协议Home Assistant智能家居API ServerOpen WebUI 等
安装为系统服务——,这样重启后自动运行设置 Home Channel——在对话中用 设置主消息通道SSH 断线保护——如果通过 SSH 管理,开启 linger:WSL2 用户注意——需要在 中设置
开启后,Agent 在工具输出中看到 API Key、Token 等敏感信息会自动打码。
注意: 这个配置需要新会话才会生效,中途切换不生效——这是故意的,防止 LLM 自己改配置绕过保护。
通过 关闭不需要的工具集,比如在生产环境中关闭 和 ,只保留 和 。
这是 Hermes 最强大的高级用法之一——用看板系统把多个 Profile(独立 Agent 实例)组织成一个协作团队。
Hermes Kanban 是一个基于 SQLite 的持久化任务看板。你可以:创建任务卡片,分配给不同的 Profile(相当于不同角色的 Agent)设置任务依赖关系——子任务等父任务完成自动进入 ready 状态跟踪任务状态:todo → ready → running → done / blocked多个 Agent 并行工作,通过看板协调完整的审计日志,所有操作持久化
满足以下任一条件就用看板,否则用 或者直接回答:需要多个 specialist(研究员 + 工程师 + 审稿人)工作需要跨重启存活(长时间运行、重要任务)用户可能中途介入(human-in-the-loop)多个子任务可以并行执行需要审查 / 迭代循环审计追踪很重要
编排者的核心规则:只分解和派发,不自己干活。
任务分解示例:
Worker 的生命周期:Orient — 确认任务状态Work — 在工作空间内执行实际工作Heartbeat — 定期汇报进度(“epoch 12/50, loss 0.31”)Complete / Block — 完成或阻塞等待
好的完成报告:
代码类任务建议用 而不是直接 complete,把代码变更详情写到评论里,等人工审查后再 unblock。
Hermes 自带 Dashboard,提供以下能力:实时状态 — 所有任务的当前状态、执行进度Recovery 面板 — Worker 崩溃时的快速恢复操作:Reclaim — 立即中止运行中的 worker,重置为 readyReassign — 切换到另一个 Profile 重新执行Change profile model — 修改 Profile 的模型配置后重试告警标记 — 任务失败或异常时显示 ⚠ 标记审计追踪 — 所有操作记录持久化,方便排查
模式说明扇出 + 扇入N 个研究任务并行 → 1 个综合任务汇总并行实现 + 验证实现者做修改,同时验证者确认配置流水线规划者 → 实现者 → 审查者,每步依赖上一步同 Profile 队列多个任务分给同一个 Profile,串行执行积累经验Human-in-the-loop任何任务可以随时 block 等待人工输入不要编造 Profile 名称——Dispatcher 对不存在的 assignee 静默失败,任务永远卡在 ready不要把独立任务绑在一起——两个独立结果要拆成两张卡依赖关系别漏设——用 确保子任务不会在父任务完成前启动不要在对话中用 delegate_task 替代 kanban_create——delegate_task 是会话内的短推理,kanban_create 是跨会话的持久化协作
让 Agent 派生独立的子代理来并行工作:单任务:指定一个目标,子代理独立执行批量并行:最多 3 个子代理同时运行(可配置)角色区分:(叶子节点,不能再派生)vs (编排器,可以继续派生)适用场景:复杂的研究任务、代码审查、多文件重构
适用场景:需要 Agent 长时间自主工作的情况,比如搭建整个项目、跑 CI/CD 配置。
MCP 让 Hermes 可以接入外部的工具和服务,这是扩展能力的关键方式。
适合 CI/CD 管道触发、GitHub 事件通知、外部系统推送等场景。
长对话时自动压缩可以保持上下文不溢出,同时保留关键信息。
提问时一次性给足上下文
与其分三轮说明问题,不如一开始就把文件路径、错误信息、预期行为全写上。Agent 能直接解析 traceback,不用你解释格式。
让 Agent 用自己的工具
不要试图在对话中帮 Agent 读文件——直接让它用工具。你说"这个文件在 src/auth/auth.py",它会去读;你贴内容,它只能看到你选的那部分。
用 AGENTS.md 代替重复说明
如果你每次都在说"用 pytest"、“我们跑 black”、“API 在 /api/v2”——写进 AGENTS.md,零额外成本。
Skill 的渐进式加载
Skills 不是一次性加载全部内容。先通过 看到元数据,再 按需加载。这比把所有技能说明塞进 system prompt 省得多。
Skill 的自进化
Reddit 上一个 Hermes 资深用户的经验:每次做完一件事,让 Agent 把它保存为 skill。“一旦你成功走通一次,它就能变成可复用的 skill。之后这个能力就是你的了,不用每次重新教。”
每月审查 Skill 库
Agent 自己生成的 skill 存在 。定期看看:
低质量或过时的 skill 可以归档或删除,保持 skill 库干净。
本地模型也能用
Hermes 支持连接 Ollama、LM Studio 等本地模型。适合不需要联网、对隐私要求高的场景。
用 execute_code 压缩多步骤流程
工具可以把多步骤工具调用链条压缩成单次推理调用。比如"搜索 → 下载 → 分析 → 生成报告"可以写成一个 Python 脚本,一次推理搞定。
如果你打算让 Hermes 7×24 在线,跑在 VPS 上比本地机器靠谱得多。以下是主流做法:
方案 A:Docker 容器部署(推荐生产环境)
Hermes 提供官方 Docker 镜像,沙箱化终端后端,Agent 执行的代码不直接访问宿主机。适合企业部署。
方案 B:VPS 一键部署
部分 VPS 提供商(如 Hostinger)支持一键部署 Hermes Agent。选 Ubuntu 24.04 LTS,安装脚本自动拉取最新版本、创建虚拟环境、生成 starter config.yaml。
方案 C:systemd 服务(长期运行)
如果记忆使用 Redis 后端,建议:
用 UptimeRobot 等免费服务监控 Gateway:
以下是一份经过验证的推荐配置:
原因:Hermes 在会话启动时加载配置和工具集。
解决:对话内:输入 或 重新开始会话网关:CLI:退出后重新启动
必须启用 Message Content Intent:Discord Developer Portal → Bot → Privileged Gateway Intents → 开启 Message Content Intent。
需要订阅 事件。否则 Bot 会忽略公共频道的消息。
模式找不到后端。需要设置 或 ,或者显式配置:
注意:YOLO 模式不会关闭密钥脱敏,两者是独立的。
Hermes Agent 不是那种装完就丢的工具。它的 skill 系统、持久记忆、profile 隔离,这些东西用一段时间后才会真正显出价值——每次遇到新坑、解决新问题,agent 会把这些经验沉淀下来,下一次不用再走弯路。
几条实在的建议:用 profile 把工作场景隔开。内容创作、开发、研究各搞一个,别混在一起解决过一次的问题,保存为 skill。这个习惯越早养成越省事记忆系统开着就好,agent 会自己学你的偏好和环境,不用你主动喂cron 定时任务值得认真搞。日报、监控、维护、数据收集,这些放 cron 比手动靠谱得多安全配置别跳过。 + 就够用了模型随时能换,别死守一个。简单查询用便宜的,复杂任务上强的,成本差很多