Hermes Agent 是 Nous Research 开源的自主 AI 智能体框架,您可以将其部署在本地服务器上,接入多种大模型,它能跨会话记忆、自动创建技能并持续自我进化,完成复杂的自动化任务。本文以 Hy3 preview 模型为例演示如何将模型接入到 Hermes Agent 中使用。
安装 Hermes Agent
获取 API Key
1. 进入 API Key 管理 页面,单击创建 API Key。操作详情请参见 创建 API Key。
注意:
在设置可访问范围时,如果选择“限定范围”,则需要确保勾选 Hy3 preview。
2. 创建完成后,请您务必复制并妥善保管 API Key,在后续配置到工具的流程中将会使用该信息。

配置 Hermes Agent
注意:
配置步骤可能随 Agent 版本有所调整,请以您使用的版本为准。
1. 打开终端,运行以下命令:
hermes setup
2. 若您为安装后首次启动,终端会显示如下信息,选择
Quick setup — provider, model & messaging (recommended)。
注意:
若您之前已配置过 Hermes Agent,则运行 hermes setup 后,终端输出可能如下图示意,此时选择 Model & Provider 即可进入模型配置。

3. 完成选择后,终端将展示可选的模型 Provider,滚动到最下面选择
Custom endpoint,按回车键确认。
4. 配置模型信息:根据终端指引逐步填写相关配置。
终端提示信息 | 配置内容 |
API base URL [e.g. https://api.example.com/v1]: | https://tokenhub.tencentmaas.com/v1 |
API key [optional]: | 填写对应的 API Key |
API compatibility mode | 选择 Chat Completions |
Model name (e.g. gpt-4, llama-3-70b): | 填写 hy3-preview |
Context length in tokens [leave blank for auto-detect]: | 填写 256000 |
Display name | 填写 hy3-preview |
Terminal backend | 根据实际情况填写,如果本地安装则选择 Local |
Gateway working directory | 根据实际需求配置,可使用默认值 |
Enable sudo support | 是否允许使用 sudo,根据需求填写,选择使用 sudo 需输入密码 |

使用 Hermes Agent
完成配置后,在终端执行
hermes 命令,即可启动 Hermes 并使用 Hy3 preview 进行对话。
说明:
Hy3 preview 默认为极速响应(no_think)模式,受 Hermes Agent 当前适配限制,暂不支持切换思考模式。