Hermes Agent 超详细教程

大约 30 分钟

Hermes Agent 超详细教程

如果你把 Claude Code、Codex CLI、Gemini CLI 看成“会聊天的终端助手”，那 Hermes 更像是一个完整的 AI Agent 框架：它不只是聊天，还带会话保存、长期记忆、技能系统、工具集、Profiles、MCP、消息网关。

先给你最重要的结论

Hermes 不是“提示词模板小工具”，而是一个完整的终端 AI Agent。
接入你自己的中转站时，优先走官方推荐的 Custom endpoint 路线。
你这里要填的 Base URL 是：https://www.yuzhixiaolongxia.com/v1
API Key 是：你在平台控制台创建的令牌
Model 是：去模型广场复制你要用的模型 ID
不要再按旧教程写 OPENAI_BASE_URL / LLM_MODEL 这类旧变量当主配置。Hermes 官方文档已经把主配置口径迁到 hermes model 和 ~/.hermes/config.yaml

Windows 用户先看这个

Hermes 官方目前仍然把 Linux / macOS / WSL2 作为最稳妥的安装方式。
如果你是 Windows 小白，最推荐先装 WSL2，再在 Ubuntu 终端里装 Hermes。
Windows 原生 PowerShell 安装是官方的 Early Beta，不是第一推荐路线。

如果你是 Windows 小白，先走这条最稳路线

如果你现在用的是 Windows，而且你：

没装过 Linux
没装过 WSL2
不知道 Ubuntu 是什么
不知道 Claude CLI 和 Codex CLI 怎么装

那你最稳的路线不是“直接硬装 Hermes”，而是：

先在 Windows 里安装 WSL2
再安装 Ubuntu
在 Ubuntu 里先把终端环境弄正常
先装 Claude Code CLI
再装 Codex CLI
用 Claude 或 Codex 在 Ubuntu 里一步一步带你安装 Hermes
最后再用 hermes model 接入你的平台

这是我最推荐你的原因：

Hermes 官方就是推荐 Windows 用户优先走 WSL2
Claude / Codex 本身就很适合当“安装引导助手”
小白最怕自己一步错、步步错，用 Agent 带着做更稳

最短结论先记住

先执行 wsl --install
先装 Ubuntu
先装 Claude Code CLI
再装 Codex CLI
最后再装 Hermes

第零步：先搞懂 WSL2、Ubuntu、Claude CLI、Codex CLI 分别是什么

WSL2 是什么

WSL2 = Windows Subsystem for Linux 2

你可以把它简单理解成：

在 Windows 里跑一个真正的 Linux 环境
你不用重装系统
也不用单独开虚拟机
但你能拿到一个接近原生 Linux 的终端

Ubuntu 是什么

Ubuntu 是最常见、最适合新手的 Linux 发行版之一。

在 WSL2 里，最推荐装 Ubuntu，因为：

教程最多
遇到问题最好搜
Hermes 官方提到的 Linux 命令，大多直接适用

Claude CLI / Codex CLI 在这里扮演什么角色

你可以把它们理解成“会在终端里陪你干活的 AI 助手”。

你后面可以这样用：

我不会装 Hermes
我把提示词复制给 Claude / Codex
它一步一步让我执行命令
我把结果贴回去
它继续指导下一步

这对小白非常重要。

第一部分：在 Windows 里安装 WSL2

Hermes 官方的 WSL2 快速开始明确建议：

Windows 用户优先走 WSL2
在 WSL2 终端里安装和运行 Hermes

第一步：用管理员权限打开 PowerShell

操作方法：

点开始菜单
搜索 PowerShell
右键 Windows PowerShell 或 Windows Terminal
点 以管理员身份运行

第二步：执行 WSL 安装命令

在管理员 PowerShell 里输入：

wsl --install

这条命令非常重要。
如果你后面忘了整篇文档，只记一句也行：

Windows 用户想最稳装 Hermes，第一条命令就是 wsl --install。

这条命令通常会自动做几件事：

开启 WSL 组件
开启虚拟机平台组件
安装默认 Linux 发行版（通常是 Ubuntu）

第三步：重启电脑

如果系统提示你重启，必须重启。

第四步：第一次打开 Ubuntu

重启后：

点开始菜单
搜索 Ubuntu
打开它

第一次打开会出现初始化过程，几分钟都正常。

然后系统会让你设置：

Linux 用户名
Linux 密码

用户名和密码怎么理解

这个用户名和密码：

不是你的 Windows 账号
不是你的平台账号
只是 Ubuntu 这个 Linux 环境里的本地账号

建议用户名尽量简单，比如：

alex
dev
user

