Hermes Desktop 安装与 DeepSeek 模型配置：新手一篇跑通
这篇教程适合第一次安装 Hermes Agent Desktop 的朋友。本文演示从下载安装到接入 DeepSeek 模型的完整流程。
Hermes Agent Desktop 安装完成后，并不能直接使用。
它本质上是一个 Agent 桌面工具，需要先配置可用的大模型 API，才能正常对话和执行任务。
下面我们一步一步来。
一、安装前准备
在安装 Hermes Agent Desktop 之前，建议先确认网络环境是否正常。
由于安装过程中可能需要访问海外资源，建议先配置好科学上网，并使用TUN 混合模式或虚拟网卡模式。
同时，建议用管理员方式打开终端命令行。
Windows 检测方式
在 Windows 终端中输入：
curl.exe-Ihttps://www.google.comMac 检测方式
在 Mac 终端中输入：
curl-Ihttps://www.google.com如果能看到类似200 OK的返回结果，说明当前网络环境基本可用。
如果这里无法返回
200 OK，后面安装过程可能会出现下载失败、卡住、报错等问题。建议先处理网络环境，再继续安装。
二、打开 Hermes Agent 官网
打开 Hermes Agent 官网：
https://hermes-agent.nousresearch.com/进入官网后，点击右上角的Install。
三、下载对应系统安装包
进入安装页面后，根据自己的电脑系统，下载对应版本的安装包。
如果你是 Windows 电脑，就下载 Windows 版本。如果你是 Mac 电脑，就下载 Mac 版本。
本文下面以Windows 11为例继续演示。
四、以管理员方式运行安装包
安装包下载完成后，找到下载好的文件。
右键点击安装包，选择：
以管理员身份运行
打开安装界面后，点击：
Install Hermes
五、等待安装完成
接下来等待安装完成即可。
Hermes Agent Desktop 的安装时间可能会比较久，正常网络环境下，大概需要20～30 分钟。
安装过程中不要频繁关闭窗口。如果长时间卡住，优先检查网络环境是否稳定。
安装完成后，会进入 Hermes Desktop 主界面。
到这里，Hermes Agent Desktop 桌面版就安装完成了。
不过，此时还不能直接正常使用。
因为这类 Agent 工具还需要配置大模型 API。
六、为什么还要配置模型？
Hermes Agent Desktop 本身不是大模型。
你可以把它理解成一个Agent 桌面工作台。它负责对话界面、工具调用、任务执行和工作流管理。
但真正负责理解和生成内容的，是后面接入的大模型。
这里我们跳过 Hermes 官方模型 API 接入，改用国内性价比较高的DeepSeek API作为示例。
七、配置 DeepSeek 模型
首先打开 DeepSeek 开放平台官网：
https://platform.deepseek.com/进入平台后，需要完成实名验证和充值。
在用量信息页面，可以查看当前用量和余额。
八、创建 DeepSeek API Key
接下来进入API Keys页面。
在这里可以创建一个新的 API Key，用于接入 Hermes Agent。
点击创建后，平台会生成一串 Key。
请把它保存好。
注意：API Key 只会完整显示一次。建议复制后保存到安全位置，不要发给别人，也不要公开截图。
九、回到 Hermes Desktop 配置模型
回到 Hermes Desktop 主界面。
点击右上角的设置按钮。
进入设置后，依次选择：
提供方 → API 密钥 → DeepSeek
然后填入刚刚保存的 DeepSeek API Key。
Base URL 填写：
https://api.deepseek.com填写完成后，保存配置。
十、测试是否配置成功
配置完成后，可以先关闭科学上网。
回到 Hermes Desktop 主界面，在输入框里输入：
你好如果能正常返回回答，说明 Hermes Desktop 已经成功接入 DeepSeek 模型。
至此，Hermes Agent Desktop 桌面版就完整配置好了。
现在你就可以正常和它对话，也可以继续尝试让它执行任务了。
十一、常见提醒
最后补充几个容易踩坑的地方。
1. 安装前先检查网络
如果安装阶段报错，大概率和网络环境有关。
建议先用前面的curl命令确认能否正常访问。
2. 更新前也要保持网络连通
如果 Hermes 提示更新，点击更新前也要确认网络环境正常。
否则更新过程中可能会失败报错。
3. API Key 不要公开
DeepSeek API Key 相当于你的模型调用凭证。
不要发到群里，不要公开截图，也不要写进公开文档。
4. Base URL 不要填错
DeepSeek 的 Base URL 填写：
https://api.deepseek.com如果地址填错，Hermes Desktop 可能无法正常调用模型。
十二、配置卡住了怎么办？
如果你只是想学习，建议先按上面的步骤自己走一遍。
但如果你卡在网络环境、安装报错、DeepSeek API Key、Base URL、模型配置、Windows 权限，或者不想把时间花在环境排错上，也可以找熟悉这类工具的人协助处理。
小小 AI 主要提供 AI 工具安装配置、模型 API 接入、远程排错、本地模型部署和基础使用指导。 网站：
xiaoxiao-ai.com总结
整个流程可以简单理解为 4 步：
检查网络环境；
下载并安装 Hermes Agent Desktop；
创建 DeepSeek API Key；
在 Hermes Desktop 里配置 DeepSeek 模型。
如果你在安装或配置过程中卡住了，也可以留言告诉我：你是卡在安装、网络、DeepSeek API，还是 Hermes 设置页面？