【P2】第2期：Windows 上直接安装 HermesAgent 及配置完整教程

2026-06-09

本文由视频教程转写整理。与上一期（P1）通过 WSL2 安装不同，本期讲的是在 Windows 上原生直接安装 HermesAgent，并完整覆盖大模型配置、飞书配置、微信配置、Web UI 配置。 作者结合此前帮多位朋友安装 WSL2 版的经验，特别补充了那些之前没提到、安装中容易踩的坑，目标是让你照着这一篇就能完整装下来。

〇、整体流程

整个过程大致分为四块：

1. Windows 命令行直接安装 Hermes，并完成必要配置（配置大模型）
2. 配置飞书
3. 配置微信
4. 配置 Web UI

装好后最直接的效果：用管理员权限打开 Windows 命令行，直接输入 hermes 即可进入交互界面（开头那个 logo 图标不显示不用管，打个招呼就能用）。 作者演示时用的是 DeepSeek-V4-pro 与 MiniMax 的 coding plan；原本想用智谱的 coding plan，但当天额度超了一直报错，于是中途换成 DeepSeek 演示。

一、Windows 原生安装 Hermes

1. 获取并执行安装命令

• 打开 HermesAgent 官方项目，找到 Windows 安装相关说明（该命令是最近一两天才更新的，对应原生 Windows 安装）。

• 用管理员权限打开 PowerShell：Windows + R 或任何你熟悉的方式，务必以管理员身份打开。

• 执行官方的 PowerShell 一键安装命令（irm ... | iex 形式）：

  irm https://raw.githubusercontent.com/nousresearch/hermes-agent/main/scripts/install.ps1 | iex

• 回车后等它自动执行即可。

🔐 安全提示：irm ... | iex 会直接下载并运行远程脚本。在运行前，建议先把 install.ps1 在浏览器打开看一眼内容再执行——它会克隆代码并修改你的用户 PATH。

这个安装命令做了什么（官方说明）：

• 把项目克隆到 %LOCALAPPDATA%\hermes\hermes-agent 目录；
• 创建一个 Python 虚拟环境（virtualenv）；
• 把 hermes 命令加入你的用户 PATH；
• 它还会自带一个**便携版 Git（PortableGit）**等依赖。

⚠️ 装完务必新开一个终端窗口，PATH 变更才会生效，否则会出现 hermes 命令找不到的情况。

与 P1（WSL2 路线）的关系与选择：

• 原生 Windows（本期）：用 PowerShell 一键装，无需 Docker / WSL，适合想省事、直接在 Windows 上用的人。
• WSL2（P1）：在 Windows 里虚拟出 Linux 再装，环境更标准、报错更少，适合愿意折腾或需要完整 Linux 能力的人。
• 官方说明两种方式可以共存，但有个别功能仅 WSL2 支持。另注：官方文档对原生 Windows 的表述前后不一（FAQ 旧条目曾称需用 WSL2），以专门的 Windows 原生安装指南 和实际安装脚本为准。

与 P1 对比：之前 WSL2 版安装的本是 Linux 环境，命令略有不同（用的是 curl ... install.sh | bash），但差别不大，主要都是同一个项目的东西。

2. 安装过程中的关键提醒

• 网络环境很重要（本期最重要的坑）。作者最开始网络不行时会报错，调整网络后才顺畅跑下来。作者实测前两遍都没成功，调整网络后才顺利。
• 看似卡住时怎么判断：盯住「下载速度」和「已下载大小」两个数字，只要还在变动就没问题，让它自己跑。
• 中途出现红色报错不必慌：只要它没有退回到「需要你输入命令」的状态，就说明它还在自动处理，一般会自己解决。这个安装流程优化得不错。
• 过程中它会装一些适配组件、依赖包，还会装一些 skill（技能），都不用管，等它自己处理完。
• 网络越好速度越快，网络差则容易报错。

3. 关于 ClaudeCode 迁移提示

• 如果你之前装过 ClaudeCode（Claude），安装中会提示「是否要从 ClaudeCode 迁移配置」。
• 推荐选 No（不迁移）——迁移可能把配置搞乱，后续排查麻烦。
• 没装过 ClaudeCode 的人可能不会看到这个提示。

4. 选择配置模式

• 进入配置环节，会让你在快速配置和全量配置之间选。
• 默认是 1（快速配置 / 默认配置）。
• ⚠️ 不建议选全量配置——参数配得太细，刚开始用没必要。
• 直接回车用默认快速配置，进入基础配置（大模型配置）。

