【最全亲测】Hermes桌面版安装、使用

Hermes的桌面版终于落地了，安装门槛一降到底，你还不试试吗？

这次不用CLI命令对话，直接一个桌面软件像电脑版微信一样。还可以单独配置手机端，本文顺便教你对接飞书手机端建立飞书应用智能体的方法。

废话不多说，一起来走一遍~

一、安装客户端：

1、下载地址：（苹果还是windows都能装，根据您电脑选择链接下载安装即可）

官网地址：https://hermes-agent.nousresearch.com/苹果版下载地址：https://hermes-assets.nousresearch.com/Hermes-Setup.dmg微软版下载地址：https://hermes-assets.nousresearch.com/Hermes-Setup.exe

2、进入安装程序，本文以Windows为例：

3、下载安装各种依赖

4、国内网友安装过程中必然遇到网络问题，三个办法，一个是XXX，一个是你电脑连手机上的热点尝试，第三个就是反复点蓝色按钮“Retry install”（经过我测试，虽然我的宽带国内网络节点也一般但是点了半个小时也还是连上了

只要有耐心就行）

5、连git都点了好久才能获取到。你也可以本地提前安装好，安装过的会检测跳过。

6、细心的观众能看到下图上右边一排的连接时间，最长的用了99分钟，这还不算网络问题循环点击重试的时间。所以桌面版这么安装虽然方便，但是就是要有耐心等。

7、装了3个小时终于安装完了。大功告成！

8、安装完成，桌面上也有个Hermes启动按钮。如果你想开机启动，可以把它放在启动目录，windows启动目录如下，在我的电脑中地址栏输入下面的地址即可。

%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup

如果你配置了飞书这样的通讯软件这个启动目录下会有Hermes_Gateway.vbs这个启动文件让网关静默启动，这样你不打开客户端只要打开电脑，也能通过飞书之类的即时通讯软件使用hermes-agent。

9、进入客户端

10、进入客户端配置，一个是进入官网选择订阅一些限量免费使用次数的模型，一个是直接用自己在国内大模型平台已经注册好的key填入。本文建议你提前准备好deepseek的模型key

这篇文章第三节就是介绍申请充值deepseek API的方法。很便宜，不信你就充值个10块钱试试吧。

#deepseek注册开放平台https://platform.deepseek.com/sign_in

12、选择deepseek，并粘贴好你刚申请的api key

13、选择模型，默认是Pro模型，建议你修改成flash模型暂时够用。

14、选择模型。

15、进入客户端聊天框，确认选择模型。就可以开始对话了！

如果你不需要对接飞书，到这里就可以开始使用了。

二、飞书网关配置：

1、首先你要有个飞书软件，并进入开发者中心。配置创建你自己的智能体。直接进入选择立即创建。

https://open.feishu.cn/app?lang=zh-CN

2、填写个名字即可。

3、创建过程很快，稍等即可。

4、创建成功后要复制出AppID 和密钥，准备填入hermes客户端。

5、特别注意还要配置“事件与回调”——加密策略要点击图上的圆圈箭头生成key，再把teken令牌复制下来准备填到hermes客户端。

6、hermes客户端页面中Messaging——Feishu/Lark——Feishu App ID ——Feishu App Secret——Encrypt key——Verification token依次根据下图填入。

1. 7、飞书开放平台 → 左侧【开发配置】→【事件与回调】→ 顶部切换【加密策略】标签

2. 复制两个值：

   • 事件校验令牌 → 粘贴到 HermesVerification token输入框

   • 加密密钥 → 粘贴到 HermesEncrypt key输入框

3. 基础配置补全：

   • Domain 填写feishu（国内企业固定值）

   • Allow all users 填true（测试阶段放开所有人访问，避免白名单拦截）

4. 点击右下角蓝色Save changes保存全部配置

8、 飞书应用权限 / 事件缺失（极易忽略）

1. 【事件与回调】右下角【添加事件】，必须订阅：

2. im.message.receive_v1 接收用户消息、p2p_chat_create 用户发起私聊会话

3. 左侧【权限管理】搜索开通权限：

4. im:message（收发消息）、contact:contact（读取用户信息）

5. 左侧【版本管理与发布】创建版本并发布到企业，未发布的权限 / 事件不会生效

三、HERMES官方模型订阅

1、在本文第一节第10步，可以选择使用HERMES官方模型，可订阅0元、20元、100元等。网页会自动跳转到下图页面。

2、选择任何订阅都会提醒你登录，本文使用github登录。

3、登录验证github密码。

4、验证邮箱

5、到邮箱读取邮箱验证码

6、填写好验证码提示连接成功。

7、选择订阅费用和录入能外币支付的银行卡（无论是否收费都需要填写）

8、走官方 Nous Portal 绑定通道（截图这个页面）必须填银行卡

哪怕是 0 元免费订阅，银行卡信息是强制必填项，绕不开。他的作用是人机 / 防刷验证。平台用 Stripe 校验支付方式，防止大量小号、机器人滥用免费模型额度，0 元套餐本身不会按月扣费，仅做身份核验。

国内可用Visa/Mastercard 外币信用卡，普通银联储蓄卡无法通过校验；绑卡时只会预授权小额验证（一般 1 美元内，几分钟原路退回），不会实际扣款。

不填卡无法完成订阅，也就拿不到官方 MiMo 模型免费额度、无法对接 Nous 云端服务。

9、本地离线/自定义 API 部署 Hermes 桌面版是完全不需要银行卡的。

Hermes 本体是开源程序，软件本身免费，有替代方案不用走 Nous 订阅：自己填入第三方模型 API Key（DeepSeek、OpenAI、通义千问等），全程不用进这个支付页面；本地部署开源大模型（Llama、Qwen、MiMo 本地版），离线运行，和 Nous 付费订阅无任何关联；适合没有外币信用卡、不想绑卡的你，唯一缺点是无法使用 Nous 官方提供的云端免费 MiMo 额度。

补充：如果你只是想快速体验官方免费模型，只能完成绑卡订阅；没有外币卡就只能走本地 API 前面教你的deepseek或离线部署；0 元订阅后续不会自动扣费，只有手动升级付费套餐才会产生账单，也随时可在 Nous 后台取消订阅。