Hermes Agent:从安装、模型配置到 Skills / Memory / Tools 的实用上手指南 Hermes Agent从安装、模型配置到 Skills / Memory / Tools 的实用上手指南Hermes Agent 是 Nous Research 开源的自改进 AI Agent。它和普通聊天机器人最大的区别不是“能不能聊天”而是能否长期运行、使用工具、记住关键上下文、沉淀可复用技能并通过 CLI、桌面端和消息平台持续处理任务。摘要最近 GitHub 上的 Hermes Agent 关注度很高。它的项目描述是 “The agent that grows with you”核心卖点是自改进在任务执行过程中积累记忆、沉淀技能、调用工具、接入消息平台并支持长时间运行的自动化任务。本文不做空泛概念介绍而是从工程使用角度拆解 Hermes AgentHermes Agent 解决什么问题它和普通 ChatGPT / Claude 聊天窗口有什么区别如何在 Windows、macOS、Linux 上安装如何配置模型 Provider如何使用 CLI / TUI 开始第一轮任务Tools、Skills、Memory、Gateway、Cron 分别是什么为什么必须重视安全边界新手应该按什么顺序上手截至 2026-07-07GitHub 页面显示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 更像一个可以持续工作的任务助手。它可以运行在本地电脑VPSDocker 环境SSH 远程服务器部分云端沙箱环境也可以通过多种入口交互CLITUI桌面端TelegramDiscordSlackWhatsAppSignalEmail二、为什么它和普通聊天机器人不一样普通聊天窗口通常是这样的用户提问 ↓ 模型回答 ↓ 会话结束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 PortalOpenAIAnthropicOpenRouterGeminiQwenDeepSeekKimiHugging FaceOllama / 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 / WSL2curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bash安装完成后重新加载 shellsource~/.bashrc或者source~/.zshrc2. Windows PowerShell官方给出的 PowerShell 安装方式是iex(irmhttps://hermes-agent.nousresearch.com/install.ps1)如果你对安全比较敏感可以先把脚本内容下载下来检查再执行irmhttps://hermes-agent.nousresearch.com/install.ps1-OutFileinstall-hermes.ps1 notepad.\install-hermes.ps1 powershell-ExecutionPolicy Bypass-File.\install-hermes.ps1Windows 原生安装会放在%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 基本使用启动普通 CLIhermes启动 TUIhermes--tui建议第一次输入一个容易验证的任务查看当前目录告诉我这个目录下有哪些主要文件。或者总结当前项目结构并指出可能的入口文件。如果 Agent 能正确读取目录、调用工具、返回结果就说明基础环境可用。常用命令hermes doctor用于诊断配置问题。hermes--continue用于恢复最近一次会话。hermes tools用于配置可用工具。hermes update用于更新 Hermes Agent。八、Tools让 Agent 真正能做事Tools 是 Hermes Agent 的核心能力之一。官方文档中提到Hermes 的工具能力覆盖Web 搜索网页内容提取终端执行文件读取和编辑浏览器自动化图像理解和生成文本转语音任务规划代码执行子 Agent 委派MemorySession SearchCron 定时任务Home AssistantMCP Server 集成你可以通过hermes tools查看和配置工具。也可以在启动时指定工具集hermes chat--toolsetsweb,terminal这里要注意工具不是越多越好。工具越多Agent 能做的事情越多风险也越高。推荐配置策略阶段建议打开的工具初次体验file、safe代码项目分析file、terminal、search信息检索web自动化任务cron、messaging高阶集成MCP、browser、delegation九、Skills把经验沉淀成可复用流程Skills 是 Hermes Agent 非常值得关注的设计。普通 Prompt 是一次性的而 Skill 更像一个可复用的任务说明文件。官方文档中说Skill 是按需加载的知识文档用渐进披露减少 token 消耗。可以理解为Skill 任务说明 操作步骤 注意事项 可复用经验例如你可以有这些 Skillscode-review fastapi-deploy docker-debug weekly-report csdn-article-outline github-pr-workflowHermes 的 Skill 通常是一个SKILL.md文件存放在~/.hermes/skills/可以浏览 Skillshermes skills browse搜索 Skillshermes skills searchdocker安装某个 Skillhermes skillsinstallopenai/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 的区别是能力MemorySession Search内容精炼事实历史会话是否进入系统提示词是否按需搜索适合用途长期关键偏好查找过去某次讨论Memory 很有用但也有风险如果错误信息被写进记忆后面可能持续影响 Agent。所以建议新手打开记忆写入审批memory:write_approval:true如果 Skill 也要审批skills:write_approval:true十一、Gateway把 Agent 接到 Telegram、Discord、Slack 等平台Hermes Agent 不只支持命令行还可以通过 Gateway 接入消息平台。配置入口hermes gateway setup启动 Gatewayhermes 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:manualcron_mode:denymemory:write_approval:trueskills:write_approval:trueterminal:backend:docker如果暂时不用 Docker也至少把工作目录控制在一个专门目录里。十四、新手推荐上手路线不要试图一天内把所有功能都打开。推荐按下面顺序来第 1 步只跑通 CLIhermes测试请总结当前目录结构。第 2 步配置模型hermes model确认模型能正常对话。第 3 步诊断环境hermes doctor把明显配置错误先处理掉。第 4 步打开必要 Toolshermes tools只打开你确实需要的工具。第 5 步尝试文件和终端任务例如读取当前项目的 README总结项目用途。查看 package.json告诉我有哪些常用脚本。第 6 步尝试 Skillshermes 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 需要在一个任务中处理系统提示词工具说明当前会话文件内容工具返回结果MemorySkills多轮推理过程上下文太短很容易在多步任务中丢信息。4. Windows 能不能用可以。官方 README 中提供了 Windows 原生 PowerShell 安装方式也说明 Windows 安装会处理 uv、Python 3.11、Node.js、ripgrep、ffmpeg 和 Git Bash 等依赖。5. 它会不会很占硬盘会产生本地目录和依赖缓存。Windows 原生安装主要关注%LOCALAPPDATA%\hermesLinux / 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 GitHubhttps://github.com/NousResearch/hermes-agentHermes Agent Quickstarthttps://hermes-agent.nousresearch.com/docs/getting-started/quickstartHermes Agent Architecturehttps://hermes-agent.nousresearch.com/docs/developer-guide/architectureHermes Agent Tools Toolsetshttps://hermes-agent.nousresearch.com/docs/user-guide/features/toolsHermes Agent Memoryhttps://hermes-agent.nousresearch.com/docs/user-guide/features/memoryHermes Agent Skillshttps://hermes-agent.nousresearch.com/docs/user-guide/features/skillsHermes Agent Securityhttps://hermes-agent.nousresearch.com/docs/user-guide/security