保姆级教程:Windows 原生安装 Hermes Agent 爱马仕(上)(2026年8月)

这篇教程写给谁

完全不懂编程、但想在自己 Windows 电脑上跑一个"AI 智能体（能写东西、调模型、多助手协作）"的人。哪怕你是高中生、从没敲过命令，跟着做也能装好。

你能得到什么：用一行命令或者Windows安装包，把 Hermes Agent（大家叫它"爱马仕 🐴"）装到 Windows 上，它自带开机自动运行，能接多种大模型、支持"多模型专家委员会"，并且知道怎么备份、怎么彻底卸载（不花一分钱）。

本文不依赖 WSL2（那是 Windows 里跑 Linux 的复杂功能）。Hermes 是 Python 技术栈，和 OpenClaw（Node 技术栈）是两个不同的工具，可以并存。

• ===上篇【本篇】===
• 第 0 章 开始之前：3 个关键提醒（新手必读，2 分钟）
• 第 1 章 Hermes 是什么（大白话）
• 第 2 章 你需要准备什么（要求 + 名词小课堂）
• 第 3 章 【准备】安装并升级 Windows 终端（强烈推荐，新手必看）
• 第 4 章 【可选】把 Hermes 装到 D 盘（省 C 盘空间）
• 第 5 章 方案一：通过安装脚本安装 Hermes
• 第 6 章 方案二：直接通过 Hermes Desktop 安装 Hermes
• ===中篇===
• 第 7 章 配置更多AI模型（让爱马仕能对话）
• 第 8 章 Hermes 连接 飞书Feishu
• ===下篇===
• 第 9 章 多模型：Profile 多进程 + MOA 专家委员会
• 第 10 章 备份与恢复（防"一删就没"）
• 第 11 章 彻底删除（零成本，别花钱找人代卸载）
• 第 12 章 与 OpenClaw 并存说明
• 第 13 章 常见问题与排错
• 第 14 章 常用命令速查
• 第 15 章 关于 WSL2 方式（一句话）
• 第 16 章 【可选 · 进阶】共享文档黑板：让 Agent 读写你的文件与 NAS
• 第 17 章 OpenClaw 与 Hermes 怎么选（核心结论）
• 第 18 章 参考资料

动手前先记住这 3 件事，能避开 90% 的坑：

① Hermes 自带"开机自启"，比小龙虾还省心。Hermes 的安装脚本一步到位：装完就自动注册好"开机自启"的计划任务。你不用像 OpenClaw 那样再单独执行一条命令。（但第 3 章还是会教你验证它真的在自启。）

② 想装到 D 盘省 C 空间？必须在"执行安装命令之前"设好！Hermes 比小龙虾占空间大（自带 Python、Node 等，全新约 1–2GB+）。如果你 C 盘紧，想装到 D 盘，得先设一个叫HERMES_HOME的环境变量再装——装完再设就无效了。第 3 章会在"执行安装"这步之前专门提醒你。

③ 你不需要 WSL2。WSL2 是 Windows 里跑 Linux 的复杂功能。Hermes 官方明确支持原生 Windows，纯 Windows 装最省心。

💡 这 3 条不用背，第 3 章会在最关键的节点再提醒你。

Hermes Agent（爱马仕 🐴）是 Nous Research 开源的"AI 智能体"，和 OpenClaw 类似，但技术底层不同（它是 Python 写的）。

它有两个很特别的能力，特别适合"让多个 AI 模型一起干活"：

• Profile（独立人格 / 分身）
  可以建多个互相隔离的 AI 分身，每个用不同模型、有不同的人设和记忆。比如一个分身用便宜模型写初稿，一个分身用强模型做研究。每个分身是完整独立的 agent（有工具、有记忆），但彼此隔离、没有原生通信通道——它们可以各自单独读写同一份文件，却看不到对方在做什么、无法实时交叉协作或辩论（真正的实时辩论还在开发路线图上，尚未实现）。想让多个分身"一起讨论"，目前只能你手动把一方的话贴给另一方。