密码输的时候终端不会显示星号，这是 Linux 正常行为。

第五步：确认 WSL2 和 Ubuntu 正常

回到 Windows PowerShell，输入：

wsl -l -v

你希望看到类似：

Ubuntu    Running    2

这里最关键的是最后那个 2，代表你现在跑的是 WSL2。

第二部分：第一次进入 Ubuntu 后，先做基础更新

打开 Ubuntu 终端，先执行：

sudo apt update
sudo apt upgrade -y

这两条命令是干什么的

apt update：刷新软件列表
apt upgrade -y：把系统里已有的软件更新到较新版本

为什么先做这一步

因为你后面要装：

git
curl
Node.js 相关工具
Claude CLI / Codex CLI
Hermes

如果系统包太旧，后面经常会遇到奇怪问题。

第三部分：在 Ubuntu 里先准备基础命令

在 Ubuntu 终端里执行：

sudo apt install -y git curl unzip build-essential

这一步主要是补基础工具：

git：很多安装流程都需要
curl：拉取安装脚本
unzip：有些工具解压用
build-essential：一些 Node / Python 组件编译时要用

然后检查一下：

git --version
curl --version

只要有版本号就行。

第四部分：在 Ubuntu 里安装 Node.js 环境

因为 Claude Code 和 Codex CLI 都依赖 Node.js，所以你要先把 Node.js 装好。

最推荐的新手路线

如果你完全不懂，先用你站内现成环境文档：

环境检查

但为了让这篇文档自洽，我把最小路线也写在这里。

安装 Node.js

先执行：

sudo apt install -y nodejs npm

然后检查：

node -v
npm -v

版本不够怎么办

Hermes、Claude Code、Codex CLI 这类现代工具，最好使用比较新的 Node 版本。

如果你装完发现 node -v 太老，最稳的做法是：

回看你站内这篇：
- 环境检查
按那篇文档把 Node.js 升到更合适的版本

新手最简单判断

只要：

node -v 正常
npm -v 正常
后面 Claude / Codex 能装上

就先继续，不要一开始就陷进“版本完美主义”。

第五部分：在 Ubuntu 里安装 Claude Code CLI

你站内已经有现成的 Claude Code 手动配置文档：

Claude Code 手动配置

但为了让你在 Hermes 这篇里不断线，我把最小路线直接写出来。

安装命令

在 Ubuntu 里执行：

npm install -g @anthropic-ai/claude-code@latest

这一步就是“先装 Claude Code CLI”。

安装完成后检查：

claude --version

如果能看到版本号，说明 Claude CLI 装好了。

Claude Code 未来接你平台时要记住一件事

Claude Code 的 Base URL 是：

https://www.yuzhixiaolongxia.com

不带 /v1。

这点和 Hermes 不一样，别混了。

第六部分：在 Ubuntu 里安装 Codex CLI

你站内也有现成的 Codex 文档：

Codex CLI 手动配置

这里我同样给你最小路线。

安装命令

在 Ubuntu 里执行：

npm install -g @openai/codex

这一步就是“先装 Codex CLI”。

安装完成后检查：

codex --version

如果能看到版本号，说明 Codex CLI 装好了。

Codex 未来接你平台时要记住一件事

Codex CLI 的 Base URL 是：

https://www.yuzhixiaolongxia.com/v1

必须带 /v1。

第七部分：为什么我要你先装 Claude CLI 和 Codex CLI，再装 Hermes

这不是硬性要求，但对小白很有帮助。

原因有 4 个：

1. 你先把终端环境跑通了

只要 Claude / Codex 能装上，说明：

Node.js 没问题
npm 没问题
PATH 基本没问题
终端可用

2. 你后面有“安装引导助手”

你不会自己判断报错？没关系。
Claude / Codex 就是你在 Ubuntu 里的现场教练。

3. 你更不容易把 Hermes 配错

尤其是这些地方最容易错：

Base URL
Provider
Model ID
API Key

让 Claude / Codex 带着你做，出错率低很多。

4. 以后你本来就会同时用它们

Hermes 适合长期 Agent 工作流。
Claude / Codex 适合日常终端互动协助。

先把它们都装好，不亏。

第八部分：在 Ubuntu 里，直接让 Claude 带你装 Hermes

如果你已经装好了 Claude CLI，那么接下来最适合小白的做法是：

打开 Ubuntu
进入一个空目录
启动 Claude
把下面整段提示词粘进去

给 Claude 用的 Hermes 安装提示词

你现在是我的 Hermes 安装教练。

我的当前环境是：
- Windows 主机
- 已经装好 WSL2
- 我现在在 Ubuntu 终端里
- Claude Code CLI 已安装
- 我希望按照 Hermes 官方文档推荐路线来安装 Hermes

