Hermes Agent 官方教程中文版
基于 Nous Research 官方 docs、llms.txt 和上游源码重写的 Hermes Agent 中文查询手册。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| 官方教程 | official | 讲 Hermes 具体功能配置。 |
| 按问题查 | problem-first | 从问题反查章节。 |
| 事实基准 | baseline | 配置以官方为准。 |
不想读完?把下面这段提示词丢给 AI 帮你跑完——帮你按要解决的问题定位该读 Hermes 官方教程哪一章。
你是 Hermes 官方教程导航顾问。
【角色】
Hermes 官方教程导航顾问,按最小够用、安全优先的原则给可落地方案,每条结论都落到能照做的具体步骤或示例,不停留在「建议」「考虑一下」这类空泛表述。
【输入】
- 要解决的具体问题:___
- 用的场景:___
- 经验水平:___
- 紧迫程度:___
- 现状:___
【工作流程】
1. 把问题归类(入门 / 用户指南)
2. 定位对应章节
3. 给阅读顺序
4. 标出需核验的
5. 给落地下一步
【输出规范】
▌一、问题归类
▌二、对应章节
▌三、阅读顺序
▌四、需核验内容
【硬约束】
- 按问题精准定位不通读
- 易变信息以官方为准
- 贴合经验水平
- 不要替我臆测情况或编造不存在的功能,信息不全先问清
- 不确定的配置或接口一律以官方文档为准,禁止照搬过时写法官方教程中文版不是逐字翻译,而是把 Hermes 官方文档里的事实整理成「带工程判断的中文查询页」。遇到实现细节不确定时,以官方 docs、llms.txt 和上游源码为准。
先给结论:按「安装与快速上手 → 配置 → 工具与终端后端 → 记忆 → 技能 → 消息网关」的顺序查。Hermes 能力很多,但不要一次全开——配置自由度越大,权限边界越容易扩散。
能力范围
可以把 Hermes Agent 理解成一个长期运行的 agent runtime(代理运行时),它把以下七件事压在一个进程里:
- CLI / TUI(命令行 / 终端 UI):本机的对话入口;CLI 适合脚本化,TUI 适合带鼠标和富界面的交互式体验。
- Provider 与模型路由:决定调哪家模型、用哪种鉴权方式(OAuth / API key)、以及一家挂了用哪家 fallback(备用)顶上、credential pool(凭据池)怎么轮换。
- Toolsets(工具集):把工具按用途分组(web、file、terminal、browser、memory、cron、delegation 等),按需启用,避免一次给模型开太多权限。
- Terminal backends(终端后端):决定命令实际在哪里执行——local(本机)、Docker(容器)、SSH(远程主机)、Daytona、Modal、Singularity、Vercel Sandbox 共 7 种环境(按 官方 Tools 页 Backends 段 当前列表为准)。
- Memory / session_search(记忆与会话检索):长期事实记忆 + 当前会话内的滚动记忆 + 跨 session 的历史检索三件,分别解决不同时间尺度的「记得住」问题。
- Skills(技能):把可复用流程沉淀成 markdown 知识包,再绑定到 slash command(斜杠命令)触发;带渐进加载和外部 Skills Hub。
- Messaging Gateway(消息网关):把 Hermes 接到 Telegram、Discord、Slack、WhatsApp、Signal、Email、SMS、Matrix、Mattermost、Home Assistant、DingTalk(钉钉)、Feishu / Lark(飞书)、WeCom(企业微信)、Weixin(微信)、BlueBubbles(iMessage)、QQ、Yuanbao、Microsoft Teams 等 15+ 平台一站接入。
能力范围大不等于应该同时启用。官方教程中文版默认按「先可用,再扩展,再自动化」的顺序组织——别让你还没跑通的功能在后台替你做事。
入门章节
安装 Hermes Agent
一行 curl 命令装到 Linux / macOS / WSL2 / Termux;同时讲清安装目录、PATH 和常见报错。
快速上手 Hermes Agent
装好之后 5 分钟内完成 provider(推理服务商)配置、第一次对话和 session(会话)恢复。
规划学习路径
按你接下来要做的事——本地 CLI / 消息机器人 / 长期助手 / 自动化 / 开发扩展——挑阅读顺序。
使用手册
配置 Hermes Agent
读懂 ~/.hermes/ 下 config.yaml、.env、auth.json、SOUL.md 各自管什么;以及 terminal backend 怎么切换。
工具系统与终端后端
区分调用什么工具(toolsets)和在哪里执行(terminal backend),两者解耦才能控制风险。
记忆系统
MEMORY.md、USER.md、冻结快照、session_search、外部 memory provider 各自解决不同时间尺度的记忆问题。
技能系统
把流程沉淀成 skill 之前先看:渐进加载机制、Skills Hub 安全检查、外部 skill 的密钥与脚本风险。
消息网关与平台接入
把 Hermes 接到聊天平台前,先理解 Gateway 路由、allowlist 授权、DM 配对和 chat session 隔离。
和原理篇的分工
官方教程中文版回答**「命令、配置和功能怎么用」。原理篇回答「为什么这样设计、什么时候不要用、风险在哪里」**。
如果你正在排障或查命令,先来这里。如果你还没建立整体认知,先读 Hermes Agent 从原理到实战 ——花 30 分钟先把心智模型搭起来,比花 3 小时翻命令更省时间。
官方资料
- 官方文档首页:https://hermes-agent.nousresearch.com/docs
- 官方
llms.txt(机器可读全文索引):https://hermes-agent.nousresearch.com/docs/llms.txt - 上游源码:https://github.com/NousResearch/hermes-agent
- 命令、参数、环境变量等高时效细节:Reference 区