• MOA（专家委员会 / Mixture of Agents）
  让好几个不同模型先各自给建议，最后由一个"聚合器"汇总拍板。注意：参考模型只当"顾问"、看不到工具（详见第 5 章）——它适合"一个难题多听几个角度"，不是"多模型互相辩论达成共识"。如果你要的是后者（真正多模型持久辩论），请用OpenClaw 的「多员工 + 共享黑板」；爱马仕内部的 Profile / MOA 都做不到实时互相辩论（注：这是指 Hermes 内部的多分身/MOA；Hermes 作为"一个整体 Agent"进群参与辩论是可行的——建一个飞书 bot、挂同一份共享黑板即可，详见选型对比 §2.1）。

💡 Hermes 还有网页控制面板和Desktop 桌面端（GUI）：装好后在浏览器 / 桌面里就能聊天、切模型、配 MOA 预设，不用敲命令。

安装脚本会自动处理Python、Node、Git，且装在 Hermes 自己的目录里，不污染你系统的 Python/Node。

• Windows 终端（命令行）
  Windows 自带的"输入指令让电脑执行"的窗口。
• 怎么打开
  开始菜单 → 搜"Windows 终端" → 右键"以管理员身份运行"。
• API Key（密钥）
  你向 AI 模型公司买的"账号密码"，长这样sk-xxx，千万别发给别人、别贴到网上。
• 模型提供商（供应商）
  提供 AI 能力的公司，如 Anthropic（Claude）、OpenAI（GPT）、智谱（GLM）、DeepSeek 等。
• 环境变量
  给程序看的"全局设置开关"。比如告诉 Hermes"把数据放 D 盘"，就是设一个名为HERMES_HOME的环境变量。
• 计划任务 / 开机自启
  Windows 的功能，让程序开机时自动偷偷运行。
• WSL2
  Windows 里跑 Linux 的功能，本文用不到。
• Gateway（网关 / 总控中枢）
  Hermes 在后台默默运行的那一个"大脑"程序，负责接收你的指令、去调用模型、管理各种连接。你装好的 Hermes 本体，主要就是它。后面反复出现的hermes gateway命令，就是在管它（启动、停止、看状态）。
• Profile（独立人格 / 分身）
  Hermes 的特色功能，可以建多个互相隔离的 AI 分身，每个用不同模型、有不同的人设和记忆（第 1 章讲过）。
• MOA（专家委员会 / Mixture of Agents）
  Hermes 的一种"虚拟模型提供商（供应商）"，让好几个不同模型先各自给建议、最后由一个"聚合器"汇总拍板（详见第 5 章；注意它不是"多模型互相辩论"）。

Windows 自带一个老旧的"命令提示符 / 旧版 Windows PowerShell 窗口"（叫 conhost）。它有两个坑：

• 版本老
  很多人的 Windows 终端 常年没升级，跑新命令可能报兼容错误。
• 显示乱码 / 二维码出不来
  飞书插件在配置时会弹出二维码让你用手机扫。老终端经常把二维码显示成一堆乱码、或直接报错，导致卡在这一步。

Windows 终端（Windows Terminal）是微软官方的现代终端，能正确渲染中文、二维码、彩色输出，还能开多个标签页。装它就是为了避免上面这些莫名其妙的麻烦。

✅ Windows 11 默认已经自带 Windows 终端（开始菜单搜"终端"能看到）。但你仍建议在 Microsoft Store 点一下"更新"确保是最新版。⚠️ Windows 10 大概率需要手动安装。

方法 A：Microsoft Store（最简单）

• 打开 Microsoft Store（微软商店）；
• 搜索Windows 终端或Windows Terminal；
• 点"获取 / 安装"。

方法 B：用系统自带命令装（如果装了 Microsoft Store 却搜不到）在任意终端里输入：

winget install --id Microsoft.WindowsTerminal -e

按回车，它会自动下载安装。

• 开始菜单 → 搜"终端"或"Windows Terminal"；
• 在结果上右键 → 以管理员身份运行（装软件、开自启这类操作需要这个）；

• 之后所有命令都在它里面敲，输入完按回车。

📌 记住这个动作，后面每一步都这么干。本文统一称它为"Windows 终端（管理员）"。

