版本信息基于 Hermes Agent 2026年6月最新版本 | 作者Nous Research | LicenseMIT定位自托管、有持久记忆、能自动构建技能的开源 AI 智能体目录快速入门认识 Hermes Agent基础使用日常操作指南核心机制学习闭环详解记忆系统从文件到辩证推理技能系统自动成长的核心引擎多平台网关一处部署处处可达架构深入从源码理解设计生态与集成MCP、Honcho 与 Nous Portal竞品对比Hermes vs OpenClaw vs Claude Code生产部署从开发到上线精通之路插件开发与贡献资源汇总一、快速入门认识 Hermes Agent1.1 它是什么Hermes Agent 是Nous Research于 2026 年 2 月发布的开源自主 AI 智能体。一句话概括它不是你 IDE 里的代码补全工具也不是套壳聊天机器人——它是一个住在你服务器上的、越用越聪明的私人 AI 助手。核心差异化能力能力说明持久记忆跨会话记住你的偏好、项目和环境不需要每次重新解释自动技能创建解决难题后自动写 SKILL.md保存解决方法下次直接复用技能自我改进技能在使用中不断优化越用越好多平台可达同时连接 Telegram、Discord、Slack、WhatsApp、CLI 等定时自动化内置 cron日报、备份、审计等定时任务无人值守执行18 模型提供商不锁定任何模型生态一条命令随时切换1.2 一分钟安装# Linux / macOS / WSL2curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bash# Windows (PowerShell)iex(irm https://hermes-agent.nousresearch.com/install.ps1)安装程序会自动处理uv 包管理器 → Python 3.11 → 克隆仓库 → 初始配置。无需 sudo无前置依赖。安装完成后source~/.bashrc# 或 source ~/.zshrchermes setup# 交互式配置向导选择模型、设置偏好hermes model# 选择 LLM 提供商和模型hermes# 开始第一次对话1.3 运行成本方案月成本说明本地运行¥0用自己的电脑适合尝鲜和开发$5 VPS~¥35轻量云服务器够用Serverless (Daytona/Modal)近乎 ¥0空闲时休眠按需唤醒Nous Portal 订阅¥50-150一站式模型 搜索 生图 TTS 浏览器二、基础使用日常操作指南2.1 CLI 核心命令hermes# 进入交互式对话hermes model# 切换模型hermes tools# 配置启用的工具hermes configset# 设置单个配置项hermes setup# 运行完整设置向导hermes update# 更新到最新版本hermes doctor# 诊断问题2.2 对话中的斜杠命令命令作用/new或/reset开始新会话/model [provider:model]切换模型/personality [name]切换人格/retry重试上次回答/undo撤销上次操作/compress压缩上下文释放 token 空间/usage查看 token 使用情况/insights查看会话洞察/skills浏览可用技能/skill-name直接调用某个技能2.3 模型切换Hermes 的模型切换极为简便一条命令搞定# 切换到不同提供商hermes model openai:gpt-4o hermes model anthropic:claude-sonnet-4-20250514 hermes model deepseek:deepseek-chat hermes model openrouter:google/gemini-2.5-pro-preview# 使用本地模型hermes model ollama:llama3支持的提供商18国际OpenAI、Anthropic、Google (via OpenRouter)、Meta (via OpenRouter)国内DeepSeek、Kimi/Moonshot、阿里云/Qwen、MiniMax、z.ai/GLM、小米 MiMo开放平台OpenRouter (200 模型)、Hugging Face、NVIDIA NIM本地Ollama、vLLM、任意 OpenAI 兼容端点一站式Nous Portal原生 OAuth300 模型2.4 上下文文件影响每次对话Hermes 在每次对话中会自动注入以下上下文文件你可以手动编辑它们来塑造 Agent 的行为文件作用位置SOUL.mdAgent 的性格和核心准则~/.hermes/MEMORY.md长期记忆跨会话保持~/.hermes/USER.md关于你的信息偏好、习惯~/.hermes/AGENTS.md/.hermes.md项目级上下文指令项目根目录三、核心机制学习闭环详解这是 Hermes 最与众不同的系统。它不只是「调用 API 然后回复」而是通过一个完整的学习循环让 Agent 越用越聪明。3.1 四层学习循环┌──────────────────────────────────────────────────────┐ │ Hermes 学习闭环 │ │ │ │ ┌─────────┐ ┌──────────┐ ┌───────────┐ │ │ │ 记忆管理 │───→│ 技能创建 │───→│ 技能改进 │ │ │ │ │ │ │ │ │ │ │ │ 持久化 │ │ 从经验 │ │ 使用中 │ │ │ │ 关键信息 │ │ 提取技能 │ │ 持续优化 │ │ │ └────┬────┘ └────┬─────┘ └─────┬─────┘ │ │ │ │ │ │ │ └──────────────┴────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────┐ │ │ │ 跨会话回溯 │ │ │ │ FTS5 LLM摘要 │ │ │ │ → 精准检索历史 │ │ │ └─────────────────┘ │ └──────────────────────────────────────────────────────┘3.2 各层详解第一层记忆管理Agent 主动管理MEMORY.md和USER.md接近上限时自动合并相似条目 → 删除过时信息 → 压缩多条为一条记忆硬上限约1300 tokensMEMORY.md ≈ 800t USER.md ≈ 500t精准少量记忆 模糊大量记忆第二层自动技能创建触发条件完成5 次以上工具调用的复杂任务后自动评估是否值得沉淀 → 写入SKILL.md技能内容包含步骤、踩坑记录、验证方法兼容 agentskills.io 开放标准可分享可移植第三层技能自我改进技能在被调用时自动评估效果发现更好的方法时更新技能内容实测数据使用一个月后同类任务的平均工具调用次数从25 次降至 8-10 次模型不变全靠经验积累第四层跨会话回溯底层SQLite FTS5 全文搜索引擎上层LLM 摘要索引结合 Honcho 辩证式用户建模见后文可以搜索所有历史对话中的关键信息3.3 自检机制每15 次工具调用后Agent 自动暂停自检回顾最近的工具使用模式识别可优化的重复操作触发技能创建/更新四、记忆系统从文件到辩证推理4.1 内置记忆系统Hermes 内置了三层记忆文件层级文件内容Agent 人格SOUL.md行为准则、风格偏好长期记忆MEMORY.md项目信息、决策记录、经验用户画像USER.md用户偏好、习惯、目标所有记忆存储在~/.hermes/目录下完全本地化零遥测。4.2 HonchoAI 原生记忆后端Honcho 是由Plastic Labs开发的记忆后端作为 Hermes 的 Memory Provider 插件集成。它在内置记忆基础上增加了辩证推理 (Dialectic Reasoning)不是简单的「记下来」而是思考你这个人每一轮对话后 → Honcho 分析交流内容 → 推导关于你偏好、习惯、目标的洞察 → 随着对话积累理解不断加深 → 超越你明确表述的内容双层上下文注入每轮对话中Honcho 组装两层上下文注入到系统 prompt基础层你是谁— 会话摘要、用户画像、AI 自我认知辩证层什么最重要— LLM 推理你对当前任务的需求和状态冷启动 vs 热启动状态策略冷启动通用查询「这个人是谁偏好、目标、工作方式」热启动会话级查询「结合当前讨论什么上下文最相关」安装配置hermes memory setup# 选择 honcho# 在 honcho.dev 获取 API KeyechoHONCHO_API_KEY***~/.hermes/.env关键配置参数参数默认值说明contextCadence1基础上下文刷新频率轮dialecticCadence2辩证推理频率轮推荐 1-5dialecticDepth1每次辩证的推理轮数1-3contextTokensnull上下文注入 token 预算recallModehybridhybrid / context / toolssessionStrategyper-directory会话与工作目录的映射策略观察模式预设行为directional默认完全互相观察双方向辩证推理unified共享池语义单一观察者五、技能系统自动成长的核心引擎5.1 技能是什么技能Skills是 Hermes 的过程记忆——把「做过的事」变成「可复用的方法」。每个技能是一个SKILL.md文件包含触发条件什么时候用这个技能执行步骤怎么做注意事项踩过的坑验证方法怎么确认做对了5.2 技能的三种来源来源说明例子内置技能40出厂自带始终可用MLOps、GitHub、图表、笔记自动创建Agent 完成任务后自动生成部署流程、数据处理模板社区安装从 agentskills.io 下载各行业专用技能5.3 技能生命周期使用 Hermes 完成复杂任务 │ ▼ 自动评估≥5 次工具调用触发 │ ▼ 沉淀经验 → 创建 SKILL.md │ ▼ 后续调用该技能 → 自动评估效果 │ ▼ 发现优化空间 → 自动更新技能 │ ▼ 技能越用越精准5.4 技能管理命令hermes skills# 查看已安装的技能hermes skillsinstallX# 安装技能hermes skillsenableX# 启用技能可按平台粒度hermes skills disable X# 禁用技能hermes skills hub# 浏览技能中心5.5 官方可选技能optional-skills/目录下的官方可选技能需显式安装高级文档处理专业数据分析多媒体生成更多场景专用技能…六、多平台网关一处部署处处可达6.1 支持的平台Hermes 通过单一gateway进程连接20 个消息平台类别平台国际 IMTelegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost国内 IM钉钉、飞书、企业微信、微信、QQ Bot传统Email、SMS智能家居HomeAssistant开发CLI、Webhook、API Server其他BlueBubbles、Yuanbao6.2 网关配置# 引导式连接各平台hermes gateway setup# 启动消息网关hermes gateway# 安装为 systemd 服务后台常驻hermes gatewayinstall6.3 跨平台连续性在 Telegram 开始对话 → 在终端继续 → 在 Discord 查看结果。所有平台共享同一个会话历史和记忆。6.4 安全机制机制说明DM 配对新用户需在 CLI 授权后才能通过消息平台交互命令审批危险操作需要用户确认白名单可配置允许的用户列表容器隔离Docker 后端提供沙箱执行工具粒度控制可按平台禁用特定工具七、架构深入从源码理解设计7.1 系统总览┌──────────────────────────────────────────────────────────────┐ │ 入口点 (Entry Points) │ │ CLI │ Gateway │ ACP (IDE) │ Cron │ Batch │ API │ └────────────────────────┬─────────────────────────────────────┘ │ ▼ ┌──────────────────────────────────────────────────────────────┐ │ AIAgent (run_agent.py) │ │ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ Prompt │ │ Provider │ │ Tool │ │ │ │ Builder │ │ Resolution │ │ Dispatch │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │ │ │ 3 种 API 模式chat_completions / codex_responses / │ │ anthropic_messages │ └──────────┬────────────────────────────────────┬──────────────┘ │ │ ▼ ▼ ┌──────────────────────┐ ┌──────────────────────────┐ │ Session Storage │ │ Tool Backends │ │ SQLite FTS5 │ │ Terminal (7 后端) │ │ hermes_state.py │ │ Browser (5 后端) │ └──────────────────────┘ │ Web / File / MCP ... │ └──────────────────────────┘7.2 目录结构hermes-agent/ ├── run_agent.py # AIAgent 核心对话循环 ├── cli.py # HermesCLI 交互式终端 UI ├── model_tools.py # 工具发现、schema 收集、分发 ├── toolsets.py # 工具分组与平台预设 ├── hermes_state.py # SQLite FTS5 会话数据库 ├── hermes_constants.py # 常量与路径 ├── batch_runner.py # 批量轨迹生成 ├── agent/ # Agent 内部模块 │ ├── prompt_builder.py # 系统 prompt 组装 │ ├── context_compressor.py # 有损摘要压缩 │ ├── prompt_caching.py # Anthropic prompt 缓存 │ ├── memory_manager.py # 记忆管理器编排 │ ├── memory_provider.py # 记忆提供者 ABC │ └── skill_commands.py # Skill 斜杠命令 ├── hermes_cli/ # CLI 子命令 ├── tools/ # 70 工具实现 ├── gateway/ # 消息平台网关20 适配器 ├── cron/ # 调度器 ├── skills/ # 内置技能40 ├── optional-skills/ # 官方可选技能 ├── plugins/ # 插件系统 └── tests/ # 3000 测试7.3 Agent 循环核心流程用户输入 │ ▼ prompt_builder.build_system_prompt() │ 来源SOUL.md MEMORY.md USER.md Skills 工具指引 ▼ runtime_provider.resolve() │ 确定 (api_mode, api_key, base_url) ▼ API 调用 → 响应 │ ├── 有 tool_calls │ └── model_tools.handle_function_call() → 执行 → 继续循环 │ ├── 需要压缩 │ └── context_compressor 有损摘要 │ └── 最终响应 → 显示 → 保存至 SessionDB7.4 设计原则原则含义Prompt 稳定性系统 prompt 在对话中途不变避免缓存失效可观测执行每次工具调用对用户可见CLI spinner / Gateway 状态更新可中断API 调用和工具执行可在中途被用户取消平台无关核心同一个 AIAgent 服务所有入口点松耦合可选子系统使用注册表模式无硬依赖Profile 隔离每个 profile 独立配置、记忆、会话、Gateway PID7.5 终端后端7 种后端适用场景Local直接在当前机器执行Docker容器化隔离执行SSH远程服务器执行DaytonaServerless 持久化空闲休眠按需唤醒ModalServerless几乎零成本空闲SingularityHPC 高性能计算环境实验性其他正在开发的后端7.6 会话持久化存储引擎SQLite FTS5 全文检索关键特性会话血缘追踪跨压缩的父/子关系按平台隔离原子写入与竞争处理核心文件hermes_state.py、gateway/session.py八、生态与集成MCP、Honcho 与 Nous Portal8.1 MCP 集成Hermes 支持通过Model Context Protocol (MCP)连接外部系统# MCP 工具由 tools/mcp_tool.py 驱动# 配置后即可在对话中调用任意 MCP 服务器提供的工具MCP 让 Hermes 的能力边界可以无限扩展——任何实现了 MCP 协议的服务都可以接入。8.2 Nous Portal一站式订阅不想为模型、搜索、生图、TTS、浏览器分别申请多个 API KeyNous Portal用一个订阅覆盖全部服务说明300 模型/model name随时切换网页搜索Firecrawl 集成图像生成FAL 集成文字转语音OpenAI TTS云浏览器Browser Use 云实例hermes setup--portal# 快速设置8.3 技能市场agentskills.io — 官方技能中心hermes-ai.net/skills — 社区技能导航hermesatlas.com — 中文社区资源站awesome-hermes-agent-zh — 中文资源合集8.4 社区桥接项目说明HermesClaw社区微信桥接企业微信回调官方内置适配器钉钉/飞书官方内置适配器九、竞品对比Hermes vs OpenClaw vs Claude Code9.1 定位差异产品一句话定位Claude Code坐在 IDE 里的顶级编码助手OpenClaw多渠道 AI 运营中枢生态最大Hermes Agent服务器上 7×24h 待命的自进化个人 Agent9.2 核心差异对比维度Claude CodeOpenClawHermes AgentGitHub Stars~140K247K27K记忆策略无持久记忆全量持久化向量检索有限记忆主动压缩自学习机制❌❌✅ 内置学习循环技能来源内置用户编写社区共建 13K自创经验生成LLM 提供商仅 Anthropic多家推荐自家18消息平台02220最低成本本地环境本地环境$5/月 VPSLicenseAPI 条款闭源/开源混合MIT9.3 选型建议选 Claude Code如果你核心需求是写代码、改代码、跑测试工作流在 IDE/终端内不需要跨平台追求最佳代码生成质量选 OpenClaw如果你需要多渠道运营同时管理多个平台团队使用需要共享 Agent 能力偏好大而全的生态要现成技能选 Hermes Agent如果你想要轻量、长期使用的个人 Agent不想被锁死在某个模型生态希望 Agent 越用越顺手自学习预算有限$5/月可跑对数据隐私有要求MIT 零遥测9.4 三者能否共存完全可以。三者不存在冲突Claude Code IDE 里的编码专家OpenClaw 多渠道运营中枢Hermes Agent 7×24h 私人助理十、生产部署从开发到上线10.1 VPS 部署# 最低配置1 核 CPU、1GB RAM、10GB 硬盘# 推荐2 核、2GB RAM# SSH 登录后一键安装curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bash# 配置hermes setup hermes model openrouter:google/gemini-2.5-flash# 选用性价比模型# 安装为系统服务hermes gatewayinstall10.2 Serverless 部署# Daytona 后端Serverless 持久化hermes configsetterminal.backend daytona# Modal 后端几乎零闲置成本hermes configsetterminal.backend modal特点空闲时自动休眠收到消息时按需唤醒——不使用时几乎零成本。10.3 Docker 部署# Docker 后端提供容器隔离执行hermes configsetterminal.backenddocker安全加固只读根目录、权限降级、PID 限制。10.4 Profile 多实例管理# 创建独立 profilehermes-pwork setup# 工作 profilehermes-ppersonal setup# 个人 profile# 每个 profile 拥有独立的# - 配置# - 记忆# - 会话历史# - Gateway PID# 可同时运行多个 profile10.5 安全最佳实践实践说明使用 Docker 后端隔离执行环境启用 DM 配对防止未授权用户通过消息平台访问配置命令审批危险操作需要确认按平台禁用工具减少攻击面定期备份 ~/.hermes/保护记忆和技能使用独立 profile工作和个人分离10.6 从 OpenClaw 迁移hermes claw migrate# 交互式迁移完整预设hermes claw migrate --dry-run# 预览将要迁移的内容hermes claw migrate--presetuser-data# 仅迁移用户数据hermes claw migrate--overwrite# 覆盖已有冲突可迁移内容SOUL.md、MEMORY.md、USER.md、技能、命令白名单、消息平台配置、API 密钥、TTS 资产、工作区指令等。十一、精通之路插件开发与贡献11.1 插件系统插件发现来源~/.hermes/plugins/— 用户级插件.hermes/plugins/— 项目级插件pip entry point — 通过 pip 安装的插件能力通过上下文 API 注册工具、hook 和 CLI 命令。11.2 自定义 Memory Provider实现agent/memory_provider.py中的抽象基类# 实现自定义记忆后端classMyMemoryProvider(MemoryProvider):defsearch(self,query:str)-List[MemoryEntry]:...defstore(self,entry:MemoryEntry)-None:...defget_context(self)-str:...放置到~/.hermes/plugins/memory/后即可在hermes memory setup中选择。11.3 开发环境搭建# 获取完整开发环境curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bashcd${HERMES_HOME:-$HOME/.hermes}/hermes-agent# 安装开发依赖uv pipinstall-e.[all,dev]# 运行测试3000 测试用例scripts/run_tests.sh11.4 添加新工具工具注册采用导入时自动注册模式# tools/my_tool.pyfromtools.registryimportregistryregistry.register(namemy_tool,description我的自定义工具)defmy_tool(param:str)-str:工具实现returnf处理结果:{param}将文件放入tools/目录即可自动发现无需手动维护导入列表。11.5 轨迹生成与模型训练Hermes 也是 AI 训练平台# 批量生成训练数据hermes batch run--configbatch_config.yaml# 输出 ShareGPT 格式# 可用于微调模型功能说明批量处理并行生成数千条工具调用轨迹支持自动检查点RL 训练集成 Atropos 框架11 种工具调用解析器轨迹导出ShareGPT 格式支持压缩至 token 预算范围内11.6 贡献指南Fork GitHub 仓库创建功能分支编写代码 测试提交 PR社区渠道DiscordGitHub IssuesGitHub Discussions十二、资源汇总官方资源资源链接官网hermes-agent.orgGitHubgithub.com/NousResearch/hermes-agent官方文档hermes-agent.nousresearch.com/docsNous Portalportal.nousresearch.com技能中心agentskills.io中文社区资源链接中文文档镜像hermes-doc.aigc.green中文社区hermesagent.org.cnAwesome Listhermesatlas.com技能导航hermes-ai.net/zh/skills微信桥接HermesClaw学习路径推荐第一阶段入门1-2 天 ├── 安装并运行 Hermes ├── 完成 3-5 次简单对话任务 ├── 了解 MEMORY.md / USER.md 的作用 └── 尝试 /skills 浏览内置技能 第二阶段进阶1 周 ├── 配置消息网关Telegram / 微信 ├── 设置定时任务日报 / 备份 ├── 安装 Honcho 记忆后端 ├── 观察 Agent 自动创建技能的流程 └── 尝试不同的模型提供商 第三阶段高级2 周 ├── 配置 Docker / Serverless 后端 ├── 编写自定义工具 ├── 开发 Memory Provider 插件 ├── 使用多 Profile 管理 └── 批量轨迹生成 第四阶段精通持续 ├── 贡献代码到主仓库 ├── 发布社区技能到 agentskills.io ├── 搭建团队共享的 Hermes 实例 ├── 自定义 Agent 循环逻辑 └── 利用 Hermes 进行模型训练研究附录关键概念速查概念一句话解释AIAgent核心对话引擎所有入口点的统一后端Skill可复用的过程记忆自动从经验中生成Memory Provider可插拔的记忆后端内置/Honcho/自定义Gateway多平台消息网关统一 20 个平台的接入Profile独立的 Agent 实例拥有自己的配置和记忆Terminal Backend命令执行的环境Local/Docker/SSH/Daytona/Modal 等Cron内置定时任务调度器MCPModel Context Protocol连接外部工具的开放协议Nous Portal一站式订阅服务模型搜索生图TTS浏览器HonchoAI 原生记忆后端提供辩证推理和深度用户建模FTS5SQLite 全文搜索引擎支撑会话历史检索Context Compressor有损摘要压缩器控制 token 消耗Hermes Agent 的核心哲学一个好的 Agent 不应该只是一问一答的工具而是一个会成长、会学习、会越来越懂你的长期伙伴。这也是它被社区称为「养马」的原因——你投入的时间越多它就越有价值。文档编制于 2026 年 6 月 30 日 | 基于 Hermes Agent 最新版本
Hermes Agent 从入门到精通
版本信息基于 Hermes Agent 2026年6月最新版本 | 作者Nous Research | LicenseMIT定位自托管、有持久记忆、能自动构建技能的开源 AI 智能体目录快速入门认识 Hermes Agent基础使用日常操作指南核心机制学习闭环详解记忆系统从文件到辩证推理技能系统自动成长的核心引擎多平台网关一处部署处处可达架构深入从源码理解设计生态与集成MCP、Honcho 与 Nous Portal竞品对比Hermes vs OpenClaw vs Claude Code生产部署从开发到上线精通之路插件开发与贡献资源汇总一、快速入门认识 Hermes Agent1.1 它是什么Hermes Agent 是Nous Research于 2026 年 2 月发布的开源自主 AI 智能体。一句话概括它不是你 IDE 里的代码补全工具也不是套壳聊天机器人——它是一个住在你服务器上的、越用越聪明的私人 AI 助手。核心差异化能力能力说明持久记忆跨会话记住你的偏好、项目和环境不需要每次重新解释自动技能创建解决难题后自动写 SKILL.md保存解决方法下次直接复用技能自我改进技能在使用中不断优化越用越好多平台可达同时连接 Telegram、Discord、Slack、WhatsApp、CLI 等定时自动化内置 cron日报、备份、审计等定时任务无人值守执行18 模型提供商不锁定任何模型生态一条命令随时切换1.2 一分钟安装# Linux / macOS / WSL2curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bash# Windows (PowerShell)iex(irm https://hermes-agent.nousresearch.com/install.ps1)安装程序会自动处理uv 包管理器 → Python 3.11 → 克隆仓库 → 初始配置。无需 sudo无前置依赖。安装完成后source~/.bashrc# 或 source ~/.zshrchermes setup# 交互式配置向导选择模型、设置偏好hermes model# 选择 LLM 提供商和模型hermes# 开始第一次对话1.3 运行成本方案月成本说明本地运行¥0用自己的电脑适合尝鲜和开发$5 VPS~¥35轻量云服务器够用Serverless (Daytona/Modal)近乎 ¥0空闲时休眠按需唤醒Nous Portal 订阅¥50-150一站式模型 搜索 生图 TTS 浏览器二、基础使用日常操作指南2.1 CLI 核心命令hermes# 进入交互式对话hermes model# 切换模型hermes tools# 配置启用的工具hermes configset# 设置单个配置项hermes setup# 运行完整设置向导hermes update# 更新到最新版本hermes doctor# 诊断问题2.2 对话中的斜杠命令命令作用/new或/reset开始新会话/model [provider:model]切换模型/personality [name]切换人格/retry重试上次回答/undo撤销上次操作/compress压缩上下文释放 token 空间/usage查看 token 使用情况/insights查看会话洞察/skills浏览可用技能/skill-name直接调用某个技能2.3 模型切换Hermes 的模型切换极为简便一条命令搞定# 切换到不同提供商hermes model openai:gpt-4o hermes model anthropic:claude-sonnet-4-20250514 hermes model deepseek:deepseek-chat hermes model openrouter:google/gemini-2.5-pro-preview# 使用本地模型hermes model ollama:llama3支持的提供商18国际OpenAI、Anthropic、Google (via OpenRouter)、Meta (via OpenRouter)国内DeepSeek、Kimi/Moonshot、阿里云/Qwen、MiniMax、z.ai/GLM、小米 MiMo开放平台OpenRouter (200 模型)、Hugging Face、NVIDIA NIM本地Ollama、vLLM、任意 OpenAI 兼容端点一站式Nous Portal原生 OAuth300 模型2.4 上下文文件影响每次对话Hermes 在每次对话中会自动注入以下上下文文件你可以手动编辑它们来塑造 Agent 的行为文件作用位置SOUL.mdAgent 的性格和核心准则~/.hermes/MEMORY.md长期记忆跨会话保持~/.hermes/USER.md关于你的信息偏好、习惯~/.hermes/AGENTS.md/.hermes.md项目级上下文指令项目根目录三、核心机制学习闭环详解这是 Hermes 最与众不同的系统。它不只是「调用 API 然后回复」而是通过一个完整的学习循环让 Agent 越用越聪明。3.1 四层学习循环┌──────────────────────────────────────────────────────┐ │ Hermes 学习闭环 │ │ │ │ ┌─────────┐ ┌──────────┐ ┌───────────┐ │ │ │ 记忆管理 │───→│ 技能创建 │───→│ 技能改进 │ │ │ │ │ │ │ │ │ │ │ │ 持久化 │ │ 从经验 │ │ 使用中 │ │ │ │ 关键信息 │ │ 提取技能 │ │ 持续优化 │ │ │ └────┬────┘ └────┬─────┘ └─────┬─────┘ │ │ │ │ │ │ │ └──────────────┴────────────────┘ │ │ │ │ │ ▼ │ │ ┌─────────────────┐ │ │ │ 跨会话回溯 │ │ │ │ FTS5 LLM摘要 │ │ │ │ → 精准检索历史 │ │ │ └─────────────────┘ │ └──────────────────────────────────────────────────────┘3.2 各层详解第一层记忆管理Agent 主动管理MEMORY.md和USER.md接近上限时自动合并相似条目 → 删除过时信息 → 压缩多条为一条记忆硬上限约1300 tokensMEMORY.md ≈ 800t USER.md ≈ 500t精准少量记忆 模糊大量记忆第二层自动技能创建触发条件完成5 次以上工具调用的复杂任务后自动评估是否值得沉淀 → 写入SKILL.md技能内容包含步骤、踩坑记录、验证方法兼容 agentskills.io 开放标准可分享可移植第三层技能自我改进技能在被调用时自动评估效果发现更好的方法时更新技能内容实测数据使用一个月后同类任务的平均工具调用次数从25 次降至 8-10 次模型不变全靠经验积累第四层跨会话回溯底层SQLite FTS5 全文搜索引擎上层LLM 摘要索引结合 Honcho 辩证式用户建模见后文可以搜索所有历史对话中的关键信息3.3 自检机制每15 次工具调用后Agent 自动暂停自检回顾最近的工具使用模式识别可优化的重复操作触发技能创建/更新四、记忆系统从文件到辩证推理4.1 内置记忆系统Hermes 内置了三层记忆文件层级文件内容Agent 人格SOUL.md行为准则、风格偏好长期记忆MEMORY.md项目信息、决策记录、经验用户画像USER.md用户偏好、习惯、目标所有记忆存储在~/.hermes/目录下完全本地化零遥测。4.2 HonchoAI 原生记忆后端Honcho 是由Plastic Labs开发的记忆后端作为 Hermes 的 Memory Provider 插件集成。它在内置记忆基础上增加了辩证推理 (Dialectic Reasoning)不是简单的「记下来」而是思考你这个人每一轮对话后 → Honcho 分析交流内容 → 推导关于你偏好、习惯、目标的洞察 → 随着对话积累理解不断加深 → 超越你明确表述的内容双层上下文注入每轮对话中Honcho 组装两层上下文注入到系统 prompt基础层你是谁— 会话摘要、用户画像、AI 自我认知辩证层什么最重要— LLM 推理你对当前任务的需求和状态冷启动 vs 热启动状态策略冷启动通用查询「这个人是谁偏好、目标、工作方式」热启动会话级查询「结合当前讨论什么上下文最相关」安装配置hermes memory setup# 选择 honcho# 在 honcho.dev 获取 API KeyechoHONCHO_API_KEY***~/.hermes/.env关键配置参数参数默认值说明contextCadence1基础上下文刷新频率轮dialecticCadence2辩证推理频率轮推荐 1-5dialecticDepth1每次辩证的推理轮数1-3contextTokensnull上下文注入 token 预算recallModehybridhybrid / context / toolssessionStrategyper-directory会话与工作目录的映射策略观察模式预设行为directional默认完全互相观察双方向辩证推理unified共享池语义单一观察者五、技能系统自动成长的核心引擎5.1 技能是什么技能Skills是 Hermes 的过程记忆——把「做过的事」变成「可复用的方法」。每个技能是一个SKILL.md文件包含触发条件什么时候用这个技能执行步骤怎么做注意事项踩过的坑验证方法怎么确认做对了5.2 技能的三种来源来源说明例子内置技能40出厂自带始终可用MLOps、GitHub、图表、笔记自动创建Agent 完成任务后自动生成部署流程、数据处理模板社区安装从 agentskills.io 下载各行业专用技能5.3 技能生命周期使用 Hermes 完成复杂任务 │ ▼ 自动评估≥5 次工具调用触发 │ ▼ 沉淀经验 → 创建 SKILL.md │ ▼ 后续调用该技能 → 自动评估效果 │ ▼ 发现优化空间 → 自动更新技能 │ ▼ 技能越用越精准5.4 技能管理命令hermes skills# 查看已安装的技能hermes skillsinstallX# 安装技能hermes skillsenableX# 启用技能可按平台粒度hermes skills disable X# 禁用技能hermes skills hub# 浏览技能中心5.5 官方可选技能optional-skills/目录下的官方可选技能需显式安装高级文档处理专业数据分析多媒体生成更多场景专用技能…六、多平台网关一处部署处处可达6.1 支持的平台Hermes 通过单一gateway进程连接20 个消息平台类别平台国际 IMTelegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost国内 IM钉钉、飞书、企业微信、微信、QQ Bot传统Email、SMS智能家居HomeAssistant开发CLI、Webhook、API Server其他BlueBubbles、Yuanbao6.2 网关配置# 引导式连接各平台hermes gateway setup# 启动消息网关hermes gateway# 安装为 systemd 服务后台常驻hermes gatewayinstall6.3 跨平台连续性在 Telegram 开始对话 → 在终端继续 → 在 Discord 查看结果。所有平台共享同一个会话历史和记忆。6.4 安全机制机制说明DM 配对新用户需在 CLI 授权后才能通过消息平台交互命令审批危险操作需要用户确认白名单可配置允许的用户列表容器隔离Docker 后端提供沙箱执行工具粒度控制可按平台禁用特定工具七、架构深入从源码理解设计7.1 系统总览┌──────────────────────────────────────────────────────────────┐ │ 入口点 (Entry Points) │ │ CLI │ Gateway │ ACP (IDE) │ Cron │ Batch │ API │ └────────────────────────┬─────────────────────────────────────┘ │ ▼ ┌──────────────────────────────────────────────────────────────┐ │ AIAgent (run_agent.py) │ │ │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ Prompt │ │ Provider │ │ Tool │ │ │ │ Builder │ │ Resolution │ │ Dispatch │ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │ │ │ 3 种 API 模式chat_completions / codex_responses / │ │ anthropic_messages │ └──────────┬────────────────────────────────────┬──────────────┘ │ │ ▼ ▼ ┌──────────────────────┐ ┌──────────────────────────┐ │ Session Storage │ │ Tool Backends │ │ SQLite FTS5 │ │ Terminal (7 后端) │ │ hermes_state.py │ │ Browser (5 后端) │ └──────────────────────┘ │ Web / File / MCP ... │ └──────────────────────────┘7.2 目录结构hermes-agent/ ├── run_agent.py # AIAgent 核心对话循环 ├── cli.py # HermesCLI 交互式终端 UI ├── model_tools.py # 工具发现、schema 收集、分发 ├── toolsets.py # 工具分组与平台预设 ├── hermes_state.py # SQLite FTS5 会话数据库 ├── hermes_constants.py # 常量与路径 ├── batch_runner.py # 批量轨迹生成 ├── agent/ # Agent 内部模块 │ ├── prompt_builder.py # 系统 prompt 组装 │ ├── context_compressor.py # 有损摘要压缩 │ ├── prompt_caching.py # Anthropic prompt 缓存 │ ├── memory_manager.py # 记忆管理器编排 │ ├── memory_provider.py # 记忆提供者 ABC │ └── skill_commands.py # Skill 斜杠命令 ├── hermes_cli/ # CLI 子命令 ├── tools/ # 70 工具实现 ├── gateway/ # 消息平台网关20 适配器 ├── cron/ # 调度器 ├── skills/ # 内置技能40 ├── optional-skills/ # 官方可选技能 ├── plugins/ # 插件系统 └── tests/ # 3000 测试7.3 Agent 循环核心流程用户输入 │ ▼ prompt_builder.build_system_prompt() │ 来源SOUL.md MEMORY.md USER.md Skills 工具指引 ▼ runtime_provider.resolve() │ 确定 (api_mode, api_key, base_url) ▼ API 调用 → 响应 │ ├── 有 tool_calls │ └── model_tools.handle_function_call() → 执行 → 继续循环 │ ├── 需要压缩 │ └── context_compressor 有损摘要 │ └── 最终响应 → 显示 → 保存至 SessionDB7.4 设计原则原则含义Prompt 稳定性系统 prompt 在对话中途不变避免缓存失效可观测执行每次工具调用对用户可见CLI spinner / Gateway 状态更新可中断API 调用和工具执行可在中途被用户取消平台无关核心同一个 AIAgent 服务所有入口点松耦合可选子系统使用注册表模式无硬依赖Profile 隔离每个 profile 独立配置、记忆、会话、Gateway PID7.5 终端后端7 种后端适用场景Local直接在当前机器执行Docker容器化隔离执行SSH远程服务器执行DaytonaServerless 持久化空闲休眠按需唤醒ModalServerless几乎零成本空闲SingularityHPC 高性能计算环境实验性其他正在开发的后端7.6 会话持久化存储引擎SQLite FTS5 全文检索关键特性会话血缘追踪跨压缩的父/子关系按平台隔离原子写入与竞争处理核心文件hermes_state.py、gateway/session.py八、生态与集成MCP、Honcho 与 Nous Portal8.1 MCP 集成Hermes 支持通过Model Context Protocol (MCP)连接外部系统# MCP 工具由 tools/mcp_tool.py 驱动# 配置后即可在对话中调用任意 MCP 服务器提供的工具MCP 让 Hermes 的能力边界可以无限扩展——任何实现了 MCP 协议的服务都可以接入。8.2 Nous Portal一站式订阅不想为模型、搜索、生图、TTS、浏览器分别申请多个 API KeyNous Portal用一个订阅覆盖全部服务说明300 模型/model name随时切换网页搜索Firecrawl 集成图像生成FAL 集成文字转语音OpenAI TTS云浏览器Browser Use 云实例hermes setup--portal# 快速设置8.3 技能市场agentskills.io — 官方技能中心hermes-ai.net/skills — 社区技能导航hermesatlas.com — 中文社区资源站awesome-hermes-agent-zh — 中文资源合集8.4 社区桥接项目说明HermesClaw社区微信桥接企业微信回调官方内置适配器钉钉/飞书官方内置适配器九、竞品对比Hermes vs OpenClaw vs Claude Code9.1 定位差异产品一句话定位Claude Code坐在 IDE 里的顶级编码助手OpenClaw多渠道 AI 运营中枢生态最大Hermes Agent服务器上 7×24h 待命的自进化个人 Agent9.2 核心差异对比维度Claude CodeOpenClawHermes AgentGitHub Stars~140K247K27K记忆策略无持久记忆全量持久化向量检索有限记忆主动压缩自学习机制❌❌✅ 内置学习循环技能来源内置用户编写社区共建 13K自创经验生成LLM 提供商仅 Anthropic多家推荐自家18消息平台02220最低成本本地环境本地环境$5/月 VPSLicenseAPI 条款闭源/开源混合MIT9.3 选型建议选 Claude Code如果你核心需求是写代码、改代码、跑测试工作流在 IDE/终端内不需要跨平台追求最佳代码生成质量选 OpenClaw如果你需要多渠道运营同时管理多个平台团队使用需要共享 Agent 能力偏好大而全的生态要现成技能选 Hermes Agent如果你想要轻量、长期使用的个人 Agent不想被锁死在某个模型生态希望 Agent 越用越顺手自学习预算有限$5/月可跑对数据隐私有要求MIT 零遥测9.4 三者能否共存完全可以。三者不存在冲突Claude Code IDE 里的编码专家OpenClaw 多渠道运营中枢Hermes Agent 7×24h 私人助理十、生产部署从开发到上线10.1 VPS 部署# 最低配置1 核 CPU、1GB RAM、10GB 硬盘# 推荐2 核、2GB RAM# SSH 登录后一键安装curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bash# 配置hermes setup hermes model openrouter:google/gemini-2.5-flash# 选用性价比模型# 安装为系统服务hermes gatewayinstall10.2 Serverless 部署# Daytona 后端Serverless 持久化hermes configsetterminal.backend daytona# Modal 后端几乎零闲置成本hermes configsetterminal.backend modal特点空闲时自动休眠收到消息时按需唤醒——不使用时几乎零成本。10.3 Docker 部署# Docker 后端提供容器隔离执行hermes configsetterminal.backenddocker安全加固只读根目录、权限降级、PID 限制。10.4 Profile 多实例管理# 创建独立 profilehermes-pwork setup# 工作 profilehermes-ppersonal setup# 个人 profile# 每个 profile 拥有独立的# - 配置# - 记忆# - 会话历史# - Gateway PID# 可同时运行多个 profile10.5 安全最佳实践实践说明使用 Docker 后端隔离执行环境启用 DM 配对防止未授权用户通过消息平台访问配置命令审批危险操作需要确认按平台禁用工具减少攻击面定期备份 ~/.hermes/保护记忆和技能使用独立 profile工作和个人分离10.6 从 OpenClaw 迁移hermes claw migrate# 交互式迁移完整预设hermes claw migrate --dry-run# 预览将要迁移的内容hermes claw migrate--presetuser-data# 仅迁移用户数据hermes claw migrate--overwrite# 覆盖已有冲突可迁移内容SOUL.md、MEMORY.md、USER.md、技能、命令白名单、消息平台配置、API 密钥、TTS 资产、工作区指令等。十一、精通之路插件开发与贡献11.1 插件系统插件发现来源~/.hermes/plugins/— 用户级插件.hermes/plugins/— 项目级插件pip entry point — 通过 pip 安装的插件能力通过上下文 API 注册工具、hook 和 CLI 命令。11.2 自定义 Memory Provider实现agent/memory_provider.py中的抽象基类# 实现自定义记忆后端classMyMemoryProvider(MemoryProvider):defsearch(self,query:str)-List[MemoryEntry]:...defstore(self,entry:MemoryEntry)-None:...defget_context(self)-str:...放置到~/.hermes/plugins/memory/后即可在hermes memory setup中选择。11.3 开发环境搭建# 获取完整开发环境curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bashcd${HERMES_HOME:-$HOME/.hermes}/hermes-agent# 安装开发依赖uv pipinstall-e.[all,dev]# 运行测试3000 测试用例scripts/run_tests.sh11.4 添加新工具工具注册采用导入时自动注册模式# tools/my_tool.pyfromtools.registryimportregistryregistry.register(namemy_tool,description我的自定义工具)defmy_tool(param:str)-str:工具实现returnf处理结果:{param}将文件放入tools/目录即可自动发现无需手动维护导入列表。11.5 轨迹生成与模型训练Hermes 也是 AI 训练平台# 批量生成训练数据hermes batch run--configbatch_config.yaml# 输出 ShareGPT 格式# 可用于微调模型功能说明批量处理并行生成数千条工具调用轨迹支持自动检查点RL 训练集成 Atropos 框架11 种工具调用解析器轨迹导出ShareGPT 格式支持压缩至 token 预算范围内11.6 贡献指南Fork GitHub 仓库创建功能分支编写代码 测试提交 PR社区渠道DiscordGitHub IssuesGitHub Discussions十二、资源汇总官方资源资源链接官网hermes-agent.orgGitHubgithub.com/NousResearch/hermes-agent官方文档hermes-agent.nousresearch.com/docsNous Portalportal.nousresearch.com技能中心agentskills.io中文社区资源链接中文文档镜像hermes-doc.aigc.green中文社区hermesagent.org.cnAwesome Listhermesatlas.com技能导航hermes-ai.net/zh/skills微信桥接HermesClaw学习路径推荐第一阶段入门1-2 天 ├── 安装并运行 Hermes ├── 完成 3-5 次简单对话任务 ├── 了解 MEMORY.md / USER.md 的作用 └── 尝试 /skills 浏览内置技能 第二阶段进阶1 周 ├── 配置消息网关Telegram / 微信 ├── 设置定时任务日报 / 备份 ├── 安装 Honcho 记忆后端 ├── 观察 Agent 自动创建技能的流程 └── 尝试不同的模型提供商 第三阶段高级2 周 ├── 配置 Docker / Serverless 后端 ├── 编写自定义工具 ├── 开发 Memory Provider 插件 ├── 使用多 Profile 管理 └── 批量轨迹生成 第四阶段精通持续 ├── 贡献代码到主仓库 ├── 发布社区技能到 agentskills.io ├── 搭建团队共享的 Hermes 实例 ├── 自定义 Agent 循环逻辑 └── 利用 Hermes 进行模型训练研究附录关键概念速查概念一句话解释AIAgent核心对话引擎所有入口点的统一后端Skill可复用的过程记忆自动从经验中生成Memory Provider可插拔的记忆后端内置/Honcho/自定义Gateway多平台消息网关统一 20 个平台的接入Profile独立的 Agent 实例拥有自己的配置和记忆Terminal Backend命令执行的环境Local/Docker/SSH/Daytona/Modal 等Cron内置定时任务调度器MCPModel Context Protocol连接外部工具的开放协议Nous Portal一站式订阅服务模型搜索生图TTS浏览器HonchoAI 原生记忆后端提供辩证推理和深度用户建模FTS5SQLite 全文搜索引擎支撑会话历史检索Context Compressor有损摘要压缩器控制 token 消耗Hermes Agent 的核心哲学一个好的 Agent 不应该只是一问一答的工具而是一个会成长、会学习、会越来越懂你的长期伙伴。这也是它被社区称为「养马」的原因——你投入的时间越多它就越有价值。文档编制于 2026 年 6 月 30 日 | 基于 Hermes Agent 最新版本
