Hermes Agent

Hermes Agent 是 Nous Research 开发的开源 AI 智能体，支持接入 OpenAI 兼容接口。

Hermes 可能读取文件、执行终端命令或连接消息平台。请先确认权限范围，不要在生产账号或敏感环境中直接执行高风险操作。

安装 Hermes Agent

Windows

使用 PowerShell 运行：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安装完成后，关闭并重新打开 PowerShell，再验证：

hermes --version

macOS / Linux / WSL2

在终端运行：

安装完成后，重新加载 Shell：

验证安装：

执行命令后会自动检测并安装所需依赖。

安装脚本会在本机执行命令。请确认链接为 Hermes 官方地址；在企业设备或生产环境中，建议先完成内部安全评估。

配置 Hermes Agent

1. 获取 Tokenhot API Key

前往 Tokenhot 控制台创建 API Key。

2. 配置模型供应商

安装完成后，打开新的终端并运行：

在模型供应商列表中选择 Custom Endpoint 或 OpenAI-compatible endpoint。

不同 Hermes 版本中的选项顺序可能不同，请按名称选择，不要依赖固定序号。

填写以下信息：

配置项	值
API Base URL	`https://api.tokenhot.cn/v1`
API Key	你的 Tokenhot API Key
Model	从 Tokenhot 模型列表复制完整模型 ID
Context Length	按模型实际上下文填写，建议不低于 `64000`
Provider Name	`tokenhot`（可自定义）

如果暂时不需要 Telegram、Discord、浏览器、定时任务等功能，可在配置过程中选择跳过；后续可再次运行配置命令启用。

Hermes 会将密钥和配置保存到本地。不要将包含 API Key 的配置文件提交到 Git 仓库或分享给他人。

3. 验证连接

配置完成后，运行：

发送一条简单消息，例如：

你好，请简要介绍你自己。

收到正常回复即表示 Tokenhot 已配置成功。

常见问题

连接失败

请检查：

API Base URL 是否为 https://api.tokenhot.cn/v1

API Key 是否有效

模型 ID 是否存在且支持 OpenAI 兼容协议

当前网络是否可访问 Tokenhot API

不知道选择哪个模型

请前往 Tokenhot 模型列表查看可用模型，并复制完整模型 ID。

建议先使用成本较低的模型测试连通性，再切换到更强的模型处理复杂任务。

hermes

Hermes Agent#

安装 Hermes Agent#

Windows#

macOS / Linux / WSL2#

配置 Hermes Agent#

1. 获取 Tokenhot API Key#

2. 配置模型供应商#

3. 验证连接#

常见问题#

连接失败#

不知道选择哪个模型#