02 · 先跑通第一个稳定闭环
基于官方 Hermes Getting Started 教程，面向新手讲清安装后先验证 provider、普通对话、session 恢复和最小工具能力。
第一次使用 Hermes，不要急着接 Telegram、开 cron、装 skills 或配置复杂 memory。先跑通第一个稳定闭环。
稳定闭环只有四件事：Hermes 能启动，provider 能用，普通对话能完成，刚才的 session 能恢复。
先理解：为什么先跑闭环
Hermes 是一个会不断扩展能力的 Agent。你可以接工具、消息平台、定时任务、skills、memory、gateway。
但所有复杂能力都依赖底层闭环。如果 provider 不稳定、session 保存不了、CLI 都跑不通，后面接再多功能都会变成排障噪音。
新手第一天目标不是“全配置完”，而是“确认最小链路可靠”。
怎么判断安装成功
安装成功不是脚本跑完，而是 shell 能找到 hermes 命令，Hermes 能启动，版本和 provider 信息能正常显示。
如果 shell 找不到命令，先重载 shell 配置。不要立刻重装，也不要开始改复杂配置。
怎么判断 provider 稳定
第一次只配置一个最稳定、最容易拿到凭据的 provider。不要一开始配置多 provider、fallback、复杂路由。
普通对话能稳定回复，才说明 provider、key、网络和模型基本可用。
官方建议模型上下文至少 64K tokens。本地模型尤其要确认 context size，否则稍复杂任务会很快失败。
第一次对话怎么选
第一次任务要可验证，不要问开放式大问题。让 Hermes 总结当前 repo、指出入口文件、说明主要目录，就是合适任务。
成功标准不是回答长，而是 provider/model 是预期的、Hermes 能识别当前目录、必要工具能调用、对话不会断掉或报 context/provider 错误。
为什么要马上验证 session 恢复
Hermes 的长期助手、消息平台、后台任务、memory 和 cron 都依赖 session 能保存和恢复。
如果刚完成的对话不能恢复，先修 session，不要继续接 gateway 或定时任务。
新手常见坑
- 安装后立刻接 Telegram 或 Discord。
- 同时配置多个 provider，出错时不知道是哪层问题。
- 本地模型没设足够上下文。
- 普通对话还不稳就开 terminal/file 权限。
- session 恢复没验证就接长期任务。
- 第一次任务太大，导致排障无法定位。
出问题先退回闭环
先查 provider key 是否正确。
再查 model 是否可用。
再查普通对话是否能跑。
再查 session 是否可恢复。
最后再查 terminal、file、web 等工具是否可用。
不要在闭环没稳时同时排查 gateway、skills、cron、memory、MCP 和远程后端。
怎么验收
你能启动 Hermes，并看到预期 provider 和 model。
你能完成一次普通对话。
你能让 Hermes 识别当前项目或目录。
你能恢复上一段 session。
你能执行一个低风险工具动作，并确认它没有破坏本地环境。