你的任务：
1. 带我一步一步安装 Hermes，不要一次性给很多命令。
2. 每一步先告诉我“为什么做这一步”，再给我一条命令。
3. 每执行完一步，你都要让我把终端输出贴给你，你再决定下一步。
4. 如果某一步报错，你先分析原因，再给修复命令。
5. 安装完成后，再带我执行 `hermes model` 做模型配置。
6. Hermes 的接入口径固定如下：
   - Provider：Custom endpoint
   - API base URL：https://www.yuzhixiaolongxia.com/v1
   - API key：我的平台令牌
   - Model name：我从模型广场复制的模型 ID
7. 配置完成后，再带我做一次最简单的验证聊天。
8. 不要默认我懂 Linux、懂 PATH、懂 shell。

现在先开始第一步。

第九部分：在 Ubuntu 里，直接让 Codex 带你装 Hermes

如果你更喜欢 Codex CLI，也可以走同样路线。

给 Codex 用的 Hermes 安装提示词

你现在是我的 Hermes 安装教练。

我的当前环境是：
- Windows 主机
- 已经装好 WSL2
- 我现在在 Ubuntu 终端里
- Codex CLI 已安装
- 我希望按照 Hermes 官方文档推荐路线来安装 Hermes

你的任务：
1. 一步一步带我安装 Hermes。
2. 一次只给我一个动作，不要一次给太多命令。
3. 每一步都先解释目的，再给命令。
4. 我会把终端输出贴给你，你根据实际输出继续指导。
5. 如果报错，请先判断是系统问题、依赖问题还是 Hermes 配置问题。
6. Hermes 配置时固定按下面填写：
   - Provider：Custom endpoint
   - API base URL：https://www.yuzhixiaolongxia.com/v1
   - API key：我的平台令牌
   - Model name：我从模型广场复制的模型 ID
7. 安装和配置完成后，带我完成首次聊天验证。
8. 不要假设我懂 Ubuntu 或命令行。

现在先告诉我第一步要执行什么。

第十部分：Claude 和 Codex 都没装？那你先这样做

如果你现在连 Claude CLI / Codex CLI 都没装好，建议顺序改成：

先看环境检查
再装 Claude Code
再装 Codex CLI
至少确认其中一个能正常启动
再回来安装 Hermes

第十一步：Hermes 官方为什么建议 WSL2

Hermes 官方的 WSL2 快速开始给出的核心意思是：

Hermes 的开发和测试主要围绕 Linux / macOS
Windows 用户最稳的路径是 WSL2
要在 WSL 里运行 hermes model、hermes tools

这背后的实际原因就是：

路径行为更像 Linux
进程模型更像 Linux
Tool Gateway 更稳
文件监视、嵌入终端、剪贴板桥接等行为更接近官方预期

所以你如果是小白，别和官方推荐路线对着干。
直接 WSL2 + Ubuntu，就是最省总时间的方案。

Hermes 到底是什么

很多人第一次看到 Hermes，会误以为它只是：

一个“多轮提示词框架”
一个“能写剧本的提示词工具”
一个“和 Claude Code 差不多的 CLI”

这些理解都不完全对。

Hermes 官方定位更接近：

一个终端 AI Agent
一个能长期保存状态的可持续工作助手
一个可以接工具、接浏览器、接消息平台、接外部 MCP 服务的Agent 框架

它的核心能力不是“你问一句，它答一句”，而是：

它有自己的会话系统
它会保存历史对话
它能维护长期记忆
它能根据任务加载技能
它能调用终端、文件、浏览器、搜索等工具
它能通过 MCP 接第三方工具服务器
它还能做消息机器人、定时任务、批处理

你可以把 Hermes 理解成什么

工具	更像什么	适合谁
Claude Code / Codex CLI	会聊天、会改代码的 CLI 助手	主要做代码开发的人
OpenCode	更轻量的开源代码助手	想用开源代码 CLI 的人
Hermes	带会话、记忆、技能、工具、Profiles、MCP 的完整 Agent	想把 AI 变成长期工作伙伴的人

一句话：

Hermes 不只是“让 AI 回答问题”，而是“让 AI 在一个长期可持续的工作环境里运行”。

这篇教程适合谁

如果你符合下面任意一条，这篇就适合你：

你是小白，从来没装过 Hermes
你会装 CLI，但看官方文档觉得信息太多、太散
你已经有平台 API Key，想接入 Hermes
你不懂 SOUL.md、AGENTS.md、MEMORY.md 分别干嘛
你不懂 Profiles、Skills、MCP 到底什么时候该用

