开发者社区

文档建议反馈控制台

文章/答案/技术大牛

发布

社区首页 >专栏 >别急着装 Hermes Agent：Windows 上这 7 个坑，我替你踩完了

别急着装 Hermes Agent：Windows 上这 7 个坑，我替你踩完了

作者头像

兮动人

发布于 2026-08-05 11:19:09

发布于 2026-08-05 11:19:09

6220

举报

概述

在 Windows 上安装 Hermes Agent，看似只需双击安装包，实际却可能遇到安装路径无法选择、GitHub 连接失败、安全软件拦截临时程序、代理不生效、TokenHub 配置错误、模型额度耗尽及切换后会话未更新等问题。本文基于一次真实安装经历，给出将 Hermes 安装到 E 盘的完整命令，并结合日志还原排错过程，帮助你少走弯路。

文章被收录于专栏：兮动人的博客兮动人的博客

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

目录

一、Windows 安装包和 PowerShell 安装，到底有什么区别？

二、第一个坑：安装包放在 E 盘，不代表 Hermes 会装在 E 盘

三、第二个坑：浏览器能打开 GitHub，安装器照样可能连不上

四、第三个坑：信任了安装目录，安全软件仍可能拦截临时 EXE

五、别猜，先看这四份日志

六、第四个坑：腾讯账号“有额度”，不等于当前模型服务有额度

七、第五个坑：腾讯控制台有模型，Hermes 下拉列表里却没有

八、第六个坑：接口返回 200，不代表这个模型适合 Hermes Agent

九、第七个坑：当前会话、全局默认和模型列表，是三套状态

十、最终可复用的检查清单
- 安装前
- 安装失败时
- 模型接入时

写在最后