Hermes Agent 桌面版上手教程（上）：下载安装 + 接入国内大模型

Hermes Agent 是由 Nous Research 开发的开源 AI 智能体框架。它不仅仅是一个聊天工具，更是一个可扩展的 AI 工作站——支持连接多种大模型、管理多平台消息、编写自定义技能、运行定时任务，甚至可以作为团队协作的 AI 助手。

不过，很多国内用户在初次接触时会被安装和配置环节卡住，尤其是如何接入国内大模型API这一环节。本文将手把手带你完成 Hermes Agent 的下载安装，并成功接入国产大模型。

一、安装方式选择

Hermes Agent 目前提供两种主流安装路径，根据你的操作系统和需求选择：

安装方式	支持平台	推荐人群
Hermes Desktop 安装器	macOS、Windows	新手首选，一键安装带图形界面
pip 命令行安装	Linux、macOS、WSL	开发者、服务器部署
Docker 容器安装	所有支持 Docker 的平台	沙箱隔离、云端部署

方式一：Hermes Desktop 安装器（推荐）

访问官方下载页面：hermes-agent.nousresearch.com/desktop，下载对应系统的安装包。安装完成后，打开桌面应用即可进入终端界面。

方式二：命令行安装（Linux 服务器）

一行命令完成安装：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | sh

安装完成后可以立即启动交互式设置向导：

hermes setup

这个向导会引导你完成 API Key 的配置、模型选择等步骤。

二、接入国内大模型

这是国内用户最关心的一步。Hermes Agent 本身没有内置国内大模型的专门提供商，但好消息是——它支持 OpenAI 兼容模式，而 DeepSeek、智谱 AI、硅基流动（SiliconFlow）等国内服务商都提供了 OpenAI 兼容的 API 接口。

方案一：接入 DeepSeek

DeepSeek 提供与 OpenAI 完全兼容的 API，配置步骤如下：

1. 在 platform.deepseek.com 注册账号并获取 API Key
2. 运行配置命令：

   hermes config set provider openai
   hermes config set openai_api_base https://api.deepseek.com/v1
   hermes config set openai_api_key 你的DeepSeek API Key
   hermes config set model deepseek-chat

3. 运行 hermes 启动对话，测试是否正常回复

方案二：通过 SenseNova Token Plan 接入

SenseNova（商汤日日新）的 Token Plan 提供了免费的 API 调用额度，同样兼容 OpenAI 协议：

hermes config set provider custom
hermes config set custom_api_base https://token.sensenova.cn/v1
hermes config set custom_api_key 你的Token Plan Key
hermes config set model deepseek-v4-flash

方案三：接入硅基流动（SiliconFlow）

硅基流动聚合了包括 Qwen、DeepSeek、GLM 在内的数十个模型，配置方式：

hermes config set provider openai
hermes config set openai_api_base https://api.siliconflow.cn/v1
hermes config set openai_api_key 你的SiliconFlow Key
hermes config set model Qwen/Qwen2-72B-Instruct

三、验证安装

配置完成后，启动一个简单对话来验证：

# 启动 Hermes
hermes

# 如果一切顺利，你会看到终端进入对话模式
# 输入一个问题测试：
❯ 你好，请用中文介绍一下你自己

# Hermes 会调用配置好的大模型回复你
# 如果没有回复或提示错误，运行诊断工具：
hermes doctor

如果 hermes doctor 没有报错，说明安装和配置都已成功。此时你可以尝试使用一些内置功能：

命令	功能
hermes -c	恢复上一次对话
hermes model	切换模型和提供商
hermes skills	浏览和安装技能
hermes gateway setup	配置消息平台网关（微信/Telegram等）

四、常见问题排查

如果遇到问题，按这个顺序排查：

症状	原因	解决方法
回复为空或报错	API Key 或模型名错误	运行 hermes model 重新配置
接口返回乱码	base_url 或模型不兼容	先在其他客户端验证接口再配置
hermes doctor 报错	配置文件缺失或格式错误	运行 hermes setup 重新配置

📌 下期预告：Hermes Agent 桌面版上手教程（下）将讲解如何编写自定义技能、配置消息网关将 Hermes 接入微信、以及设置定时任务自动化工作流。敬请期待！