先准备什么

正式开始前，你至少准备这几样：

1. 一个能用的终端环境

推荐顺序：

Linux
macOS
Windows + WSL2
Windows 原生 PowerShell（官方 Early Beta）

如果你是 Windows 用户，建议你这样理解：

想最稳：装 WSL2，然后在 Ubuntu 里继续本教程
想省事但可能踩坑：直接 PowerShell 装 Hermes

2. 一个平台令牌

去你自己的平台控制台创建 API Key。

注意：

Hermes 接你这个中转站时，本质上走的是 OpenAI 兼容 custom endpoint
你用什么模型，就要保证你的令牌有权限调那个模型
不要拿一个只能调某一类模型的令牌，去调用另一类模型

3. 一个你打算先测试的模型 ID

不要手打，直接去：

模型广场

复制模型 ID。

你可以先选一个自己最熟悉的模型做第一次测试，比如：

Claude 系列
GPT 系列
Gemini 系列

第一次跑通比“选最强模型”更重要。

第一步：安装 Hermes

不想自己折腾？直接把下面提示词复制给 Claude 或 Codex

如果你是小白，最省事的方法不是自己一点点试，而是把下面这段提示词直接发给 Claude 或 Codex，让它一步一步带你装：

你现在是我的 Hermes 安装助手。我的目标是从零开始装好 Hermes，并接入我的 API 中转站。

请严格按下面方式帮助我：
1. 先判断我当前系统更适合走 Linux / macOS / WSL2 / Windows PowerShell 哪条安装路线。
2. 每一步只给我一个命令，并先解释“这一步是干什么的”。
3. 每执行一步后，提醒我把终端输出贴给你，你再决定下一步。
4. 如果你发现我装错了路线，立刻叫停，不要让我继续。
5. 安装完成后，再带我配置 Hermes 的模型接入。
6. Hermes 的接入口径固定按下面填写：
   - Provider：Custom endpoint
   - Base URL：https://www.yuzhixiaolongxia.com/v1
   - API Key：我自己的平台令牌
   - Model：我从模型广场复制的模型 ID
7. 不要假设我懂命令行，不要一次性给我太多命令。
8. 如果某一步报错，请先分析报错，再给修复命令。

现在先开始第一步，先判断我当前系统应该走哪条安装路线。

这个提示词适合：

Claude Code
Codex CLI
ChatGPT
任何能持续多轮指导你的 AI 助手

Linux / macOS / WSL2 安装

官方推荐的安装命令是：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

装完以后，重新加载 shell：

source ~/.bashrc
# 或
source ~/.zshrc

然后检查版本：

hermes --version

如果能输出版本号，说明安装成功。

Windows 原生 PowerShell 安装

官方给了 Windows 原生 PowerShell 路线，但标注为 Early Beta：

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

如果你是新手，我还是建议你优先走 WSL2。

为什么我更建议 WSL2

因为 Hermes 后面常见的高级玩法都更偏 Linux 终端生态，比如：

本地 shell 命令
Python / Node 工具链
MCP 本地 stdio 服务
Docker / SSH / 本地脚本

这些在 WSL2 里整体体验更稳。

第二步：第一次配置，别急着手写文件

不想自己配？直接复制这段给 Claude 或 Codex

如果你已经装好了 Hermes，但不知道 hermes model 该怎么填，直接把下面这段发给助手：

你现在是我的 Hermes 配置助手。Hermes 已经装好了，我需要你带我一步一步完成模型配置。

要求：
1. 只按 Hermes 官方推荐路线来，不要用过时的环境变量方案当主配置。
2. 优先指导我使用 `hermes model` 完成配置。
3. 你要提醒我在出现选项时这样填写：
   - Provider：Custom endpoint (self-hosted / VLLM / etc.)
   - API base URL：https://www.yuzhixiaolongxia.com/v1
   - API key：我的平台令牌
   - Model name：我从模型广场复制的模型 ID
4. 每一步都先解释“为什么这样填”，再告诉我下一步输入什么。
5. 如果我贴回来的界面和你预期不一致，你要根据我的实际界面调整指导。
6. 配好以后，再带我做一次最简单的测试聊天验证。

现在先告诉我第一步该输入什么命令。

这段特别适合不会判断：

Provider 该选哪个
Base URL 要不要带 /v1
Model name 填什么

官方最推荐的方式不是一上来手写 config.yaml，而是：

hermes model

这是 Hermes 官方推荐的主模型配置入口。

它会负责：

让你选 provider
让你输入 API Key
让你设置 base URL
让你选模型
自动把配置写到正确位置

你在这里要怎么选

当 hermes model 打开后：

