Hermes Agent Linux 安装接入 KoalaAPI

访问地址：https://koalaapi.com（OpenAI 兼容接口在末尾加 /v1）。

配置速查

配置项	填写内容
Base URL	`https://koalaapi.com`；OpenAI 兼容接口填 `https://koalaapi.com/v1`
API Key	控制台 → 令牌管理创建的令牌，形如 `sk-...`
模型名称	与控制台【模型广场】完全一致；不同令牌分组可用的模型不同

1、什么是 Hermes Agent

Hermes Agent 是 Nous Research 开源的 AI 智能体。它可以长期运行在你的服务器上，记住学到的内容，支持 Linux、macOS、WSL2 和 Windows 原生，一条命令即可安装。

在服务器终端执行（官方安装脚本）：

安装完成后重新加载环境变量：

（截图待补）

执行：

在供应商列表中选择 Custom endpoint（列表序号会随版本变化，按名字找即可）。

（截图待补）

然后依次填写：

API base URL：KoalaAPI 接口地址，末尾加 /v1，例如 https://koalaapi.com/v1

API key：你在 KoalaAPI 创建的令牌

Model name：模型广场里的模型名

如果提示填写上下文长度，填 64000 或以上（Hermes 要求模型上下文至少 64K）

（截图待补）

注意：

处于国内网络，URL 改成下面其中之一（url 末尾加上 /v1）：

（截图待补）

（截图待补）

配置保存在 ~/.hermes/config.yaml，以后想换模型或地址，重新执行 hermes model 即可。

更新于 2026-11　官方文档：https://hermes-agent.nousresearch.com/