二、配置大模型（含 token 科普）

1. 先搞懂 token 收费机制（给新手的科普）

很多人卡在不理解 token 怎么收费。可以这样类比手机流量：

• 按量付费：充多少钱，按你的实际用量扣费（类似按 G 买流量）。
• 套餐 / Plan：按月付费、包一定额度（类似流量套餐、家庭宽带包月）。这类大模型厂商的「coding plan / token plan」就是包月套餐，比按量便宜，但也不是无限量。

几个重要提醒：

• ⚠️ 没有免费的 token。注册或买会员送的额度，听起来「几千万」很多，但真拿来跑 Agent 做事根本不够用，必须自己买套餐、一步到位。
• ⚠️ 会员 ≠ token。比如某些产品的会员订阅，和「调用 API 要用的 token」不是一回事。

2. 选套餐的建议

• 作者认为国内性价比不错的有 MiniMax、智谱（GLM） 的套餐（但好的套餐不一定随时买得到）。
• 建议先从早期 / 入门套餐起步，熟悉之后需求量大了再升级，没必要一上来买最贵的。
• 流程：注册 → 订阅套餐 → 进 API Key 页面获取你的 Key，待会儿配置时复制过来用。

3. 填三项：API Key、Base URL、模型

大模型配置主要填三个东西（不一定全填）：API Key、Base URL、具体模型。

① 选模型厂商 / 标号

• 配置向导会列出可选的大模型，按你买的 token 套餐选对应项，输入它的编号回车。

② 填 API Key

• 把前面在套餐平台获取的 API Key 粘贴过来。
• ⚠️ 这是隐私信息，粘贴时不显示属正常。只粘一遍，别重复粘贴（粘多了可能用不了，得重新改）。粘完回车。
• 🔐 安全提醒：API Key 等同于你的付费凭证，切勿泄露、截图分享或提交到代码仓库。

③ 确认 Base URL

• 回车后会提示 Key 是否保存，并进入 Base URL 配置。
• 中括号里通常会给一个默认值，大多数情况是对的；但有些模型需要改。
• 不确定就查一下：用类似「某模型 + coding plan + base url」做关键词上网搜，或直接问 AI / 豆包。
• 默认值正确就直接回车进入下一步；不对就在提示后面贴上正确的 Base URL。

常见国内/常用大模型的 Base URL（均为 OpenAI 兼容格式，供参考，以各家官方文档为准）：

这三家都可作为 OpenAI 接口的「平替」：改 Base URL + 填对应 API Key + 选对模型名即可。

④ 选具体模型

• 同一家公司往往有多个模型（如 DeepSeek 早期 R1/V3，最近 V4，V4 还分 flash 和 pro）。
• 模型越强、适用场景越好，但消耗也越多；coding plan 的计费也与此相关，不可能无限用。
• 按编号选一个适合你需求的具体模型即可。

配置完模型，就可以直接用了——在命令行输入 hermes 进入 CLI 面板即可对话。后面配飞书、微信、Web UI 只是为了让使用更顺手，并非必须。

三、配置飞书

1. 前置准备（重点）

• 手机端 + 电脑端都要安装飞书，且需要一个有管理员权限的账号。
• 为什么要管理员权限：机器人是以「应用」形式存在的，需要管理员审核才能用。如果你在公司，应用要走技术负责人（管理员）审核会很麻烦。
• 解决办法：自己再注册一个账号当管理员——一个手机号可在飞书创建多个账号，自用完全没问题，这样就能自己免审。

2. 一键创建飞书机器人

• 创建机器人需在网页版飞书进行，先确保网页端已登录。
• 用工具提供的命令 / 链接进入创建页，选头像、取名字即可。
• 如果你之前创建过机器人，「已有应用」可通过一键处理帮你调整权限等，便于当前使用。
• 点「立即创建」后约 1 分钟内（往往不到 1 分钟） 创建完成，得到 App ID 和 App Secret（后续配对要用）。
• 即使关掉了这个界面也不要紧：重新进飞书开放平台 → 开发者后台，就能看到机器人和它的 App ID / App Secret。

3. 进入网关配置

• 配完大模型后，向导会问你是直接对话还是继续别的配置。配好就好，不耽误。

• 配飞书 / 微信的入口命令是网关配置（口播「hermes gateway set up」）：

  hermes gateway setup

