快速部署并跑通第一个 Hermes Agent 会话
第一次接触 Hermes Agent，最省心的目标不是把所有功能都摸透，而是先把安装、配置和第一次有效对话跑通。这样你后面再去看 tools、skills、messaging 这些能力时，心里会更有底。
先搞清楚 Hermes Agent 适合放在哪儿跑
Hermes Agent 的使用场景比“装在编辑器里聊两句”要宽得多。官方文档给出的运行方式覆盖本地机器、Docker、SSH 远程服务器，以及 Modal、Daytona、Singularity 这类隔离或云端后端。换句话说，你可以把它放在自己的开发机上，也可以放进更适合长期运行的环境里。
如果你用的是 Windows，这里有个很关键的边界要先记住：官方明确写的是“不支持原生 Windows”，需要先安装 WSL2，再在 WSL2 终端里运行 Hermes。这个点越早确认，后面越少踩坑。
两条部署路径怎么选
如果你只是想尽快开聊，直接用一键安装脚本就行：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
这条命令适用于 Linux、macOS、WSL2，以及 Android 的 Termux 环境。官方给出的说明很直接：安装脚本会自动处理 Python、Node.js、ripgrep、ffmpeg、仓库克隆、虚拟环境、全局 hermes 命令和 LLM Provider 配置。也就是说，正常情况下你只要先确认 git 可用，其他依赖不用自己一项项补。
如果你更想掌控每一步，也可以走手动安装。官方流程包括：
- 用
--recurse-submodules克隆仓库。 - 安装
uv，再创建 Python 3.11 的虚拟环境。 - 安装 Python 依赖，按需要选择 extras。
- 如果你要浏览器自动化或 WhatsApp bridge，再额外执行
npm install。 - 创建
~/.hermes/目录结构，准备config.yaml和.env。 - 把
hermes加到 PATH 里。
这里有个细节很实用：npm install 不是所有人都必须执行，官方写得很清楚，它只在浏览器自动化和 WhatsApp bridge 场景下才需要。只想先跑通文本对话的话，不必上来就把所有可选能力一起装满。
首次配置要抓住哪几个关键点
Hermes 的配置中心在 ~/.hermes/。官方文档列出了几个最常见的文件：config.yaml 用来放模型、终端后端等非敏感设置，.env 用来放 API Key 之类的密钥，另外还有 auth.json、memories/、skills/、sessions/、logs/ 等目录和文件。
第一次配置时，最重要的是先把 Provider 选好。官方建议直接用：
hermes model
这条命令会带你选择推理 Provider 和具体模型。文档里列了很多可选项，包括 Codex、Anthropic、OpenRouter、Gemini、GitHub Copilot 等。你不需要一次全研究明白，先选一个你已经有凭证、并且能正常响应文本对话的就够了。
还有一个经常被忽略但很重要的限制：Hermes 要求模型至少有 64K 上下文窗口。如果你接的是自定义或本地模型，这个条件最好提前确认，不然到了启动阶段才发现不满足，会很影响心情。
日常改配置时，也可以记住这几个命令：
hermes config
hermes config edit
hermes config set KEY VAL
hermes config check
hermes config migrate
这里还有个很省事的小规则：hermes config set 会自动把 API Key 这类密钥写进 .env，把普通设置写进 config.yaml。再加上官方定义的配置优先级是“CLI 参数 > ~/.hermes/config.yaml > ~/.hermes/.env > 内置默认值”，所以后面如果你觉得“明明改了配置怎么没生效”，排查起来也有明确顺序。
用第一次对话和三条命令完成验收
装完、配完之后，先别急着折腾高级功能，我们先做一次最朴素也最重要的验收。第一步是重载 shell：
source ~/.bashrc
# 或
source ~/.zshrc
然后直接启动：
hermes
# 或
hermes --tui
官方说明里提到，Hermes 现在同时提供经典 CLI 和更新的 TUI，两者共享同一套 sessions、slash commands 和配置。如果你是第一次上手，可以优先试试 hermes --tui，因为 Quickstart 页面把它标成了 recommended。
真正跑通的标志，不只是界面打开了，而是你已经完成了一次真实问答。Quickstart 页面提到，启动后你会看到一个 welcome banner，里面会显示当前 model、available tools 和 skills。看到这一步，说明基础链路已经接上了；再发一句简单的问题，确认模型能正常响应文本，就可以继续往下做安装验收。官方手动安装页给出的三条检查命令很适合作为收尾：
hermes version
hermes doctor
hermes status
hermes version 用来确认命令可用，hermes doctor 会跑诊断，hermes status 则帮助你检查当前配置状态。到这一步如果都正常，你的第一个 Hermes Agent 会话基本就算跑通了。接下来再去看 tools、skills、messaging，或者把终端后端切到 Docker、SSH 这类更适合长期使用的环境，节奏都会轻松很多。