选择 Custom endpoint (self-hosted / VLLM / etc.)
输入 API base URL
输入 API key
输入 Model name

你这里具体该填什么

字段	你该填什么
Provider	`Custom endpoint (self-hosted / VLLM / etc.)`
API base URL	`https://www.yuzhixiaolongxia.com/v1`
API key	你的平台令牌
Model name	你从模型广场复制的模型 ID

为什么这里一定要带 `/v1`

因为 Hermes 官方对自定义接入的支持，重点是：

任何 OpenAI-compatible endpoint
条件是对方支持 /v1/chat/completions

你这个平台文档站里的 Hermes 接入，应当按这个口径走。
所以这里填的是：

https://www.yuzhixiaolongxia.com/v1

不是：

https://www.yuzhixiaolongxia.com

第三步：第一次跑通聊天

配置完之后，直接启动：

hermes

或者：

hermes chat

你看到交互界面后，先不要上来就让它写复杂任务。
第一次建议只做最简单验证：

你好，请用一句话介绍你自己。

如果 Hermes 正常回复，说明：

Hermes 本体已经能启动
你的 provider 配对成功
API Key 可用
base URL 可用
这个模型也能被正常调用

再做第二轮验证

接着试这些命令：

/help
/tools list
/skills

如果这些都正常，说明你的 Hermes 已经不是“只能调用模型”，而是进入“Agent 可工作”的状态了。

想让 Claude / Codex 带你验证？复制这段

你现在是我的 Hermes 验证助手。Hermes 已经安装并配置完成，请带我一步一步验证它是否真的能工作。

要求：
1. 先让我执行最简单的命令，确认 Hermes 能启动。
2. 再让我执行一次最简单的聊天测试。
3. 再让我验证 tools、skills、sessions 这些关键功能是否可用。
4. 每一步都只给我一个动作，等我把结果贴给你后再继续。
5. 如果某一步失败，请帮我判断是安装问题、配置问题、模型问题还是权限问题。
6. 验证通过后，请最后帮我总结“现在 Hermes 已经具备哪些能力，还缺哪些高级能力没配置”。

现在先开始第一步验证。

这段很适合“小白不知道什么叫验证成功”的场景。

第四步：理解 Hermes 的本地目录

Hermes 官方文档明确说，所有配置基本都放在：

~/.hermes/

目录结构大致是这样：

~/.hermes/
├── config.yaml     # 普通配置：模型、终端、压缩、工具等
├── .env            # API Key、密钥、令牌
├── auth.json       # OAuth provider 凭据
├── SOUL.md         # 全局人格 / 身份
├── memories/       # MEMORY.md、USER.md
├── skills/         # 技能目录
├── cron/           # 定时任务
├── sessions/       # 网关会话
└── logs/           # 日志

小白怎么理解这些文件

`config.yaml`

放普通配置：

默认模型
terminal backend
toolsets
memory 限额
MCP 配置
Profiles 相关配置

`.env`

放敏感信息：

API Key
各类外部服务密钥
网关 token

`SOUL.md`

这是 Hermes 的全局人格文件。

它决定：

Hermes 说话像谁
语气是冷静还是热情
是否简洁
是否喜欢反驳错误前提

`memories/`

放长期记忆：

MEMORY.md
USER.md

`skills/`

放技能。
Hermes 的技能本质上是“按需加载的知识/流程文件”。

`sessions/` + `state.db`

这些是 Hermes 的会话系统基础。

state.db 里存结构化会话数据
sessions/ 里存会话转储

第五步：先学会 6 个最常用命令

如果你刚装好 Hermes，不要先学 50 个命令。
先记住下面 6 个就够了。

1. `hermes`

启动一个交互式会话：

hermes

2. `hermes model`

配置 provider、模型、custom endpoint：

hermes model

3. `hermes doctor`

排查问题：

hermes doctor

4. `hermes sessions list`

看历史会话：

hermes sessions list

5. `hermes --continue`

继续上一次会话：

hermes --continue
# 或
hermes -c

6. `hermes tools`

看和配工具：

hermes tools

第六步：Hermes 跟普通聊天 CLI 最大不同是什么

答案是：会话系统。

Hermes 官方文档明确说，每次对话都会自动保存成一个 session。

这意味着：

你不用每次重新开题
你可以续上一次的上下文
你可以搜过去讨论过的内容
你可以给会话起名字

最常用的会话命令

继续最近一次会话

hermes --continue
hermes -c

看会话列表

hermes sessions list

给会话起标题

在聊天里输入：

/title 我的 Hermes 入门测试

这样你后面更容易在 sessions list 里找到它。

Hermes 把会话存在哪里