• 进入后会列出可选平台（Telegram、Discord 等）。我们要配的是飞书和微信。

• 选飞书对应的编号——视频中飞书是 11（默认停在 21 之类的别的项，直接回车可能选错，要手动输入 11）。

⚠️ 注意：这里的平台编号（飞书 11、微信 14 等）以你当前版本向导实际显示的为准，不同版本可能变化。

4. 飞书具体配置项

进入飞书配置后依次：

1. 鉴权方式：默认是 1，但改用 2——使用 App ID + App Secret 的方式。
2. 填 App ID 和 App Secret：从开发者后台复制过来，先填 App ID 回车，再填 App Secret（密码性质，不显示），各粘一遍回车。
3. 国内版 / 国际版：选国内版（默认 1，直接回车即可）。
4. 配对方式：默认 1，用 1（配对码配对）。
   • 配对码是在 App ID + App Secret 基础上更进一步的安全机制，二者不冲突，前面的配置不会白做。
5. 群聊应答机制：可选「被 @ 时才回复」等，一般选 1 或直接回车即可。
6. 后面还有一个可选项，不用管直接回车。
7. 配好后回到配置界面，问是否继续配置——先不配，往下走。
8. 还会有一个与 gateway 相关的设置项，选 Y（允许） 让它完成配置即可。

5. 配对：拿配对码并完成绑定

⚠️ 前提：gateway 必须处于启动状态，否则收不到你的消息。前面其他命令行/界面关掉都没关系，但 gateway 要开着。

1. 回到命令行输入状态，启动网关：

   hermes gateway

2. 来到飞书（优先用电脑客户端）。创建机器人后，「开发者助手」会提醒你创建了一个 agent，打开该应用进入聊天界面。

3. 给机器人发一条消息打招呼，它第一次会和你认识一下，并回复一段配对相关消息（一句配对码命令）。

4. 另开一个命令行（启动 gateway 的那个不用动），把配对码命令复制过去执行，回车看到 approved 即配对成功，随后回到命令行输入状态，可关掉。

5. 这样飞书就配好、可以直接用了。

6. 验证

• ⚠️ 再次强调：gateway 必须一直开着（那一行 hermes gateway 在运行、不断刷日志），不要关，否则服务停了飞书里就不再回你。
• 在飞书里跟机器人交流，比如问「你有什么能力」。注意输入框旁有个「小人敲键盘」图标，表示它已收到你的消息正在回复。
• 如果没有这个图标，就别傻等——肯定是连接出问题了，去检查 gateway 状态。只要 gateway 在线，响应速度通常不错，小人一定会出现。

四、配置微信

微信比飞书更简单，不需要自己创建机器人。但有个明显短板：

• ⚠️ 微信只能绑一个机器人——绑了这个 AI 就绑不了另一个，控制数量太少。

配置步骤：

1. 同样运行 hermes gateway setup，选微信（WeChat）——视频中编号是 14。
2. 选择方式时选 Yes，会弹出一个链接 + 二维码。
3. 用你自己的微信扫码（方法和平时微信扫码一样）。
   • 若在服务器上、二维码渲染不出来，直接把那个链接粘到浏览器打开也能显示。
4. 扫码后确认连接（若之前连过别的，会提示解除旧连接、换新连接，按你情况确认即可），随后提示连接成功。
5. 配对提示选 1（用配对码）；群聊相关项保持默认即可，继续回车。
6. 绑定关系建立后，会让你重启 gateway，选 Yes 重启。
7. 重启完，微信配置就好了。

获取配对码（与飞书相同）：确保 gateway 启动 → 给机器人打招呼 → 它回配对码 → 把配对码粘到对应位置，提示 approved 即通过。之后就能在微信里和它聊天、让它自我介绍了。

五、配置 Web UI

• 官方版 Web UI：作者在原生 Windows 上没装成功；它在 WSL 上很容易用。作者个人感觉用不太上，官方版和第三方版都没怎么用过。（官方目前也有一个内置浏览器 Web UI 网关的特性请求在推进中。）

