Hermes 使用与安装教程（2026）：Windows 一键部署 Hermes Agent、模型接入与初次上手避坑
TL;DR： Windows 上装 Hermes Agent 就三步。用管理员权限打开 PowerShell 跑一行安装脚本；关掉窗口重新打开，输入
hermes进入配置向导；在向导里选好模型供应商、粘贴 API Key，消息平台那一步跳过。装完即可在终端直接对话并调用工具。顺利的话 10 分钟左右。最容易卡住的地方是装完不重开终端，新写入的环境变量读不到，表现就是「模型未识别」。这时候不用卸载重装，重开终端或用/model手动指定模型即可。
Hermes Agent 是 Nous Research 开源的 AI 智能体。下面是在 Windows 上把它装好、接上模型并开始日常对话的完整流程。Hermes 是什么、有哪些模型版本，见 Hermes 教程首页；已经装好、想接进微信的，直接看 Hermes 接入微信教程。
📚 本文目录（点击跳转）
- 准备工作：Windows 安装 Hermes Agent 的前置条件
- 第一步：以管理员权限运行一键安装脚本
- 第二步：运行终端配置向导与接入模型（以 Minimax 为例）
- 第三步：验证安装状态与启动 Hermes 终端
- 第四步：初次上手对话与常用终端命令速查
- 常见报错解决：提示「模型为空 / 未识别」排坑指南
- Hermes Agent Windows 部署方案优缺点分析
- 适合人群
- 常见问题 FAQ
- 推荐相关教程
- 总结
准备工作：Windows 安装 Hermes Agent 的前置条件
缺任何一个，后面都会卡住：
- 一台 Windows 电脑。 Windows 10 或 11 都行，建议留出几 GB 磁盘空间给 Python、Node.js 这些依赖。
- 一个能访问 GitHub 的网络环境。 安装脚本和它要装的依赖都从 GitHub 拉取，网络不通就装不动，这是安装卡住最常见的原因。
- 一个模型 API Key。 Hermes Agent 自己不带模型，必须接一家模型服务才能干活。还没有的话，先去对应平台的开放平台注册并创建一个 API Key，第二步要用。本文以国内常用的 Minimax 为例。
下面所有命令都在 PowerShell 里执行。
第一步：以管理员权限运行一键安装脚本
官方提供了一键脚本，Python、Node.js、Git、ripgrep 这些依赖由脚本自动检测并安装，不用自己一个个装。
- 打开 PowerShell。右键点击图标，选「以管理员身份运行」。不用管理员权限，后面容易中途报权限错误。
- 复制并执行下面这行命令：
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
脚本会自动检测当前环境、下载安装核心依赖，视网络情况需要几分钟。这个过程不需要做任何选择，等它跑完就行。
装完关掉当前 PowerShell 窗口，重新打开一个新的。 安装脚本写入的环境变量只对新窗口生效，留在旧窗口里继续操作，后面很可能读不到
hermes命令。
第二步：运行终端配置向导与接入模型（以 Minimax 为例）
在新的 PowerShell 窗口里输入：
hermes首次运行会进入终端配置向导。用键盘上下方向键选中第一项 Quick setup（快速设置），回车进入下一步。
如果这一步没有出现向导，说明安装没跑完或者环境变量仍未生效，回到第一步重跑一次安装脚本即可，脚本可以重复执行。
配置模型供应商（以 Minimax 为例）
Hermes Agent 自己不带模型，要在这一屏给它绑定一家大模型服务。选哪家取决于你手里有哪家的 API Key，本文以 Minimax 为例，换成其他供应商步骤完全一样。
- 在终端给出的供应商列表里，选中你手上 Key 对应的平台。
- 按屏幕上的交互提示粘贴 API Key，回车确认。
粘贴时终端不会把 Key 显示出来，这是正常的，直接粘贴后回车即可。这个 Key 只需要输入这一次，动手前先复制好。
消息平台接入配置（微信/飞书网关说明）
Hermes Agent 可以把对话入口接到第三方通讯软件上，但向导的这一屏里暂时没有飞书这类国内平台的直连选项，直接选跳过（Skip）。
跳过不影响使用，装好之后在终端里就能直接和 Hermes 对话。后续想把 Agent 接进微信或飞书，可以单独运行 hermes gateway setup 配置网关，完整步骤见站内 Hermes 接入微信教程。
剩下的确认提示，一路输入 Y（Yes）回车即可。
第三步：验证安装状态与启动 Hermes 终端
终端出现下面这个欢迎界面，说明主体安装和基础配置都完成了：
在输入行里输入 /model 回车，看终端回显的模型名是不是你刚配置的那一家。能正确回显，就可以开始用了。
第四步：初次上手对话与常用终端命令速查
配置完成后，你就已经可以直接在命令行中与 Hermes Agent 进行互动与自动化操作了。
1. 尝试第一次提问与 Agent 工具调用
在底部的提示符输入行中直接敲入你的任务或问题，例如：
帮我写一个 Python 脚本，扫描当前目录下的所有 .txt 文件并统计总字数Hermes 会通过绑定的模型进行规划、生成代码，并在获得授权后直接调用环境中的命令行与文件工具执行任务。
2. 常用终端斜杠命令（Slash Commands）速查
日常与 Hermes 交互时，常用以下几条核心命令来管理会话状态：
| 指令 | 作用说明 | 常见使用场景 |
|---|---|---|
/model | 查看当前模型或手动切换模型 | 检查模型挂载状态、切换不同供应商或模型版本 |
/help | 查看所有支持的命令与功能说明 | 忘记特定指令语法或查看新增特性 |
/clear | 清空当前会话的上下文记忆 | 开始全新任务，避免旧对话干扰 Token 与注意力 |
/tools | 查看或管理当前 Agent 可用的系统工具 | 查看 Hermes 是否具备文件读写、网页搜索或终端执行权限 |
/exit 或 Ctrl+C | 退出 Hermes Agent 终端会话 | 结束当前会话并返回普通 PowerShell 命令行 |
常见报错解决：提示「模型为空 / 未识别」排坑指南
装完向导、重新打开 Hermes 之后，有时状态栏或终端会提示模型为空，或者直接报错：
看着吓人，但不用卸载重装。
第一步：关掉终端，重新打开，再输入 hermes。
安装脚本是把环境变量写进系统里的，而你当时那个窗口还是安装前打开的会话，读不到新变量。重开窗口能解决大部分情况。
第二步：还是不行，就用 /model 手动指定一次。
在 Hermes 的对话框或输入行里输入 /model，按提示选中或填写模型名称。
看到终端正确回显你配置的模型名，就代表模型挂载成功了。这里填的模型名以终端列出的候选为准。不同供应商、不同档位可用的模型不一样，别直接照抄别人教程里的名字。
Hermes Agent Windows 部署方案优缺点分析
这套装法的优点
- Python、Node.js、Git、ripgrep 都由脚本检测并安装，不用手动配环境
- 全程只有两行命令要手敲，其余按提示选就行
- 模型、消息平台这些配置都在向导里，之后随时能重跑向导改
需要注意的地方
- 脚本和依赖都从 GitHub 拉取，网络不通就装不动
- 装完不重开窗口，环境变量读不到，就会出现「模型未识别」
- 向导里暂时没有飞书这类国内平台的选项，得装完之后单独配
适合人群
- 第一次在 Windows 上装 Hermes Agent，想用官方一键脚本快速跑通的人
- 已经装完、但卡在「模型未识别」这一步的人
- 手里已经有 Minimax 等平台的 API Key，想尽快把 Agent 用起来的人
常见问题 FAQ
装完之后没有自动出现配置向导，怎么办？
配置好了模型，终端却提示模型为空或未识别，要卸载重装吗？
安装脚本卡在下载依赖不动？
向导里的消息平台接入需要现在配吗？
必须用 Minimax 吗？
整个安装大概要多久？
推荐相关教程
- Hermes 接入微信教程：配置 Gateway 网关实现微信群聊 AI 助手 — 终端玩转后，将其接入日常聊天场景
- Hermes 教程专栏汇总 — 查看所有 Nous Research Hermes 相关配置与进阶技巧
总结
Windows 上装 Hermes Agent 就是两行命令：一行安装脚本、一个 hermes 启动。安装脚本要用管理员权限跑，跑完关掉窗口重新打开，漏掉任何一步都会表现为「模型未识别」。真遇到了，先重开终端，再用 /model 手动指定一次模型。