Windows 本地部署 Hermes Agent 完整教程：一键安装脚本与避坑指南
导语：想要在 Windows 系统上本地运行 Hermes Agent 吗？本文将为您提供一份保姆级的 Hermes安装 教程。无论您是 AI 开发者还是效率工具爱好者，只需通过简单的一键脚本，即可在 Windows 环境下快速部署 Hermes Agent。文章不仅包含完整的安装与模型配置流程（以 Minimax 为例），还总结了新手常踩的模型识别错误及避坑指南，帮您一次性跑通全流程！
# 📑 本文目录
一、 Windows 环境下 Hermes Agent 一键安装
在 Windows 系统上部署 Hermes Agent 非常简单，官方提供了自动化的脚本工具。
- 打开 Windows PowerShell（建议右键点击，选择以管理员身份运行，以免出现权限报错）。
- 在终端中复制并执行以下安装命令：
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
💡 提示：该脚本会自动检测您的系统环境，并全自动安装 Python、Node.js、Git、ripgrep 等 Hermes Agent 运行所需的所有核心依赖。在此期间请保持网络畅通，耐心等待即可。
二、 Hermes Agent 初始配置向导
依赖环境安装完成后，系统会自动进入 Hermes Agent 的终端配置向导。强烈建议新手直接通过键盘上下键选择第一项 Quick setup（快速设置）。
2.1 配置 AI 模型供应商（以 Minimax 为例）
接下来需要绑定驱动 Agent 的大语言模型。请根据您自己拥有的 API Key 选择对应的模型供应商。本文为了演示，以国内优秀的 Minimax 模型为例进行配置。
- 在供应商列表中找到并选择对应的选项。
- 按照屏幕提示输入您的 API 密钥完成鉴权。
2.2 消息平台接入设置（跳过飞书）
Hermes Agent 支持接入第三方通讯软件。但在当前的向导列表中，暂时没有提供“飞书”等部分国内常用平台的选项。
操作建议：在这里直接选择跳过（Skip）。后续如果需要接入飞书，可以通过 Gateway 单独进行高级配置。
在接下来的各项自动化配置步骤中，遇到确认提示时，直接输入 Y（Yes）并回车确认即可。
当您在终端中看到标志性的欢迎界面时，恭喜您，Hermes Agent 的主体安装已经成功！
三、 安装避坑指南
⚠️ 坑一：内置命令修复模型未被识别问题
在 Windows 环境下跑完安装流程后，部分用户可能会遇到一个典型的 Bug：配置好的模型没有被系统正确识别加载，状态栏或终端可能会提示模型为空或报错（如下图所示）。
这个问题大概率与 Windows 环境的初始环境变量读取有关。
✅ 解决办法：
无需重装，解决方式非常简单！直接在 Hermes Agent 的对话框或终端中，使用内置的 /model 命令手动重新指定模型名称。
执行该命令后，只要看到终端中正确回显了您配置的模型名称，即代表模型挂载成功，您可以开始正常使用您的 Hermes Agent 了！