这篇教程适合第一次安装 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 的安装时间可能会比较久正常网络环境下大概需要2030 分钟。安装过程中不要频繁关闭窗口。如果长时间卡住优先检查网络环境是否稳定。安装完成后会进入 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 设置页面