• 第三方版 Web UI：社区有多个开源项目，按需选用。常见的有：

  项目	说明
  nesquena/hermes-webui	较通用的 Hermes WebUI，支持 web/移动/桌面访问
  EKKOLearnAI/hermes-web-ui	多平台聊天、会话管理、定时任务、用量分析、渠道配置，含 Docker 文档
  JPeetz/Hermes-Studio	自托管面板：聊天、记忆、技能、终端、审批、多 Agent 编排
  sanchomuzax/hermes-webui	进程监控与配置面板
  praveenkay/Hermes_Portal	跨平台面板：会话、Agent、桌面、项目

  ⚠️ 以上为社区第三方项目，活跃度、成熟度与开源协议各不相同（个别项目可能已归档/停更）。安装前请先看其 README 确认维护状态，并注意它们会接入你的 Hermes，谨慎授权。视频作者当时用的也是其中某个第三方项目（让 Hermes 自己装的），他反馈比较占空间。

第三方版安装与使用：

1. 启动 hermes 进入交互后，直接让它帮你安装那个第三方 Web UI 项目（把上面某个项目地址给它）。
2. 过程中可能需要授权，同意即可。安装耗时可能比较长。
3. 安装好后，下次不会用就直接跟它说「运行一下 Hermes Web UI」，它会给你一个本地链接，复制到浏览器打开即可。
4. 首次使用做适配：打开设置（Preferences / 偏好），把语言设置成中文等你熟悉的语言。
   • 小问题：作者发现顶层菜单没有中文，但里面具体项目有中文，原因尚未完全弄清。
5. 使用建议：把 hermes 和 hermes gateway 都在命令行启动并最小化、不要关；配置相关操作在 Hermes 命令行界面做，具体工作则到飞书/微信里跟机器人沟通让它处理。

六、总结：特别注意事项

1. 网络环境很重要：作者试了两遍都没成功，调整网络后才顺利装下来。安装报错优先怀疑网络。
2. 没有免费的 token：费用一定要自己付。养 Agent 的 token 消耗其实很大，送的额度看着多其实不够用，务必买套餐。
3. 尽量多用飞书：飞书可接很多机器人，适配性好；微信只能绑一个、控制数量太少。刚开始用一个机器人、微信控制也行，但事情多了飞书更合适。
4. Web UI 看需求：作者自己用得少，更多还是在飞书界面交流；可以创建多个机器人 / Hermes 分身，按事项分开。官方版他没装成功，第三方版（让 Hermes 自己装的）比较占空间，按需取用。
5. 安装只是开始：Agent 越用越顺手，关键在后续通过 skill（技能）配置——后续大部分工作都靠 skill 完成。作者还做过知识库、skill、智能体安装等视频，建议多了解，这对用好甚至自己构建 Agent 都很重要。

七、常见问题与排查（视频坑点汇总）

• 安装失败 / 中途报错：首先怀疑网络环境（作者两次失败都是网络问题）。判断是否“卡住”看下载速度与已下载大小是否还在变动；红色报错只要没退回到命令输入态就继续等。
• hermes 命令找不到（not recognized）：原生 Windows 安装会改用户 PATH，新开一个终端让 PATH 生效；仍不行则确认 %LOCALAPPDATA%\hermes\hermes-agent 是否已克隆成功。
• 飞书/微信里机器人不回消息：确认 hermes gateway 正在运行且没被关掉；飞书看输入框旁有没有“小人敲键盘”图标，没有就是连接断了。
• 飞书应用无法使用：确认用的是有管理员权限的账号（免审），且机器人能力已开启。
• 配对拿不到配对码：确保 gateway 处于启动状态再给机器人发消息，否则它收不到。
• 微信只能绑一个机器人：这是机制限制，多机器人需求请用飞书。
• 官方版 Web UI 装不上：原生 Windows 上作者未成功，可改用 WSL2，或用第三方 Web UI 项目。

附：常用命令速查

常用模型 Base URL：DeepSeek https://api.deepseek.com｜MiniMax https://api.minimax.io/v1｜智谱 GLM https://open.bigmodel.cn/api/paas/v4/

说明：本文命令、编号、地址已对照 HermesAgent 官方文档及各模型官方文档核实（口播中的「hermes get away set up」「mini max / 质谱」「coding plan」等已修正为 hermes gateway setup / MiniMax / 智谱 / coding plan）。平台编号、向导选项与第三方项目可能随版本变化，实际请以你安装版本的提示及官方文档为准。

参考来源

• HermesAgent 安装指南
• Windows 原生安装指南
• 安装脚本 install.ps1
• 飞书 / Lark 接入
• DeepSeek API 文档
• MiniMax OpenAI 兼容接口文档
• 智谱 GLM（BigModel）
• 第三方 Web UI 项目：nesquena/hermes-webui、EKKOLearnAI/hermes-web-ui、JPeetz/Hermes-Studio