Hermes Agent

2026-08-19，Hermes Agent 推送了 v0.20.4 版本。这不是一个普通的小版本修复，而是一次架构级升级： MCP 协议栈：1.28.1 → 2.0.0（Breaking Change） HTTP 客户端栈：httpx/httpcore 全面升级到 v2 2056 个新提交合并，核心包 hermes-agent 从 0.20.0 → 0.20.4 作为一个在生产环境跑了 14 个 cron、管理 87 篇博文、每天并行跑 4 个子代理写作的重度用户，我第一时间拉取、构建、验证、落地配置优化。本文记录完整实战过程，供同样在生产跑 Hermes 的同学参考。 一、核心变更清单 组件 旧版本 新版本 影响等级 hermes-agent 0.20.0 0.20.4 🔴 核心 MCP (Model Context Protocol) 1.28.1 2.0.0 🔴 Breaking mcp-types — 2.0.0 🟡 配套 httpx 0.28.1 2.7.0 🔴 重构 httpcore 1.0.9 2.7.0 🔴 重构 httpcore2 — 2.7.0 🟡 新增 idna 3.15 3.18 🟢 修复 mcp 1.28.1 2.0.0 🔴 核心 opentelemetry-api — 1.44.0 🟡 观测 truststore — 0.10.4 🟢 安全 pip — 26.2.1 🟢 工具 2056 个新提交的主要集中领域： ...

Hermes Agent 是一款本地优先、配置驱动、技能可插拔的 AI Agent 框架。它把“模型网关 + 工具执行引擎 + 技能系统 + 持久化记忆”全部跑在你自己的机器上，配一个 YAML 就能把 Telegram、终端、浏览器、MCP 服务器、Cloudflare Workers 全串起来。这篇文章把新手最容易卡的配置、技能、工具、自动化四大块拆开讲，配一张全景架构图帮你建立心智模型。 一、核心心智模型：五层架构 打开文章顶部的架构图（或在浏览器打开 /images/posts/hermes-architecture.html），你会看到五层： 层级 职责 关键词 UI Layer Telegram / Web UI / CLI 统一入口，同一会话多端同步 Gateway & Routing 模型路由、Fallback 链、Config/Profile/Session/Memory 管理 config.yaml 是唯一真理来源 Provider Layer NVIDIA / OpenRouter / Anthropic / Cloudflare AI / ZAI / Custom 统一 OpenAI 兼容接口，支持任意厂商 Tool Engine Terminal / File / Browser / Web Search / Skills / MCP 全部本地执行，沙箱隔离，支持后台+通知 Extensions Cron Jobs / Delegation / Platform Bridges / CF Workers / MCP Servers 定时、并行、跨平台、边缘计算 一句话心法：config.yaml 定义**“用什么模型、怎么路由、开什么工具、加什么技能”**，剩下的 Hermes 全自动帮你接线。 ...