导语:想要在 Windows 系统上本地运行 Hermes Agent 吗?本文将为您提供一份保姆级的 Hermes安装 教程。无论您是 AI 开发者还是效率工具爱好者,只需通过简单的一键脚本,即可在 Windows 环境下快速部署 Hermes Agent。文章不仅包含完整的安装与模型配置流程(以 Minimax 为例),还总结了新手常踩的模型识别错误及避坑指南,帮您一次性跑通全流程!
在 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 的终端配置向导。强烈建议新手直接通过键盘上下键选择第一项 Quick setup (快速设置) 。
接下来需要绑定驱动 Agent 的大语言模型。请根据您自己拥有的 API Key 选择对应的模型供应商。本文为了演示,以国内优秀的 Minimax 模型为例进行配置。
- 在供应商列表中找到并选择对应的选项。
- 按照屏幕提示输入您的 API 密钥完成鉴权。
Hermes Agent 支持接入第三方通讯软件。但在当前的向导列表中,暂时没有提供“飞书”等部分国内常用平台的选项。
操作建议:在这里直接选择跳过(Skip)。后续如果需要接入飞书,可以通过 Gateway 单独进行高级配置。
在接下来的各项自动化配置步骤中,遇到确认提示时,直接输入 Y(Yes)并回车确认即可。
当您在终端中看到标志性的欢迎界面时,恭喜您,Hermes Agent 的主体安装已经成功!
在 Windows 环境下跑完安装流程后,部分用户可能会遇到一个典型的 Bug:配置好的模型没有被系统正确识别加载,状态栏或终端可能会提示模型为空或报错(如下图所示)。
这个问题大概率与 Windows 环境的初始环境变量读取有关。
✅ 解决办法:
无需重装,解决方式非常简单!直接在 Hermes Agent 的对话框或终端中,使用内置的 /model 命令手动重新指定模型名称。
执行该命令后,只要看到终端中正确回显了您配置的模型名称,即代表模型挂载成功,您可以开始正常使用您的 Hermes Agent 了!