快速上手 Hermes Agent
基于官方 Hermes Getting Started 教程，面向新手讲清安装、模型供应商、第一次对话、session 恢复和下一层能力的最短路径。
快速上手 Hermes 的目标不是把功能全部打开，而是先得到一个稳定可用的基础对话。官方文档反复强调的判断标准很简单：如果 Hermes 还不能完成一次普通聊天，就先不要叠加 gateway、cron、skills、voice 或多 provider fallback。
先理解：最短路径是什么
第一步是安装 Hermes，并确认 shell 能找到 hermes 命令。
第二步是用 hermes model 选择一个模型供应商。新用户优先选最容易拿到凭据、网络最稳定的 provider。
第三步是启动 hermes 或 hermes --tui，完成一次普通对话。
第四步是用 hermes --continue 或 hermes -c 验证 session 能恢复。
这四步跑通，才算基础闭环通过。
怎么判断 provider 选得对
Hermes 支持很多 provider，包括 Nous Portal、OpenAI、Anthropic、OpenRouter、本地和 OpenAI-compatible endpoint。第一次不要同时打开多 provider、fallback 和复杂路由。
一个 provider 能稳定回复、能显示正确模型、不会很快报 context 或认证错误，就够你进入下一步。
官方建议模型上下文至少 64K tokens。本地模型要特别确认 context size，否则稍复杂任务会失效。
Secrets 和普通配置要分开
token、API key、bot secret 这类内容应该进 ~/.hermes/.env。
普通设置进 ~/.hermes/config.yaml。
新手不要把 key 写进教程、仓库、截图或聊天记录里。能用 CLI 写配置就用 CLI，让 Hermes 放到正确位置。
第一次对话怎么选
第一次测试不要问开放问题。选一个能验证当前目录理解能力的任务，例如让 Hermes 用几条 bullet 总结当前 repo，并指出 main entrypoint。
成功标准不是回答很长，而是：banner 显示的 provider 和 model 是预期的；Hermes 能正常回复；能识别当前目录；需要时能调用 file 或 terminal；多轮对话不会马上断。
什么时候加下一层能力
基础对话稳定后，想接消息平台再看 gateway。
想调整工具能力，再看 hermes tools。
想复用工作流，再看 skills。
想隔离命令执行，再改 terminal backend 到 docker 或 ssh。
想开语音，再看 voice mode。
顺序很重要：普通对话、session、工具、gateway、automation。不要反过来。
新手常见坑
- 安装后立刻接 Telegram 或 Discord。
- 同时配置多个 provider，失败时无法定位。
- 本地模型没设足够上下文。
- 把 API key 写进普通配置或仓库。
- 普通对话没稳定就开 tools、skills、cron。
- session 恢复没验证就接长期 bot。
怎么验收
Hermes 命令能启动。
provider 和 model 显示符合预期。
一次普通对话能完成。
Hermes 能识别当前项目或目录。
上一段 session 能恢复。
一个低风险工具动作能执行，并且不会破坏本地环境。