02. 快速开始：从安装到第一次对话

这篇解决什么问题

这一篇只做一件事：让 Hermes 跑起来。

先不讲源码。源码解读最好建立在一个真实可运行的环境上。否则你看到 hermes model、hermes tools、hermes gateway 这些命令时，只是在读概念。

安装

官方 README 给出的 Linux、macOS、WSL2、Termux 安装方式是：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows 原生 PowerShell 是：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安装后重新加载 shell：

source ~/.bashrc

然后启动：

hermes

第一次配置

最常用的几个命令：

hermes setup      # 交互式配置
hermes model      # 选择模型和 provider
hermes tools      # 配置工具
hermes doctor     # 诊断环境
hermes status     # 查看状态

如果你来自 OpenClaw，Hermes 还提供迁移命令：

hermes claw migrate

它会尝试迁移 persona、memory、skills、部分配置和密钥。

跑通第一次对话

可以进入交互式 CLI：

hermes

也可以用一次性命令：

hermes chat -q "用一句话介绍 Hermes"

如果这一步能返回结果，说明模型配置至少是通的。

验证工具是否可用

启动后可以问一个需要工具的问题，例如：

当前系统时间是多少？

如果 Hermes 能调用终端或时间相关工具返回真实结果，说明不只是模型能说话，工具链也开始工作了。

常见失败

找不到 hermes 命令

通常是 shell 没重新加载，或者安装路径没有进 PATH。

先试：

source ~/.bashrc
which hermes

模型报 401 / invalid key

这是 provider 密钥问题，不是 Hermes 主循环问题。

处理顺序：

hermes model
hermes auth list
hermes auth add <provider>
hermes doctor

工具不可用

工具是否出现，取决于 toolset 配置和依赖检查。

比如 browser、tts、homeassistant 这类工具都有额外依赖或环境变量。改完工具配置后，通常需要新会话生效。

实践：动手检查

现在连续发起两次请求：

hermes chat -q "用一句话介绍 Hermes"
hermes chat -q "读取当前系统时间，并说明你通过什么工具得到它"

第一条只验证模型链路，第二条验证工具链路。不要只看最终答案，还要确认第二条请求确实发生了工具调用，而不是模型猜了一个时间。

完成标准

• hermes --version 能输出版本；
• hermes doctor 没有阻塞运行的错误；
• 第一条请求能正常返回文本；
• 第二条请求调用了真实工具；
• 返回的时间与当前系统时间一致；
• 你能区分 provider 错误和工具不可用错误。

多走一步

新开一次交互式会话，先让 Hermes 读取一个测试文件，再追问“刚才文件里写了什么”。如果第二问能够接上，说明你同时验证了工具结果回写和会话上下文。

下一篇看什么

跑起来后，下一篇看配置。

Hermes 的行为很大一部分来自 config.yaml、.env、provider 和 toolset。源码解读前，先知道这些配置会影响哪里。