Hermes Agent 官方教程中文版
基于 Nous Research 官方 docs、llms.txt 和上游源码重写的 Hermes Agent 中文查询手册。
官方教程中文版不是逐字翻译,而是把 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 区