一、前言最近在体验 **Hermes-Agent**这是一个由 **Nous Research** 开源的 AI Agent智能体框架。和普通聊天机器人不同Hermes-Agent 更偏向于支持长期记忆 支持任务执行 支持多平台接入 适合做个人 AI 助手 / 自动化助手 / 开发辅助工具不过在 Windows 上安装时很多人第一步就会踩坑明明在 Git Bash 里执行了官方命令却提示必须使用 PowerShell 安装。本文就手把手记录一下 **Windows 环境下 Hermes-Agent 的安装与配置过程**包括常见报错处理适合新手直接照着做。二、Hermes-Agent 是什么Hermes-Agent 是一个开源 AI 智能体框架。它的特点不是单纯“聊天”而是更像一个可以持续工作的 AI 助手。核心特点持久记忆可记住历史上下文和用户偏好任务执行能力适合自动化流程、辅助开发等场景技能沉淀完成任务后可逐渐积累经验多平台接入可扩展到 Telegram、Discord、Slack 等平台支持自托管更适合有定制化需求的用户适用人群想部署本地 AI Agent 的开发者 想做自动化任务流的人 希望 AI 能“记住自己”的用户 想把 AI 接入团队协作平台的用户三、安装前准备先确认以下环境1操作系统Windows 10 / Windows 112网络环境由于安装脚本需要从 GitHub 拉取资源需保证网络正常访问 GitHub。3PowerShellWindows 默认自带 PowerShell一般无需额外安装。打开方式按Win 输入PowerShell 点击打开四、安装 Hermes-Agent脚本安装执行官方 Shell 安装命令# Windows (WSL2)/macOS / Linux一行命令完整安装curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash# 安装完成后加载环境变量并启动source~/.bashrchermes#(如果你使用的是 Zsh请运行 )source~/.zshrc执行后大家却发现在 Windows 的 Git Bash 中通常会看到提示imgsrchttps://i-blog.csdnimg.cn/direct/d9a8152532c34f92af1e089ca67533f4.pngreferrerpolicyno-referreraltimageTips:原因分析 虽然 Git Bash 能运行很多 Linux 风格命令但 **Hermes-Agent 官方安装脚本会检测当前操作系统**。 如果检测到是 Windows它会要求使用 **PowerShell 版安装脚本**而不是install.sh。 在 Windows 下正确做法是 **不要继续在 Git Bash 中执行install.sh** **改用 PowerShell 执行install.ps1** 打开 PowerShell 执行下面这个指令bashirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1|iex命令解释 irmInvoke-RestMethod的别名用于下载远程脚本iexInvoke-Expression的别名用于执行下载到的脚本内容 有些 Windows 用户执行时会报错例如 无法加载脚本 系统禁止运行脚本 execution policy 限制 解决方法 先在当前 PowerShell 会话中临时放开执行策略bashSet-ExecutionPolicy-ScopeProcess Bypass然后再次执行安装命令bashirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1|iex如果执行安装命令后没有明显输出建议按以下思路排查 1检查网络 先确认能否访问 GitHub 原始地址例如bashhttps://raw.githubusercontent.com/2以管理员身份运行 PowerShell 有些安装过程涉及环境变量或目录权限建议尝试 右键 PowerShell 选择“以管理员身份运行” 3检查安全软件拦截 部分杀毒软件、Windows Defender 可能对脚本执行有额外限制。 4分步调试 如果不想直接irm|iex也可以先手动下载脚本再执行。imgsrchttps://i-blog.csdnimg.cn/direct/e15771caaf254dea8a4653a1413feedb.pngreferrerpolicyno-referreraltimage安装好后输入指令验证bashhermes--version正常输出版本即安装成功。### **手动安装网络受限环境**bash# 克隆仓库gitclone https://github.com/NousResearch/hermes-agent.gitcdhermes-agent pipinstall-rrequirements.txt python-mhermes## 五、**配置 Hermes Agent的模型**依赖环境安装完成后系统会自动进入 Hermes Agent 的终端配置向导。强烈建议新手直接通过键盘上下键选择第一项Quick setup快速设置。### **方法一使用交互式配置向导推荐**这是最简单、最推荐新手的方法。 在终端中输入并运行配置向导bashhermes setupimgsrchttps://i-blog.csdnimg.cn/direct/e4413205b51540f7a73cb1e0573df626.pngreferrerpolicyno-referreraltimagehermes setup会依次引导完成 LLM 提供商选择、工具启用和网关配置。imgsrchttps://i-blog.csdnimg.cn/direct/8156776d88fa4d58a685c264291e2cd6.pngreferrerpolicyno-referreraltimage2.推荐使用自定义端点custom endpoint输入服务器地址 **服务器地址https://www.moyu.info或https://www.moyu.info**3.输入 API Key根据你选择的提供商粘贴你的 API Key 并按回车。**输入时屏幕不会显示字符这是正常的安全保护措施。** 获取 API Key可以前往魔芋API平台https://www.moyu.info/register?affg2d7创建并获取. 详情步骤可以查看文章**六、API Key密钥获取**4.输入模型名称获取你选择的提供商下的可用模型列表选择一个作为默认模型即可。 或者选择5.Enter custom model name 去魔芋平台 https://www.moyu.info/register?affg2d7的模型广场上复制模型名称添加进去。imgsrchttps://i-blog.csdnimg.cn/direct/d95285fa1b804b62b1d6184acd07afb9.pngreferrerpolicyno-referreraltimage配置完成后就可以开始使用了。你也可以随时用hermes model命令来快速切换模型。### **方法二手动编辑配置文件**如果需要更精细的控制也可以直接编辑配置文件。 主配置文件~/.hermes/config.yaml用于配置模型、提供商等核心设置。 环境变量文件~/.hermes/.env用于安全地存放所有 API Key。 快速编辑可以使用以下命令直接打开配置文件进行修改hermes config edit### 基本使用与常用命令配置完成后就可以和 Hermes Agent 对话了。 开始对话在终端输入hermes并回车即可进入交互式聊天界面开始你的第一条消息。 后台运行让 Agent 在后台持续运行bashhermes run运行健康检查检查所有依赖和配置是否正确 hermes doctor### 常用命令速查表功能 命令 查看技能 hermes skills list 搜索记忆 hermes memory search关键词添加定时任务 hermescronadd任务描述如每天 8 点总结任务连接消息平台 hermes gateway telegram(或其他平台)查看配置 hermes config list### 常见问题与解决思路 安装失败或hermes命令找不到请先确认网络连接正常能够访问 GitHub。安装完成后记得执行source~/.bashrc或重启终端。 模型调用失败(401Unauthorized)这通常是 API Key 无效或未正确配置。请使用hermes setup重新配置你的 API Key## 六、**API Key密钥获取**点击链接前往api平台 https://www.moyu.info/register?affg2d7 使用手机号码或者邮箱来进行账号注册。imgsrchttps://i-blog.csdnimg.cn/direct/2800260a5a5d425ab3991f4c28d5e034.pngreferrerpolicyno-referreraltimage**注册成功后登录进入【令牌管理】**imgsrchttps://i-blog.csdnimg.cn/direct/d9f259a211fc4601a092f3f3cbbe1a7a.pngreferrerpolicyno-referreraltimageimgsrchttps://i-blog.csdnimg.cn/direct/a7ad3119da6f4ae99b13bcd6ec3cc7fb.pngreferrerpolicyno-referreraltimageimgsrchttps://i-blog.csdnimg.cn/direct/806ae5f95b274f06841f6455f19d8aa6.pngreferrerpolicyno-referreraltimageimgsrchttps://i-blog.csdnimg.cn/direct/6f224a027c624e61bcf8d51d00aaecfe.pngreferrerpolicyno-referreraltimage**配置完成后可以使用新配置的令牌或者初始平台生成的令牌。**imgsrchttps://i-blog.csdnimg.cn/direct/db8d6d85ed014e9b89badf258043560e.pngreferrerpolicyno-referreraltimage### 七、总结在 Windows 上安装 Hermes-Agent最容易踩的坑就是 **误以为 Git Bash 可以直接执行 Linux 版安装脚本。** 实际上官方已经明确区分了 Linux / macOS使用install.sh Windows使用install.ps1一句话记住 **Windows 用户请直接打开 PowerShell执行**bashirm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1|iex如果遇到脚本权限问题再先执行bashSet-ExecutionPolicy-ScopeProcess Bypass