---
title: "Hermes Agent 官方教程中文版"
description: "基于 Nous Research 官方 docs、llms.txt 和上游源码重写的 Hermes Agent 中文查询手册。"
verifiedAt: "2026-05-09"
---

官方教程中文版不是逐字翻译，而是把 Hermes 官方文档里的事实整理成「带工程判断的中文查询页」。遇到实现细节不确定时，以官方 docs、`llms.txt` 和上游源码为准。

> [!NOTE]
> **先给结论**：按「**安装与快速上手 → 配置 → 工具与终端后端 → 记忆 → 技能 → 消息网关**」的顺序查。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 段](https://hermes-agent.nousresearch.com/docs/user-guide/features/tools) 当前列表为准）。
- **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+ 平台一站接入。

能力范围大不等于应该同时启用。官方教程中文版默认按「**先可用，再扩展，再自动化**」的顺序组织——别让你还没跑通的功能在后台替你做事。

## 入门章节

<Cards>
  <Card title="安装 Hermes Agent" description="一行 curl 命令装到 Linux / macOS / WSL2 / Termux；同时讲清安装目录、PATH 和常见报错。" href="/docs/hermes/official/00-getting-started/installation" />
  <Card title="快速上手 Hermes Agent" description="装好之后 5 分钟内完成 provider（推理服务商）配置、第一次对话和 session（会话）恢复。" href="/docs/hermes/official/00-getting-started/quickstart" />
  <Card title="规划学习路径" description="按你接下来要做的事——本地 CLI / 消息机器人 / 长期助手 / 自动化 / 开发扩展——挑阅读顺序。" href="/docs/hermes/official/00-getting-started/learning-path" />
</Cards>

## 使用手册

<Cards>
  <Card title="配置 Hermes Agent" description="读懂 ~/.hermes/ 下 config.yaml、.env、auth.json、SOUL.md 各自管什么；以及 terminal backend 怎么切换。" href="/docs/hermes/official/01-user-guide/configuration" />
  <Card title="工具系统与终端后端" description="区分调用什么工具（toolsets）和在哪里执行（terminal backend），两者解耦才能控制风险。" href="/docs/hermes/official/01-user-guide/tools" />
  <Card title="记忆系统" description="MEMORY.md、USER.md、冻结快照、session_search、外部 memory provider 各自解决不同时间尺度的记忆问题。" href="/docs/hermes/official/01-user-guide/memory" />
  <Card title="技能系统" description="把流程沉淀成 skill 之前先看：渐进加载机制、Skills Hub 安全检查、外部 skill 的密钥与脚本风险。" href="/docs/hermes/official/01-user-guide/skills" />
  <Card title="消息网关与平台接入" description="把 Hermes 接到聊天平台前，先理解 Gateway 路由、allowlist 授权、DM 配对和 chat session 隔离。" href="/docs/hermes/official/01-user-guide/messaging" />
</Cards>

## 和原理篇的分工

官方教程中文版回答**「命令、配置和功能怎么用」**。原理篇回答**「为什么这样设计、什么时候不要用、风险在哪里」**。

如果你正在排障或查命令，先来这里。如果你还没建立整体认知，先读 [Hermes Agent 从原理到实战](/docs/hermes/understanding) ——花 30 分钟先把心智模型搭起来，比花 3 小时翻命令更省时间。

## 官方资料

- 官方文档首页：[https://hermes-agent.nousresearch.com/docs](https://hermes-agent.nousresearch.com/docs)
- 官方 `llms.txt`（机器可读全文索引）：[https://hermes-agent.nousresearch.com/docs/llms.txt](https://hermes-agent.nousresearch.com/docs/llms.txt)
- 上游源码：[https://github.com/NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent)
- 命令、参数、环境变量等高时效细节：[Reference 区](https://hermes-agent.nousresearch.com/docs/reference/cli-commands)

## 下一步

<Cards>
  <Card title="从安装开始" description="第一次使用 Hermes，先完成安装和基础 provider 配置——5 分钟跑通最小闭环。" href="/docs/hermes/official/00-getting-started/installation" />
  <Card title="看学习路径" description="已经装好 Hermes，但不知道下一步读什么——按目标场景选条路径再开始。" href="/docs/hermes/official/00-getting-started/learning-path" />
</Cards>
