跳转到主要内容
HermesAgent.Work
入门

hermes setup 输出怎么看：设置向导每一步和装完后的四步验收

hermes setup 是交互式设置向导，结尾打印工具可用汇总和文件位置，并不会输出四行绿色信号。本文按 v0.21.5 真实流程讲清每一步，以及装完后用 doctor、status、短问答和 gateway status 验收。

更新 2026-10-079 分钟阅读入门setup验收清单Quickstart

最后更新 2026-10-07 · HermesAgent.Work 编辑组 整理维护（内容维护说明）· 步骤过时或无法复现可反馈

先纠正一个常见误解

网上不少教程（包括本站早先的版本）说跑完 hermes setup 要看 Provider configured、Memory enabled、Skills directory ready、Messaging gateway connected 四行绿色信号。hermes setup 从来不会输出这四行。它是一个交互式设置向导，问完问题后打印一份工具可用情况汇总。下面按 v0.21.5 的真实流程讲每一段在问什么、结尾输出怎么读，以及装完之后真正该用哪几条命令验收。

第一屏：选设置方式

第一次运行 hermes setup，会先让你选一种设置方式：

  • Quick Setup（Nous Portal）：用浏览器登录 Nous Portal，不需要 API Key，自动配好模型和工具，是新版的默认推荐项。
  • Full setup：每个 Provider、工具和选项自己配，用自己的 Key。
  • Blank Slate：除了最基本的都先关掉，之后按需逐项打开。

国内用户如果要用 MiniMax、智谱 GLM、Kimi 这类国内 Provider 的 Key，选 Full setup。已经装过再运行 hermes setup，默认是带着当前值重新走一遍；只想补缺项可以加 --quick。

Full setup 依次问什么

  1. 配置文件位置：先告诉你配置文件、密钥文件（~/.hermes/.env）、数据目录和安装目录分别在哪，这几个路径后面排错都用得上。
  2. 模型与 Provider：选 Provider、填 Key、选默认模型。这是唯一必须配好的一步。
  3. 终端后端：Agent 执行命令的环境，默认是本机，也可以选 Docker、SSH 等。
  4. 消息平台：要不要接 Telegram、飞书、企业微信等；不接可以跳过，以后再用 hermes gateway setup 补。
  5. 工具：网页搜索、浏览器、图像生成等需要额外 Key 的工具，按需开启。

每一段都可以单独重跑，例如只改模型就运行 hermes setup model。记忆和技能不在向导里：内置记忆默认就开着（存在 ~/.hermes/memories/ 的 MEMORY.md 和 USER.md 里），技能目录是 ~/.hermes/skills/，都不需要在 setup 里单独打开。

结尾的输出怎么读

向导结束时，屏幕上会依次出现：

  • 如果模型没配好，会先出现一行警告 No inference provider is configured — Hermes cannot chat yet.，并提示用 hermes model 或 hermes setup --portal 补上。看到这一行，后面什么都不用看，先把模型配好。
  • Tool Availability Summary：形如「N/M tool categories available」，下面逐项列出工具类别，可用的打 ✓，不可用的打 ✗ 并注明缺哪个环境变量。✗ 不代表安装失败，只是那类工具没配 Key；用不到就不用管，要用就运行 hermes setup tools 或往 ~/.hermes/.env 里补 Key。
  • 文件位置：Settings（config.yaml）、API Keys（.env）和数据目录（cron、sessions、logs）。
  • 修改配置的常用命令，以及开始使用的命令。

装完之后的四步验收

setup 跑完只说明配置写进去了，不说明能用。按这个顺序验收：

hermes doctor
hermes status
hermes
hermes gateway status
  1. hermes doctor：检查依赖、配置和 Key 是否齐全，缺什么会给出对应的安装命令。
  2. hermes status：一屏看各组件状态。
  3. hermes：打开会话，发一句短问题，确认模型能在合理时间内回复。这一步过了，Provider 才算真的通了。
  4. hermes gateway status：只有接了消息平台才需要。CLI 能回复、平台不回复时，问题在 Gateway 这一层。

先 CLI，再 Gateway

第一次不要急着把所有消息平台都接上。先用 CLI 完成一次干净对话，确认模型、工具、记忆没有报错；再接 Gateway。这样出问题时更容易定位：CLI 都不通，就别排查 Telegram；CLI 正常但 Gateway 不回，再看平台 Token、允许的用户和 hermes logs gateway 里的报错。

模型上下文别太小

Hermes 对模型的上下文窗口有硬性下限：至少 64K tokens，更小的窗口会在启动时直接被拒绝。用 Ollama 这类本地模型时，要先把上下文调到 64K 以上（例如设置 OLLAMA_CONTEXT_LENGTH=64000）。第一次接入，建议先用托管模型跑通，再换本地模型。

还没有真实场景？可以先领取 Free Starter 模板包，从低风险只读任务开始试跑。