Hermes 全新安装约1–2GB+，比较占用空间。若 C 盘紧，想装到 D 盘，必须现在（执行安装命令之前）设好HERMES_HOME环境变量，否则装完再设无效。

在 Windows 终端 里执行（把D:\Data\hermes换成你想要的 D 盘路径）：

[Environment]::SetEnvironmentVariable("HERMES_HOME", "D:\Data\hermes", "User")$env:HERMES_HOME = "D:\Data\hermes"

💡 安装前设 HERMES_HOME（最关键），这是"最晚可操作节点"：环境变量必须在下一步的安装命令之前设。装完再设无效，只能重装。若 C 盘够用 / 懒得弄：跳过，直接用默认 C 盘（%LOCALAPPDATA%\hermes），完全没问题。

官方install.ps1会读取$env:HERMES_HOME，所有子路径（Python / Node / Git / 配置）都派生自它；不设则回退%LOCALAPPDATA%\hermes。

安装前，Windows 终端 里设好（用户级持久 + 当前会话生效）。

然后再跑一键安装命令。

💡 由于 Hermes 把运行环境都装在自身目录，删D:\Data\hermes即全清、不污染系统——后续章节中"彻底删除"删目录逻辑同样适用，只是路径从 C 变 D。

Hermes提供了多种安装方式，在2026年的8月，核心有两种主流的方式：

方案一：通过脚本安装Hermes。

这是最经典的方式。官方提供了一行安装脚本，在终端里以管理员身份运行，等待脚本全部执行完毕，就安装好了。这个脚本比较完善，一般情况下都能顺利安装，特殊情况下开启科学上网能解决。

方案一安装之后，网页端Web Dashboard、电脑端应用Hermes Desktop App，如果需要使用的话，首次需要先构建。

方案二：通过Hermes Desktop安装Hermes

官方提供了一个Windows的安装包，运行即可按提示安装。不过这个安装包对于一些异常情况（典型的连接Github失败或者不稳定）的处理不够好，很容易失败。

经过超哥反复测试，还是推荐大家优先选择方案一，更稳妥一些。

接下来，先介绍方案一：通过脚本安装Hermes。

跟着做，一共 4 个小步骤。

• 开始菜单 → 搜"Windows 终端" → 右键"以管理员身份运行" → 弹窗点"是"。
• 后面所有命令都在这黑窗口里输入，输完按回车。

Hermes 全新安装约1–2GB+，是两者里最占空间的一个。若 C 盘紧，想装到 D 盘，必须现在（执行安装命令之前）设好HERMES_HOME环境变量，否则装完再设无效。

在 Windows 终端 里执行（把D:\Data\hermes换成你想要的 D 盘路径）：

[Environment]::SetEnvironmentVariable("HERMES_HOME", "D:\Data\hermes", "User")$env:HERMES_HOME = "D:\Data\hermes"

💡 这是"最晚可操作节点"：环境变量必须在下一步的安装命令之前设。装完再设无效，只能重装。若 C 盘够用 / 懒得弄：跳过，直接用默认 C 盘（%LOCALAPPDATA%\hermes），完全没问题。

在终端（以管理员身份运行）里输入以下官方提供的一键安装脚本：

irm https://hermes-agent.nousresearch.com/install.ps1 | iex

有时会下载失败，多试几次，或者尝试科学上网即可解决。

脚本会自动：检测系统架构 → 装好 Python 3.11 + 便携 Node 22 + Git → 注册Windows 计划任务Hermes_Gateway实现开机自启。全程无需 WSL2。

📌Hermes_Gateway这个计划任务，管的是 Hermes 的Gateway（网关 / 总控中枢）——那是它在后台默默运行的那一个"大脑"程序，负责接收你的指令、去调用模型、管理各种连接。（Gateway 的更完整说明见第 2 章名词小课堂。）

安装差不多之后，会进入一个安装引导（Setup Wizard）。

如果发现你有安装OpenClaw的话，会问你是否从OpenClaw导入一些东西？

回答y的话，会给你展示下可以导入哪些

这里就选择n，不导入了。

然后问你，想要怎么安装Hermes爱马仕？