官方文档给出的关键位置：

SQLite 数据库：~/.hermes/state.db
网关会话目录：~/.hermes/sessions/

为什么这个很重要

因为 Hermes 后面的记忆、session_search、恢复上下文，都是建立在这个基础上的。

第七步：理解“主模型”和“辅助模型”

Hermes 官方文档现在明确区分两类模型槽位：

主模型（Main model）

这是你主要聊天时真正“思考”的模型。

每次：

你发消息
它决定要不要调工具
它组织最终回复

都靠这个主模型。

辅助模型（Auxiliary models）

这是 Hermes 用来做一些“边任务”的模型，比如：

上下文压缩
图片分析
网页摘要
session_search 结果总结
批准/拒绝高风险命令
MCP 工具路由
会话自动标题

新手建议

如果你是第一次接 Hermes：

不要一上来就改一堆辅助模型
先只把主模型跑通
让 Hermes 先稳定聊天、稳定用工具

等你熟悉以后，再研究：

哪些辅助任务可以用便宜模型
哪些任务需要更快的模型

第八步：Hermes 为什么比普通 CLI 更像 Agent

因为它有 Tools + Toolsets。

Tool 是什么

Tool 就是 Hermes 能做的实际动作，比如：

读文件
写文件
搜文件
跑终端命令
网页搜索
网页抽取
浏览器操作
记忆读写
查历史 session

Toolset 是什么

Toolset 是一组工具的打包。

官方文档把 Toolset 分成三类：

Core：单类工具
Composite：多个工具组合
Platform：某个平台默认整套工具配置

对新手最重要的一点

默认 CLI 场景通常已经带 hermes-cli 这套默认工具配置。
也就是说，大部分情况下你不用手工一把一把开工具。

什么时候你才需要管 Toolsets

比如你想：

只给 Hermes 读网页，不给它写文件
只给 Hermes 终端和文件，不给浏览器
给它接一个 MCP server 后只开那部分工具

这时候再研究：

hermes chat --toolsets "web,terminal,file"

或：

hermes tools

一个很适合小白的安全用法

如果你怕 Hermes 权限太大，可以优先用偏保守的思路：

先用默认配置做简单聊天
真要做高风险操作前，先看 /tools list
不放心就限制 toolsets

第九步：技能（Skills）是什么

这是很多新手最容易误会的一点。

技能不是插件商店图标

Hermes 的技能，本质上是：

按需加载的知识文件
按需加载的工作流说明
按需加载的“怎么做这件事”的标准化经验

技能有什么用

比如你想让 Hermes：

帮你走 GitHub PR 流程
帮你做 Docker 运维
帮你搜论文
帮你做某种固定写作格式

它不一定要靠写 Python 插件。
很多时候，一个 Skill 就够了。

怎么看技能

hermes skills list

或者在会话里：

/skills

怎么搜索技能

/skills search docker

怎么直接用技能

例如：

/github-pr-workflow 帮我梳理一下开 PR 的标准步骤

小白先怎么理解

你可以把 Skill 理解成：

“给 Hermes 的专题小教材”
“一份可复用的任务说明书”

第十步：记忆（Memory）到底怎么理解

Hermes 官方文档的记忆分两层：

1. 内建持久记忆

主要是两份文件：

MEMORY.md
USER.md

它们保存在：

~/.hermes/memories/

大概可以这样理解：

`MEMORY.md`

偏“Agent 自己该记住的长期事实”，比如：

你常用的项目习惯
某个项目的长期约定
某些环境事实

`USER.md`

偏“这个用户长期偏好”，比如：

你更喜欢简洁还是详细
你偏爱什么风格
你总是先要结论还是先要过程

2. 会话搜索（session_search）

除了记忆文件，Hermes 还能搜索过去的会话。

官方文档说明：

所有历史会话都在 SQLite 里
session_search 会基于 FTS5 做全文搜索
然后再用模型把相关历史会话总结出来

这比“硬把所有历史都塞进 prompt”更稳。

小白建议

刚开始先别执着研究“怎么精细调 memory”。
你先知道 Hermes 有两种长期记忆来源就够了：

明确写进 MEMORY.md / USER.md
过去对话可被 session_search 找回

第十一步：`SOUL.md`、`AGENTS.md`、`.hermes.md` 有什么区别

这是 Hermes 官方文档里非常重要的一块。

`SOUL.md`

它是全局人格文件。

位置：

~/.hermes/SOUL.md

它控制的是：

Hermes 是谁
Hermes 说话什么风格
Hermes 默认态度是什么

适合写：

语气
风格
表达偏好
不要做什么风格动作

不适合写：

