---
title: "02 · 先跑通第一个稳定闭环"
description: "安装 Hermes 后先验证命令、provider、64K context、普通对话、session 恢复和低风险工具调用。"
verifiedAt: "2026-05-09"
---

第一次使用 Hermes，**不要**急着接 Telegram、开 cron（定时）、装 skills（技能）、配置外部 memory provider（记忆插件）或接 MCP（模型上下文协议）。稳定闭环只有几件事：命令能启动，provider 能用，普通对话能完成，刚才的 session（会话）能恢复，低风险工具动作能被你看懂。

官方资料：[Quickstart](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart)、[Installation](https://hermes-agent.nousresearch.com/docs/getting-started/installation)、[Configuration](https://hermes-agent.nousresearch.com/docs/user-guide/configuration)。

> [!NOTE]
> **先给结论**：新手第一天目标**不是**"全配置完"，而是**"确认最小链路可靠"**。闭环不稳定，所有高级功能都会变成排障噪音——同一个错误既可能在模型层、也可能在工具层、也可能在 backend 层，一次开 5 个变量等于在沼泽里找钥匙。

## 为什么先跑闭环

Hermes 是一个能力可以不断往上叠的系统——toolsets（工具集）、terminal backend（终端后端）、memory（记忆）、skills（技能）、Gateway（消息网关）、cron（定时）、background session（后台会话）、delegation（委派子代理）、MCP（模型上下文协议）、plugins（插件）都能继续接。

但所有复杂能力都依赖底层闭环：

```mermaid
flowchart LR
    Install["安装与 PATH"] --> Provider["provider/model"]
    Provider --> Chat["普通对话"]
    Chat --> Session["session 恢复"]
    Session --> Tool["低风险工具"]
    Tool --> Advanced["Gateway / skills / memory / cron"]
```

如果 provider 不稳定、session 保存不了、CLI 都跑不通，后面接再多功能只会让问题更难定位。

## 闭环五步

<Cards>
  <Card title="命令可用" description="shell 能找到 hermes，帮助命令能输出。" />
  <Card title="Provider 可用" description="key、OAuth、网络、model 和 context size 都能支撑普通对话。" />
  <Card title="对话可完成" description="一次小任务能正常回复，不出现 provider 或 context 报错。" />
  <Card title="Session 可恢复" description="用 --continue 或 -c 能接回上一轮上下文。" />
  <Card title="工具可控" description="只做只读、低风险工具验证，确认 tool output 可理解。" />
</Cards>

## 安装后检查

先确认命令：

```bash
hermes --help
```

再进入 provider 配置：

```bash
hermes model
```

如果 shell 找不到命令，先 `source ~/.bashrc` 或 `source ~/.zshrc`。不要立刻重装，也不要开始改复杂配置。

## Provider 验证

第一次只配置一个 provider。验证时看四点：

- **凭据有效**：API key 或 OAuth 没过期；如果是 OAuth，确认登录流程跑完没卡在浏览器回调。
- **网络可用**：请求能稳定返回，不是断断续续超时。国际 provider 没梯子时考虑切到中国区直连（Z.AI / Kimi / DeepSeek / Qwen 等）。
- **模型符合任务**：官方 quickstart 强制要求至少 **64K tokens** 上下文——上下文不够时 Hermes 在启动时就会拒绝模型加载，不是运行后才报错。
- **成本可控**：不会因为一次试跑触发意外费用。订阅型 provider（如 Claude Max）按月计费，按 token 计费的（OpenRouter / 直连 API key）需要心里有数。

多 provider、fallback（备用切换）、routing（路由）都**放到基础闭环之后**。否则出错时你不知道是哪条链路坏了——你看到的是"模型回复超时"，但实际上可能是 fallback 一直在切，每次切都重新建立连接。

## 第一次任务

第一次任务要小、明确、可验证。

推荐：

```text
请说明当前目录是什么项目，并列出你会先查看的 3 个文件。不要修改任何文件。
```

成功标准：

- 欢迎信息或状态能看到预期 provider/model。
- Hermes 能识别当前目录。
- 对话不会断掉或报 context/provider 错误。
- 它没有在未授权情况下修改文件。
- 你能看懂它准备读取什么、为什么读取。

不要第一次就让它“优化整个项目”“接入 Gateway”“写一个自动化系统”。那不是 quickstart，是压力测试。

## 恢复 session

完成第一次对话后马上验证：

```bash
hermes --continue
```

短参数：

```bash
hermes -c
```

如果刚完成的对话不能恢复，先修 session。Gateway、多平台对话、memory、skills 和 background tasks 都依赖 session 能被正确保存和恢复。

## 低风险工具验证

基础对话稳定后，再验证一个低风险工具动作：

```text
只读列出当前目录文件，并说明你不会修改任何文件。
```

合格标准：

- 只执行只读命令。
- 能展示或总结 tool output。
- 命令执行位置符合当前 backend。
- 没有访问敏感目录。

不要在这一步让 Hermes 修改文件、运行未知脚本、接外部平台或后台执行命令。

## 失败时怎么定位

> 对症下药——下面五种症状对应的常见根因，**一次只改一层**：

| 症状 | 最可能的原因 | 先做什么 |
| --- | --- | --- |
| `hermes: command not found` | PATH 或 shell 配置问题（最常见：用 zsh 但只改了 .bashrc） | `echo $SHELL` 看用哪个 shell；`source` 对应的 rc 文件；检查 `~/.local/bin` 在 `$PATH` 里 |
| Provider 报错（401 / 403 / 拒绝调用） | key 错、OAuth 过期、网络、模型名拼写、context size 不够、provider 限流 | `hermes model` 重新交互配置；本地模型确认 `--ctx-size 65536` |
| 对话中断 / 卡住不响应 | 模型上下文超限、网络、工具调用挂起、timeout | 看是不是任务太复杂；用 Ctrl+C 中断后重试小任务 |
| `--continue` 失败 | session 存储被清、profile 切换、启动目录或文件权限 | `hermes sessions list` 看是否真有上一个 session；确认从同一目录启动 |
| 工具执行异常 | toolset 没开、terminal backend 不对、cwd（当前目录）问题、权限或 sandbox 配置 | 看是哪个工具报错；临时把 toolset 降到最小；确认 backend 是不是预期 |

**不要**在一个失败状态里同时改五个变量。一次只改一层——改完跑一次最小验收命令，确认这一层 OK 再继续下一层。

## 官方资料

- [Quickstart](https://hermes-agent.nousresearch.com/docs/getting-started/quickstart)（第一次安装到对话）
- [Installation](https://hermes-agent.nousresearch.com/docs/getting-started/installation)（PATH / 目录 / Termux / 原生 Windows）
- [Configuration](https://hermes-agent.nousresearch.com/docs/user-guide/configuration)（`~/.hermes/` 文件分工）
- [Sessions](https://hermes-agent.nousresearch.com/docs/user-guide/sessions)（session 管理与恢复机制）

## 下一步

<Cards>
  <Card title="配置与 Provider" description="闭环稳定后，继续读懂 ~/.hermes 下 config.yaml、.env 各文件的分工，以及 provider 切换与 fallback 路由。" href="/docs/hermes/understanding/03-configuration-provider" />
  <Card title="快速上手" description="需要操作版命令，回到官方快速上手页查 hermes setup / model / gateway 一类入口命令。" href="/docs/hermes/official/00-getting-started/quickstart" />
</Cards>