不要选方案1，方案1会引导你接入一个Hermes官方运营的API中转站，有好有坏吧，主要咱国内不方便用。

方案3，是最小化安装，其他都等之后再处理。

这里选择方案2给大家做一下演示：

这个意思是，让你选择AI模型。

咱们还是拿DeepSeek来示例，输入18（对应DeepSeek）后回车。

说没有发现DeepSeek的API key，让输入

输入咱们之前在DeepSeek创建的key，回车。

然后问咱们要Base URL。这个去DeepSeek的API文档中查询并确认：

DeepSeek的API文档中有写两种base_url，我们用第一种OpenAI兼容的那种，即https://api.deepseek.com

连接成功了，系统问我们用哪个具体的模型做默认？

建议选1，deepseek-v4-flash，这个做默认很合适。

又问终端后端（terminal backend）是哪个？

这个是指你的终端是通过什么来运行的，

建议维持现状，即选7

又问选择什么消息平台？这个对应的是小龙虾的Channel。

我们还是先选12，配置飞书这个平台。也可以先不设置。

二次确认，只需要回车就进入配置。

这里输入其他内容都会跳过。

由于后续我们会在Dashboard网页端或者Desktop应用端来配置，更加简单清晰，所以这里输入#号跳过了。

这里是给爱马仕的gateway做一下计划任务，以便让它在Windows启动时也自动启动gateway。输入y确认。

如果有安全软件拦截的话，记得放行。

问是否要安装一些CLI工具？

默认选中了一些，先回车确认。

会有很多选项，都先默认。

不确定的都选最后一项，保持默认或者稍后配置。

最后告诉你配置安装完成（Setup Complete），接下来给你展示一些信息，包括本地存储的地址、支持的命令等：

至此就安装完成。

在Windows终端中输入以下内容并回车：

hermes doctor          # 诊断环境，看状态目录是否指向你设的 D:\Data\hermes（若设了）

• 看 Windows 计划任务里有没有Hermes_Gateway，确认它已注册。
• 重启电脑后，不打开任何东西，执行hermes doctor仍能跑通，说明自启 OK。

⚠️ 若杀软把安装器内捆绑的uv.exe误报有毒，那是误报（false positive），把%LOCALAPPDATA%\hermes\bin加进杀软白名单即可。

Dashboard是Hermes提供的网页版管理后台，类似小龙虾的Dashboard。

在Windows终端中输入以下内容并回车：

hermes dashboard

第一次运行，Hermes需要先构建built一下这个Dashboard，之后会弹出网页。

构建完成后，会提示你访问网址，并且会自动弹出浏览器访问。

例如，示例中的访问网址是：http://127.0.0.1:9119

默认是英文的，左下角有一个切换语言的地方，点击切换为简体中文。

之后可以自行研究一下。

在Windows终端中输入以下内容并回车：

hermes dashboard

自动弹出并进入Hermes的Web Dashboard界面

一般网址是：http://127.0.0.1:9119

左侧菜单点击“CHANNELS”（频道或者渠道），右侧找到【Fishu/Lark】，这个就是飞书渠道的配置了。

点击右侧的“CONFIGURE”（配置），弹出配置界面：

核心是App ID和App Secret，这俩都是从飞书开放平台的应用中心里面创建智能体机器人之后获得。

配置完后，记得打开开关。

还可以做一下test测试，通了系统会提示你。

参考：

Desktop App | Hermes Agent https://hermes-agent.nousresearch.com/docs/zh-Hans/user-guide/desktop

这里提到一个非常有趣的事情，除了直接下载Hermes Desktop App之外，如果你已经通过命令行安装了Hermes，也是可以直接生成Desktop App的。

如果你已经安装好了Hermes，在终端中运行命令：

hermes desktop

这样将使用你当前的各种配置，构建Desktop App，并启动。

构建完成后，会自动打开运行Hermes.exe

在这个Desktop App中，也可以图形化完成各种配置，比较方便。

后面会介绍如何配置飞书渠道，以及配置大模型提供商（供应商），更换Hermes使用的默认模型等。

Hermes 可在 Windows 10 和 Windows 11 上原生运行——无需 WSL、Cygwin 或 Docker。

