<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>架构 on 记录点滴 - 分享</title><link>https://www.iminling.com/tags/%E6%9E%B6%E6%9E%84/</link><description>Recent content in 架构 on 记录点滴 - 分享</description><generator>Hugo -- gohugo.io</generator><language>zh-cn</language><copyright>iminling.com</copyright><lastBuildDate>Thu, 19 Nov 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://www.iminling.com/tags/%E6%9E%B6%E6%9E%84/index.xml" rel="self" type="application/rss+xml"/><item><title>Hermes Agent 自托管架构总览：从部署到能力扩展的分层设计</title><link>https://www.iminling.com/ai/hermes/hermes-agent-architecture-overview/</link><pubDate>Thu, 19 Nov 2026 00:00:00 +0000</pubDate><guid>https://www.iminling.com/ai/hermes/hermes-agent-architecture-overview/</guid><description>&lt;img src="https://images.iminling.com/i/2026/11/19/1d4d42b6ab97d0d19a2591bcb284d39a.webp" alt="Featured image of post Hermes Agent 自托管架构总览：从部署到能力扩展的分层设计" /&gt;&lt;h2 id="写在前面"&gt;写在前面&#10;&lt;/h2&gt;&lt;p&gt;Hermes Agent 是 Nous Research 开源的通用 AI Agent。和 Claude Code、Codex 这类主要待在终端里的编程 CLI 不同，它更像一个常驻服务：挂在服务器上，通过飞书、Telegram、企业微信等聊天平台接收消息，按配置调用模型、工具和技能，再把结果送回聊天窗口。&lt;/p&gt;&#10;&lt;p&gt;我在一台内网服务器上跑了几个月 Hermes，配置一路改下来，已经从&amp;quot;能用&amp;quot;变成了一套有明确分层的系统。这个系列把它拆开讲清楚，本篇是总览：先建立整体模型，后续每篇再展开一层。&lt;/p&gt;&#10;&lt;p&gt;本文基于 Hermes Agent &lt;code&gt;v0.23.0&lt;/code&gt;（2026.9.24），使用官方 Docker 镜像部署。涉及账号、渠道 ID、模型网关地址的地方都用占位符替代。&lt;/p&gt;&#10;&lt;h2 id="整体模型"&gt;整体模型&#10;&lt;/h2&gt;&lt;p&gt;先看全貌。Hermes 在这套部署里可以分成六层：消息从最上面的接入层进来，经过角色层和能力层调用模型，记忆与状态贯穿全程，最底下的部署层承载所有进程和数据。&lt;/p&gt;&#10;&lt;pre class="mermaid" style="visibility:hidden"&gt;flowchart TB&#10; subgraph Entry["接入层 Gateway"]&#10; direction LR&#10; Chat[飞书 / Telegram / 企业微信] ~~~ API[api_server / webhook]&#10; end&#10;&#10; subgraph Role["角色层 Profiles"]&#10; Profiles[dev / product / tester / kb / home]&#10; end&#10;&#10; subgraph Agent["能力层"]&#10; direction LR&#10; Skills[Skills] ~~~ Plugins[Plugins / Hooks] ~~~ Cron[Cron]&#10; end&#10;&#10; subgraph Model["模型层"]&#10; direction LR&#10; Main[主模型 grok-4.7] ~~~ Aux[辅助模型 glm-5.3-flash]&#10; end&#10;&#10; subgraph State["记忆与状态层"]&#10; direction LR&#10; Mem[SOUL / MEMORY / USER] ~~~ DB[(state.db)]&#10; end&#10;&#10; subgraph Deploy["部署层"]&#10; direction LR&#10; Docker[Docker Compose + s6] ~~~ Data["数据卷 /opt/data"] ~~~ Dash[Dashboard]&#10; end&#10;&#10; Entry --&gt; Role --&gt; Agent --&gt; Model&#10; Agent &lt;--&gt; State&#10; Model ~~~ Deploy&#10; State ~~~ Deploy&lt;/pre&gt;&lt;p&gt;各层的分工可以用一张表概括：&lt;/p&gt;&#10;&lt;table&gt;&#10;&#9;&lt;thead&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;层&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;负责什么&lt;/th&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;th&gt;主要配置位置&lt;/th&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/thead&gt;&#10;&#9;&lt;tbody&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;部署层&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;进程守护、数据持久化、Dashboard&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;docker-compose.yaml&lt;/code&gt;、&lt;code&gt;/opt/data&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;模型层&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;主对话模型、辅助任务模型、多模型协作&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;config.yaml&lt;/code&gt; 的 &lt;code&gt;model&lt;/code&gt;、&lt;code&gt;auxiliary&lt;/code&gt;、&lt;code&gt;moa&lt;/code&gt;、&lt;code&gt;providers&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;接入层&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;聊天平台收发、展示策略、会话切换&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;config.yaml&lt;/code&gt; 的 &lt;code&gt;platforms&lt;/code&gt;、&lt;code&gt;display.platforms&lt;/code&gt;、&lt;code&gt;.env&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;角色层&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;按用途隔离模型、技能和记忆&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;profiles/&amp;lt;name&amp;gt;/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;能力层&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;技能、插件、定时任务&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;skills/&lt;/code&gt;、&lt;code&gt;plugins/&lt;/code&gt;、&lt;code&gt;cron/&lt;/code&gt;、&lt;code&gt;scripts/&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&#9;&#9;&lt;tr&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;记忆与状态层&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;人设、长期记忆、会话与任务状态&lt;/td&gt;&#10;&#9;&#9;&#9;&#9;&#9;&lt;td&gt;&lt;code&gt;SOUL.md&lt;/code&gt;、&lt;code&gt;memories/&lt;/code&gt;、&lt;code&gt;state.db&lt;/code&gt;&lt;/td&gt;&#10;&#9;&#9;&#9;&lt;/tr&gt;&#10;&#9;&lt;/tbody&gt;&#10;&lt;/table&gt;&#10;&lt;h2 id="关键组件"&gt;关键组件&#10;&lt;/h2&gt;&lt;h3 id="部署层一个容器一个数据目录"&gt;部署层：一个容器，一个数据目录&#10;&lt;/h3&gt;&lt;p&gt;整套服务只有一个 &lt;code&gt;hermes&lt;/code&gt; 容器，用 Docker Compose 管理：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt; 1&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 2&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 3&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 4&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 5&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 6&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 7&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 8&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 9&#10;&lt;/span&gt;&lt;span class="lnt"&gt;10&#10;&lt;/span&gt;&lt;span class="lnt"&gt;11&#10;&lt;/span&gt;&lt;span class="lnt"&gt;12&#10;&lt;/span&gt;&lt;span class="lnt"&gt;13&#10;&lt;/span&gt;&lt;span class="lnt"&gt;14&#10;&lt;/span&gt;&lt;span class="lnt"&gt;15&#10;&lt;/span&gt;&lt;span class="lnt"&gt;16&#10;&lt;/span&gt;&lt;span class="lnt"&gt;17&#10;&lt;/span&gt;&lt;span class="lnt"&gt;18&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;services&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;hermes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;image&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;nousresearch/hermes-agent:latest&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;container_name&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;hermes&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;restart&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;unless-stopped&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;network_mode&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;host&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;volumes&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;./data:/opt/data&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;/data/work:/data/work:ro&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;environment&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;TZ=Asia/Shanghai&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD=1&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_HOST=0.0.0.0&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_PORT=9119&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_BASIC_AUTH_USERNAME=&amp;lt;your-username&amp;gt;&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_BASIC_AUTH_PASSWORD=&amp;lt;your-password&amp;gt;&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;- &lt;span class="l"&gt;HERMES_DASHBOARD_BASIC_AUTH_SECRET=&amp;lt;random-secret&amp;gt;&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;command&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;gateway&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="s2"&gt;&amp;#34;run&amp;#34;&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;p&gt;几个值得注意的点：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;容器内的 &lt;code&gt;HERMES_HOME&lt;/code&gt; 是 &lt;code&gt;/opt/data&lt;/code&gt;。配置、密钥、技能、会话数据库全部落在宿主机的 &lt;code&gt;./data&lt;/code&gt; 里，升级镜像不会丢状态。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;command: [&amp;quot;gateway&amp;quot;, &amp;quot;run&amp;quot;]&lt;/code&gt; 让容器以网关模式常驻；容器内部由 s6 负责守护网关进程。&lt;/li&gt;&#10;&lt;li&gt;工作目录 &lt;code&gt;/data/work&lt;/code&gt; 以只读方式挂载，Agent 能读代码和资料，但不能直接改宿主机文件。&lt;/li&gt;&#10;&lt;li&gt;服务器只在内网，所以使用 &lt;code&gt;network_mode: host&lt;/code&gt;，Dashboard 直接监听 &lt;code&gt;9119&lt;/code&gt; 端口，只配了 Basic Auth。暴露到公网时不应照搬这套配置。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;我早期还自己写过一个 Dockerfile，用来在镜像里装 Chromium，后来发现官方镜像已经通过 &lt;code&gt;PLAYWRIGHT_BROWSERS_PATH&lt;/code&gt; 自带 Playwright 浏览器，这一步完全多余。部署篇会详细说明数据目录结构和这类踩坑点。&lt;/p&gt;&#10;&lt;h3 id="模型层主模型干活小模型打杂"&gt;模型层：主模型干活，小模型打杂&#10;&lt;/h3&gt;&lt;p&gt;模型层最重要的设计是&lt;strong&gt;按任务分配模型&lt;/strong&gt;。&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;主对话使用 &lt;code&gt;grok-4.7&lt;/code&gt;，推理强度设为 &lt;code&gt;high&lt;/code&gt;。&lt;/li&gt;&#10;&lt;li&gt;上下文压缩、审批判断、标题生成、技能整理（curator）、后台复盘这些辅助任务，统一交给更便宜、更快的 &lt;code&gt;glm-5.3-flash&lt;/code&gt;，并关闭推理。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt; 1&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 2&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 3&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 4&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 5&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 6&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 7&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 8&#10;&lt;/span&gt;&lt;span class="lnt"&gt; 9&#10;&lt;/span&gt;&lt;span class="lnt"&gt;10&#10;&lt;/span&gt;&lt;span class="lnt"&gt;11&#10;&lt;/span&gt;&lt;span class="lnt"&gt;12&#10;&lt;/span&gt;&lt;span class="lnt"&gt;13&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;default&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;grok-4.7&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;provider&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;custom:newapi-grok&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;auxiliary&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;compression&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;provider&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;custom:newapi-glm&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;glm-5.3-flash&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;reasoning_effort&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;none&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;title_generation&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;provider&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;custom:newapi-glm&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;model&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;glm-5.3-flash&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;reasoning_effort&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="l"&gt;none&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;p&gt;所有模型都通过一个自建的 NewAPI 网关接入，按协议拆成几个 named provider 声明，密钥只通过 &lt;code&gt;key_env&lt;/code&gt; 引用环境变量，不写进配置文件。此外还配置了 MoA（Mixture of Agents）：用 &lt;code&gt;/moa&lt;/code&gt; 标记某一轮时，先让几个不同厂商的模型给出参考意见，再由主模型汇总回答。模型篇会讲清楚这些取舍和成本。&lt;/p&gt;&#10;&lt;h3 id="接入层一个网关多个聊天平台"&gt;接入层：一个网关，多个聊天平台&#10;&lt;/h3&gt;&lt;p&gt;Gateway 是 Hermes 和外界的连接点。这套部署启用了：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;飞书：日常主要入口，也是 home channel&lt;/li&gt;&#10;&lt;li&gt;Telegram：个人移动端入口&lt;/li&gt;&#10;&lt;li&gt;企业微信、微信：分别给其他 Profile 使用&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;api_server&lt;/code&gt; 和 &lt;code&gt;webhook&lt;/code&gt;：供脚本或其他系统调用&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;不同平台的展示能力不一样，所以在 &lt;code&gt;display.platforms&lt;/code&gt; 中按平台单独调整，例如飞书和 Telegram 关闭中间过程消息，避免刷屏：&lt;/p&gt;&#10;&lt;div class="highlight"&gt;&lt;div class="chroma"&gt;&#10;&lt;table class="lntable"&gt;&lt;tr&gt;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code&gt;&lt;span class="lnt"&gt;1&#10;&lt;/span&gt;&lt;span class="lnt"&gt;2&#10;&lt;/span&gt;&lt;span class="lnt"&gt;3&#10;&lt;/span&gt;&lt;span class="lnt"&gt;4&#10;&lt;/span&gt;&lt;span class="lnt"&gt;5&#10;&lt;/span&gt;&lt;span class="lnt"&gt;6&#10;&lt;/span&gt;&lt;span class="lnt"&gt;7&#10;&lt;/span&gt;&lt;span class="lnt"&gt;8&#10;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&#10;&lt;td class="lntd"&gt;&#10;&lt;pre tabindex="0" class="chroma"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="nt"&gt;display&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;platforms&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;telegram&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;streaming&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;interim_assistant_messages&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;feishu&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;tool_progress&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span class="line"&gt;&lt;span class="cl"&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="nt"&gt;interim_assistant_messages&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="w"&gt; &lt;/span&gt;&lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="w"&gt;&#10;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&#10;&lt;/div&gt;&#10;&lt;/div&gt;&lt;h3 id="角色层用-profile-隔离用途"&gt;角色层：用 Profile 隔离用途&#10;&lt;/h3&gt;&lt;p&gt;一个 Agent 同时承担开发、产品、测试、知识库问答和家庭事务，技能和记忆很容易互相干扰。Hermes 的 Profile 正好解决这个问题：每个 Profile 有自己的配置、技能集合和记忆。&lt;/p&gt;&#10;&lt;p&gt;除了默认的 &lt;code&gt;default&lt;/code&gt;，这里按用途又建了五个 Profile：&lt;code&gt;dev&lt;/code&gt;、&lt;code&gt;product&lt;/code&gt;、&lt;code&gt;tester&lt;/code&gt;、&lt;code&gt;kb&lt;/code&gt;、&lt;code&gt;home&lt;/code&gt;。比如 &lt;code&gt;home&lt;/code&gt; 只挂了最基础的技能，&lt;code&gt;kb&lt;/code&gt; 只保留知识库问答相关的技能。&lt;/p&gt;&#10;&lt;p&gt;配合 &lt;code&gt;gateway.multiplex_profiles: true&lt;/code&gt;，同一个网关进程就能同时服务所有 Profile。路由方式很简单：每个 Profile 持有自己的机器人凭证，消息从哪个机器人进来，就交给哪个 Profile 处理。&lt;/p&gt;&#10;&lt;h3 id="能力层skillsplugins-和-cron"&gt;能力层：Skills、Plugins 和 Cron&#10;&lt;/h3&gt;&lt;p&gt;能力层是 Hermes 可塑性最强的部分：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;Skills&lt;/strong&gt;：以 &lt;code&gt;SKILL.md&lt;/code&gt; 为单位的能力包，按目录分类存放。内置技能很多，我禁用了大部分用不到的，减少提示词占用和误触发。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Plugins&lt;/strong&gt;：运行在网关进程里的 Python 扩展。我用了两个插件：一个社区插件在 &lt;code&gt;pre_gateway_dispatch&lt;/code&gt; 钩子里恢复按时间自动重置会话（上游在 &lt;code&gt;v2026.9.11&lt;/code&gt; 移除了这个能力），另一个是让 Hermes 自己写的本地补丁，让企业微信发送文件失败时回退到主动发送。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;Cron&lt;/strong&gt;：Hermes 内置的定时任务。除了定时让 Agent 执行提示词，也可以直接运行 &lt;code&gt;scripts/&lt;/code&gt; 下的脚本，比如每天检查宿主机磁盘占用并告警。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;p&gt;扩展篇会以这两个插件为例，讲 Hermes 插件的两种典型写法。&lt;/p&gt;&#10;&lt;h3 id="记忆与状态层让-agent-记住自己是谁"&gt;记忆与状态层：让 Agent 记住自己是谁&#10;&lt;/h3&gt;&lt;ul&gt;&#10;&lt;li&gt;&lt;code&gt;SOUL.md&lt;/code&gt;：Agent 的人设和说话风格，例如要求回答长度与问题分量匹配、不说客套话。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;memories/MEMORY.md&lt;/code&gt; 和 &lt;code&gt;memories/USER.md&lt;/code&gt;：长期记忆和用户画像，分别有 &lt;code&gt;2200&lt;/code&gt; 和 &lt;code&gt;1375&lt;/code&gt; 字符上限，逼着记忆保持精炼。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;state.db&lt;/code&gt;：会话、消息、全文检索等运行状态，启用了 WAL 模式。跑了几个月后已经涨到两百多 MB，需要关注清理和备份。&lt;/li&gt;&#10;&lt;li&gt;&lt;code&gt;session_reset&lt;/code&gt;：每天凌晨 4 点切换新会话，避免上下文无限增长（新版本需要插件配合才生效）。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="一条消息的完整路径"&gt;一条消息的完整路径&#10;&lt;/h2&gt;&lt;p&gt;把各层串起来，一条飞书消息大致经过这些步骤：&lt;/p&gt;&#10;&lt;pre class="mermaid" style="visibility:hidden"&gt;sequenceDiagram&#10; participant U as 用户（飞书）&#10; participant G as Gateway&#10; participant H as 插件钩子&#10; participant A as Agent（Profile）&#10; participant M as 主模型&#10; participant X as 辅助模型&#10;&#10; U-&gt;&gt;G: 发送消息&#10; G-&gt;&gt;H: pre_gateway_dispatch&#10; H--&gt;&gt;G: 必要时重置会话&#10; G-&gt;&gt;A: 路由到对应 Profile 的会话&#10; A-&gt;&gt;M: 携带 SOUL、记忆、技能提示调用模型&#10; M--&gt;&gt;A: 回复或工具调用&#10; A-&gt;&gt;A: 执行工具 / 技能，循环直到完成&#10; A-&gt;&gt;X: 上下文过长时压缩、生成标题&#10; A--&gt;&gt;G: 最终回复&#10; G--&gt;&gt;U: 按平台展示策略发送&lt;/pre&gt;&lt;h2 id="这套架构的边界"&gt;这套架构的边界&#10;&lt;/h2&gt;&lt;ul&gt;&#10;&lt;li&gt;&lt;strong&gt;前提是内网&lt;/strong&gt;：Dashboard 只有 Basic Auth，审批模式也是关闭的（&lt;code&gt;approvals.mode: 'off'&lt;/code&gt;）。这套配置建立在服务器不对外暴露、使用者都可信的前提下。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;单容器单点&lt;/strong&gt;：所有能力都在一个容器里，容器出问题，所有渠道一起失效。对个人和小团队够用，但要接受这个单点。&lt;/li&gt;&#10;&lt;li&gt;&lt;strong&gt;跟随 &lt;code&gt;latest&lt;/code&gt; 镜像&lt;/strong&gt;：升级方便，但上游行为变化会直接影响现有配置。会话重置能力被移除，就是一个真实例子。&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="系列规划"&gt;系列规划&#10;&lt;/h2&gt;&lt;p&gt;后续文章按层展开：&lt;/p&gt;&#10;&lt;ul&gt;&#10;&lt;li&gt;&lt;a class="link" href="https://www.iminling.com/ai/hermes/hermes-agent-docker-deployment/" &gt;部署篇&lt;/a&gt;：Docker Compose、s6 启动链、数据目录结构、Dashboard、升级与备份&lt;/li&gt;&#10;&lt;li&gt;&lt;a class="link" href="https://www.iminling.com/ai/hermes/hermes-agent-model-config/" &gt;模型篇&lt;/a&gt;：自定义 provider、主辅模型分工、上下文压缩与缓存、MoA&lt;/li&gt;&#10;&lt;li&gt;&lt;a class="link" href="https://www.iminling.com/ai/hermes/hermes-agent-gateway-profiles/" &gt;接入与 Profile 篇&lt;/a&gt;：多平台 Gateway、Profile 多路复用、会话划分与重置&lt;/li&gt;&#10;&lt;li&gt;&lt;a class="link" href="https://www.iminling.com/ai/hermes/hermes-agent-skills-plugins-cron/" &gt;扩展篇&lt;/a&gt;：Skills 管理、插件开发、Cron 脚本任务&lt;/li&gt;&#10;&lt;li&gt;&lt;a class="link" href="https://www.iminling.com/ai/hermes/hermes-agent-newapi-prompt-cache/" &gt;番外：提示词缓存排查&lt;/a&gt;：接入 New API 时 GPT、Grok、GLM、Claude 的缓存协议与逐层取证&lt;/li&gt;&#10;&lt;/ul&gt;&#10;&lt;h2 id="总结"&gt;总结&#10;&lt;/h2&gt;&lt;p&gt;Hermes 的配置项很多，按层来看就清晰了：部署层保证常驻和数据持久，模型层决定成本和能力，接入层和角色层决定谁在什么场景下用它，能力层和记忆层决定它能做什么、记得什么。改一个配置之前先想清楚它属于哪一层，就不容易越改越乱。&lt;/p&gt;&#10;</description></item></channel></rss>