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

多智能体编排第 2 / 6 篇

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

写作日期：2026-06-09｜复核：2026-09-07（隔三个月）

📌 2026-09-07 复核：本篇引用的链接、命令、Base URL 全部仍然有效，一处未改。

本文的说法 复核结果
原生安装脚本 install.ps1 ✅ 仍在
hermes gateway / hermes setup 等子命令 ✅ 全部仍在官方 CLI 参考里
DeepSeek https://api.deepseek.com（/v1 可选） ✅ 有效
MiniMax https://api.minimax.io/v1 ✅ 有效（见下方判据 ③ 的坑）
智谱 GLM https://open.bigmodel.cn/api/paas/v4/ ✅ 有效
五个第三方 Web UI 仓库 ✅ 五个都在（活跃度差别很大：18k star 的还在更新，也有半年没动的）
其中 EKKOLearnAI/hermes-web-ui 🚨 已改名为 hermes-studio，正文已更正

⚠️ 但上一期（P1）查出了三处漂移（Node 版本、pip 途径被弃用、hermes postinstall 已删）， 那三条同样适用于本篇的安装环节，装之前先看一眼 P1 顶部那张表。

📌 那个改名值得单独说：旧地址 301 跳到新名字，浏览器里点得开 —— 靠「点一遍看看」是发现不了的，得比对最终地址。 这和本站反复吃亏的形状一样：还能用，所以查不出来。

🔔 别靠「感觉过了挺久」判断要不要重验，跑这三条（零成本）：

# ① 原生安装脚本还在不在
curl -fsSL -o /dev/null -w '%{http_code}\n' \
  https://raw.githubusercontent.com/nousresearch/hermes-agent/main/scripts/install.ps1

# ② 正文用到的子命令是否还在官方 CLI 参考里（本文基线：全部命中）
curl -fsSL https://hermes-agent.nousresearch.com/docs/reference/cli-commands \
  | grep -oE 'hermes (setup|model|gateway|profile|config|dashboard|update|chat)' | sort -u

# ③ 三个 Base URL 是否还接受请求（用假 key，看到 401 就是对的）
for b in https://api.deepseek.com/v1 https://api.minimax.io/v1 https://open.bigmodel.cn/api/paas/v4; do
  printf '%s → ' "$b"
  curl -sS -o /dev/null -w '%{http_code}\n' -X POST "$b/chat/completions" \
    -H 'Authorization: Bearer sk-fake-probe' -H 'Content-Type: application/json' \
    -d '{"model":"x","messages":[]}'
done

🚨 第 ③ 条里有个坑，值得单独说：判据是「401 而不是 404」。 复核时我先用 GET 探根路径，MiniMax 的 /v1 返回 404，一度被记成坏链； 而 DeepSeek 的 /v1 返回 401。差别只是 MiniMax 没给根路径设路由 —— 改用 POST /chat/completions 加假 key 之后两家都是 401，Base URL 都是好的。 ⇒ 对 API 端点，401/403 恰恰证明服务活着；把 2xx 当作「链接有效」的唯一判据会误报一片。

〇、整体流程

整个过程大致分为四块：

  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 兼容格式，供参考，以各家官方文档为准）：

模型平台 Base URL 备注
DeepSeek https://api.deepseek.com 也可用 https://api.deepseek.com/v1（/v1 仅为 OpenAI SDK 习惯，非版本号）
MiniMax https://api.minimax.io/v1 OpenAI 兼容；用 Bearer Token 鉴权
智谱 GLM（BigModel） https://open.bigmodel.cn/api/paas/v4/ OpenAI 兼容；模型名如 glm-5.1

这三家都可作为 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-studio 多平台聊天、会话管理、定时任务、用量分析、渠道配置，含 Docker 文档。⚠️ 2026-09-07 复核：写作时叫 hermes-web-ui，已改名为 hermes-studio（旧地址仍 301 跳转，所以点得开、看不出来）
    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 项目。

附：常用命令速查

用途 命令 / 操作
以管理员打开 PowerShell Windows + R → 以管理员身份运行 PowerShell
安装 Hermes（原生 Windows） irm https://raw.githubusercontent.com/nousresearch/hermes-agent/main/scripts/install.ps1 | iex
启动 Hermes（命令行 / CLI 模式） hermes
配置通讯网关（飞书 / 微信等） hermes gateway setup
启动网关（飞书/微信生效，需保持开启） hermes gateway
运行第三方 Web UI 在 Hermes 中说「运行 Hermes Web UI」，用返回的本地链接
退出 / 停止 Ctrl + C

常用模型 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）。平台编号、向导选项与第三方项目可能随版本变化，实际请以你安装版本的提示及官方文档为准。

参考来源

← 返回 Agent 开发