项目路径
仓库规范
某个项目的端口号

`AGENTS.md`

这是项目级说明。

适合写：

项目结构
代码规范
命令怎么跑
哪些目录不能乱动
发布流程

`.hermes.md` / `HERMES.md`

这也是项目级说明，而且优先级更高。

官方优先级大致是：

.hermes.md → AGENTS.md → CLAUDE.md → .cursorrules

小白最简单的记忆法

跟人格有关：写 SOUL.md
跟具体项目有关：写 AGENTS.md

第十二步：Profiles 是什么，为什么你以后大概率会用到

Hermes 官方有一个非常实用的能力：Profiles。

它解决什么问题

你可能想同时有几个不同的 Hermes：

一个专门写代码
一个专门做研究
一个专门做个人助理

如果都混在一个 ~/.hermes/ 里，会出现：

模型配置混在一起
API Key 混在一起
记忆混在一起
sessions 混在一起

Profiles 就是把它们隔开。

一句话理解

一个 Profile = 一个独立 Hermes 家目录。

每个 Profile 都有自己的：

config.yaml
.env
SOUL.md
memory
sessions
skills
gateway 状态

怎么创建

hermes profile create coder

然后：

coder setup
coder chat

这里的 coder 就像一个新的 Hermes 命令。

新手什么时候需要 Profiles

满足任意一条就建议用：

你想把“工作”和“个人”分开
你想让不同 Hermes 用不同 API Key
你想让一个 Hermes 专门面向代码、另一个专门做写作

第十三步：MCP 是什么

如果你看到官方文档里的 MCP，不要害怕。

最简单解释

MCP = 让 Hermes 接外部工具服务器的协议

比如：

GitHub
文件系统
数据库
内部 API
浏览器能力

为什么它重要

Hermes 自带很多工具，但总有些工具不在它本体里。
MCP 就是标准化扩展方式。

一个最小示例

官方文档给的文件系统 MCP 例子大概是：

mcp_servers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/home/user/projects"]

意思是：

启动一个本地 MCP server
这个 server 给 Hermes 提供文件系统能力

新手需要马上学吗

不需要。

你第一次只要做到：

Hermes 能聊天
Hermes 能调你平台模型
Hermes 能用默认工具

就够了。

MCP 是第二阶段再学的。

第十四步：我建议你的 Hermes 上手顺序

如果你是 100% 小白，按这个顺序最稳：

阶段 1：先跑通

安装 Hermes
跑 hermes model
选择 Custom endpoint
填 https://www.yuzhixiaolongxia.com/v1
填 API Key
填模型 ID
跑 hermes
正常对话

阶段 2：会话和配置

学会 hermes --continue
学会 hermes sessions list
看懂 ~/.hermes/
学会 hermes doctor

阶段 3：项目级使用

在项目里写 AGENTS.md
理解 SOUL.md
试 /skills
试 hermes tools

阶段 4：高级玩法

建 Profiles
配 MCP
调整辅助模型
做网关、定时任务、批处理

第十五步：最常见的报错，怎么排

问题 1：`401 Unauthorized`

常见原因：

API Key 填错
API Key 已失效
令牌没有该模型权限
你选的模型和令牌分组不匹配

先做这几步：

回平台控制台确认令牌存在
去模型广场重新复制模型 ID
重新跑 hermes model
再跑 hermes doctor

问题 2：明明填了 base URL，还是不工作

最常见原因是 URL 写错。

你这里应该是：

https://www.yuzhixiaolongxia.com/v1

不是：

https://www.yuzhixiaolongxia.com

问题 3：按老教程配了 `.env`，结果不生效

这是因为 Hermes 官方文档已经明确说：

OPENAI_BASE_URL
LLM_MODEL

这些旧变量不再是 Hermes 主模型配置的主入口。

现在最稳的做法是：

直接用 hermes model
或直接编辑 ~/.hermes/config.yaml

问题 4：我改了模型，但当前会话没变

这通常不是 bug。

官方文档明确说：

改默认模型，影响的是新会话
当前正在跑的会话，仍保持原模型

如果你想在当前会话切换，用：

/model <模型名>

或新开一个会话。

问题 5：我不知道现在 Hermes 实际在用什么配置

先看：

hermes config

再看：

hermes sessions list

必要时：

hermes doctor

问题 6：我明明没让它记住东西，它怎么像记得以前聊过

因为 Hermes 的历史会话是保存的。

它可能通过：

当前 session
session_search
memory 文件

重新拿回了历史信息。

这恰恰是它和普通一次性 CLI 的差异。

报错了不想自己看？直接复制这段给 Claude 或 Codex