参考：

官方教程 windows-native | Hermes Agenthttps://hermes-agent.nousresearch.com/docs/zh-Hans/user-guide/windows-native#desktop-installer-alternative

官方提供了一个轻量 GUI 安装程序——如果你更倾向于双击.exe而非打开 Windows 终端，可以使用它。

下载 Hermes Desktop，运行安装程序，首次启动时 GUI 会在后台调用install.ps1来配置 Python（通过uv）、Node、PortableGit 以及下文描述的其余依赖引导流程。

首次运行后，桌面应用与 Windows 终端 安装的hermesCLI 共享同一个%LOCALAPPDATA%\hermes\hermes-agent安装目录和%USERPROFILE%\.hermes数据目录——可以在 GUI 和 CLI 之间自由切换。

如果你想要熟悉的 Windows 安装体验，或者要将 Hermes 交给非开发者使用，请使用桌面安装程序；如果你已经在终端中，请使用 Windows 终端 一行命令。

访问官网：

Hermes Agent — Open-Source AI Agent That Grows With You | Nous Researchhttps://hermes-agent.nousresearch.com/

官网明显位置就有Hermes Desktop App的下载链接。

Hermes 全新安装约1–2GB+，是两者里最占空间的一个。若 C 盘紧，想装到 D 盘，必须现在（执行安装命令之前）设好HERMES_HOME环境变量，否则装完再设无效。

在 Windows 终端 里执行（把D:\Data\hermes换成你想要的 D 盘路径）：

[Environment]::SetEnvironmentVariable("HERMES_HOME", "D:\Data\hermes", "User")$env:HERMES_HOME = "D:\Data\hermes"

💡 这是"最晚可操作节点"：环境变量必须在下一步的安装命令之前设。装完再设无效，只能重装。若 C 盘够用 / 懒得弄：跳过，直接用默认 C 盘（%LOCALAPPDATA%\hermes），完全没问题。

下载的Hermes Desktop安装包长这样：

双击进入安装界面：

这个安装程序也会把所有需要的组件都给装好。

在其中一个环节，会build构建 Desktop App。

典型的失败：

可能会失败。会展示失败的原因，也可以查看log文件确认更细节的问题。

怎么解决呢？扔给WorkBuddy分析一下，哈哈。

比如，我遇到的问题是：

1、npm版本不合适。WorkBuddy给的建议是降级npm的版本，然后重试安装。

2、git-fetch去拉取资源不稳定（你懂的）而失败。有时多试几次就行，有时科学上网全局模式可以缓解，但稳妥的方式是给git命令加上全局配置，用上你的代理。具体可以找WorkBuddy帮忙，用完记得再改回去。

安装完成

安装好之后，桌面上会有一个Hermes的图标，长这样：

双击Hermes图标，进入应用：

启动Desktop后的默认界面。

点击右上角齿轮状的“设置”图标，弹出设置界面：

点击左侧Appearance，然后Language位置，选择“简体中文”，就切换为中文了。

界面字体太小，下方界面缩放按需选择一下，立马好很多。

这样就完成了基本设置。

参考资料：

Windows 安装 Hermes Agent（含 Desktop），下载慢、装一半报错——我记录了三种可行的安装方式 - 知乎 https://zhuanlan.zhihu.com/p/2059781170011935625一次曲折的 Hermes Desktop 安装经历 · Bits & Keys https://cipeizheng.github.io/posts/hermes-install/国内安装 Hermes Agent 踩坑全记录：从 GitHub 超时到正常跑起来的每一步 - iTech - 博客园 https://www.cnblogs.com/itech/p/19862085从闪退到启动：Hermes 桌面版 Windows 安装踩坑汇总最近在 Windows 环境部署 Hermes 桌面版时 - 掘金 https://juejin.cn/post/7654526567432273955Hermes Desktop桌面版国内安装教程（附网络卡住解决方案）－论坛－深度科技 https://bbs.deepin.org.cn/zh/post/299269

至此，Hermes Agent的基本安装就已经全部完成了。

接下来我们还会做一下大模型的配置，并连接飞书，敬请期待中篇。

如有任何问题，欢迎留言讨论。