02 · 先跑通第一个稳定闭环 · AI 编程教程中文版

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

官方资料：Quickstart、Installation、Configuration。

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

为什么先跑闭环

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

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

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

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

闭环五步

命令可用

shell 能找到 hermes，帮助命令能输出。

Provider 可用

key、OAuth、网络、model 和 context size 都能支撑普通对话。

对话可完成

一次小任务能正常回复，不出现 provider 或 context 报错。

Session 可恢复

用 --continue 或 -c 能接回上一轮上下文。

工具可控

只做只读、低风险工具验证，确认 tool output 可理解。

安装后检查

先确认命令：

hermes --help

再进入 provider 配置：

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 一直在切，每次切都重新建立连接。

第一次任务

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

恢复 session

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

hermes --continue

短参数：

hermes -c

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

低风险工具验证

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

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

合格标准：

只执行只读命令。
能展示或总结 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（第一次安装到对话）
Installation（PATH / 目录 / Termux / 原生 Windows）
Configuration（~/.hermes/ 文件分工）
Sessions（session 管理与恢复机制）

02 · 先跑通第一个稳定闭环