把下面这段存起来，以后 Hermes 出错时直接用：

你现在是我的 Hermes 故障排查助手。下面我会贴 Hermes 的完整报错信息，请你按下面要求帮我排查：

1. 先告诉我：这是安装问题、配置问题、模型权限问题、工具问题，还是会话/记忆问题。
2. 用最简单的话解释这个报错是什么意思。
3. 不要一次性给我很多方案，先给我最可能成功的第一种修复方法。
4. 给出的命令要能直接复制执行。
5. 如果你需要更多信息，请明确告诉我应该执行什么命令把结果贴给你。
6. Hermes 的接入口径固定是：
   - Provider：Custom endpoint
   - Base URL：https://www.yuzhixiaolongxia.com/v1
   - API Key：我的平台令牌
   - Model：从模型广场复制的模型 ID
7. 如果你怀疑是我填错了 Base URL、模型名或 Provider，请明确指出，不要含糊。

下面是我的报错信息：
【把报错粘贴在这里】

这个模板最适合：

401 Unauthorized
model not found
provider 选错
base_url 写错
hermes doctor 报红

第十六步：给你的平台做 Hermes 接入时，我建议的最稳配置

如果你只是想把 Hermes 接到你这个平台，建议先用最简单版本：

最稳妥方案

Provider：custom
Base URL：https://www.yuzhixiaolongxia.com/v1
Model：从模型广场复制
先只用一个主模型
不先折腾辅助模型
不先折腾 MCP
不先折腾 gateway

给完全不懂的新手的一条最短路线

如果你什么都不懂，只想最快跑通 Hermes，请按这个顺序：

先在 Windows 里执行 wsl --install
安装并打开 Ubuntu
在 Ubuntu 里把 Node.js 环境弄好
先装 Claude Code 或 Codex CLI
确认 claude --version 或 codex --version 正常
再把“安装提示词”复制给 Claude 或 Codex
按它的提示装好 Hermes
再把“配置提示词”复制给 Claude 或 Codex
跑 hermes model
选 Custom endpoint
填 https://www.yuzhixiaolongxia.com/v1
填你的 API Key
填模型 ID
再把“验证提示词”复制给 Claude 或 Codex
跟着完成第一次测试

只要你按这个路线走，哪怕自己完全不懂 Hermes，也能在助手带领下跑通第一版。

第一天不要做什么

不要一上来配 10 个 provider
不要一上来改一堆 config.yaml
不要一上来做复杂 Profiles
不要一上来接 5 个 MCP server
不要一上来给 Hermes 太多高危工具权限

先跑通，再扩展。

第十七步：你可以直接抄的最小配置示例

如果你已经知道自己在做什么，也可以手写配置。
但还是那句话：新手优先用 hermes model 自动写。

下面这个示例只是让你理解结构：

model:
  provider: custom
  default: 你从模型广场复制的模型ID
  base_url: https://www.yuzhixiaolongxia.com/v1
  api_key: 你的平台令牌

terminal:
  backend: local

注意：

Hermes 官方不同页面在字段展示上有过版本演进
你本机最终以 hermes model 实际写出来的配置为准
如果你看到字段名略有差异，不要慌，先用 hermes config get model 看现状

第十八步：给小白的 10 条使用建议

第一次只做最简单聊天验证。
模型 ID 一律从模型广场复制，不要手打。
Base URL 一定写 /v1。
先跑 hermes model，不要先手改一堆配置。
出问题先跑 hermes doctor。
学会 hermes --continue，它真的很常用。
别把 SOUL.md 和 AGENTS.md 混写。
默认先别碰 MCP。
默认先别乱开高风险工具。
真要长期用，尽早学 Profiles。

常用命令速查

# 启动聊天
hermes

# 配模型 / provider / custom endpoint
hermes model

# 健康检查
hermes doctor

# 查看当前配置
hermes config

# 查看历史会话
hermes sessions list

# 继续上次会话
hermes --continue

# 管理工具
hermes tools

# 查看技能
hermes skills list

# 创建新 profile
hermes profile create coder

最后的判断

如果你把 Hermes 只当成“另一个聊天终端”，那你只会用到它 20% 的能力。
真正的 Hermes，是一个：

有主模型
有辅助模型
有会话系统
有记忆系统
有技能系统
有工具系统
有 Profiles
有 MCP

的长期 AI Agent 框架。

而对于接你自己平台这件事，最正确、最省心的路线就是：

hermes model → Custom endpoint → https://www.yuzhixiaolongxia.com/v1 → 填 API Key → 填模型 ID → 先跑通一次聊天。

参考官方文档

上一步：OpenClaw 浏览器代理 | 回进阶玩法总览