Hermes Agent

Hermes Agent 是由 Nous Research 开发的自主 AI 代理，具备持久记忆、40 多种内置工具、定时任务及多平台消息集成。

快速开始

1. 部署此模板 — 生成一组 Zeabur AI Hub 密钥，并填一个 Dashboard 域名（例如 my-hermes）。就这样，Agent 与 Dashboard 开箱即用。
2. 打开 Dashboard — 前往你的域名（已自动绑定到 Dashboard）。之后可在「网络」标签页绑定自定义域名。
3. 登录 — 账号 admin，密码为服务的 PASSWORD（显示在服务说明中）。直接在浏览器里对话——不需要 Telegram。

想改用 OpenRouter、其他供应商（Minimax、Kimi……）或 Telegram 吗？请在部署后新增对应的环境变量——详见下方的模型与供应商及消息平台。

端口与域名

此服务提供两个 HTTP 端口：

端口	Id	用途	域名
9119	web	网页 Dashboard（默认开启，已带登录）	服务的主域名——打开后登录即可
5000	api	OpenAI 兼容 API 服务器	仅在需要外部 API 访问时才绑定域名

消息平台（Telegram、Discord、Slack 等）使用出站连接，不需要公开 URL 或开放任何端口。

使用网页 Dashboard

Dashboard 默认开启并带登录保护。打开服务的域名（web 端口）后登录：

• 账号：admin
• 密码：服务的 PASSWORD 值（显示在服务说明中）

若要停用，在「变量」标签页把 HERMES_DASHBOARD 设为 false。若要修改账密，设置 HERMES_DASHBOARD_BASIC_AUTH_USERNAME ／ HERMES_DASHBOARD_BASIC_AUTH_PASSWORD。

安全提示： Basic auth 登录适合受信任网络后方的后端；若需要更强的公网防护，请改用 OAuth（HERMES_DASHBOARD_OAUTH_CLIENT_ID）或自建 OIDC（HERMES_DASHBOARD_OIDC_*），详见环境变量参考文档。

使用 OpenAI 兼容 API

在「网络」标签页将域名绑定到 api 端口（5000），再使用自动生成的 API 密钥（显示在服务说明中）发送请求：

curl https://YOUR_API_DOMAIN/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_SERVER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "default", "messages": [{"role": "user", "content": "Hello!"}]}'

消息平台

消息平台为可选——默认通过网页 Dashboard 交互（不需要任何平台）。若要连接 Telegram，请在「变量」标签页新增 TELEGRAM_BOT_TOKEN（向 @BotFather 获取）与 TELEGRAM_ALLOWED_USERS（你的 Telegram 用户 ID，向 @userinfobot 获取），然后重启服务。Hermes 支持 14+ 种平台（Discord、Slack、WhatsApp、Signal、Matrix、Email、微信、企业微信、飞书、钉钉、QQ Bot、Mattermost、BlueBubbles/iMessage、SMS、Home Assistant、通用 webhook）——每一个都是在部署后设置其环境变量即可启用。

详见官方 Messaging Gateway 指南。

模型与供应商

开箱即用时，此模板使用 Zeabur AI Hub（密钥来自「Zeabur AI Hub 密钥」变量）、模型 claude-sonnet-4-5、区域 sfo1。若要调整，请在「变量」标签页新增以下项目并重启：

• 模型 — 把 LLM_MODEL 设为任一 AI Hub 模型。
• 区域 — 把 LLM_BASE_URL 设为 https://hnd1.aihub.zeabur.ai/v1 即可使用东京（默认为 sfo1）。
• 改用 OpenRouter — 设置 OPENROUTER_API_KEY（并把 AI Hub 密钥留空），Hermes 会自动检测。
• 其他供应商（Minimax、Kimi、GLM/智谱、Gemini、NVIDIA、xAI……）— 新增该供应商的 API 密钥环境变量（例如 KIMI_API_KEY、MINIMAX_API_KEY），并在「Exec」标签页用 hermes model 选择模型。详见 Configuration 指南与环境变量参考。

LLM_MODEL ／ LLM_BASE_URL 加上 AI Hub 密钥会在每次启动时应用到 /opt/data/config.yaml 的 model 区块。若想自行手动管理 config.yaml，将它们留空即可。

配置

• LLM 供应商、工具及其他设置 — 请参阅官方 Configuration 指南和环境变量参考。
• 通过 Zeabur「文件」标签页编辑 /opt/data/ 中的配置文件：
  • config.yaml — 模型选择、终端后端、平台设置
  • SOUL.md — 代理人设与系统提示词
  • .env — 所有环境变量
• 编辑后需重启服务以应用更改。

CLI 操作

通过 Zeabur Exec 标签页（或 zeabur service exec）可直接使用 Hermes CLI：

命令	说明
hermes	交互式聊天（REPL）
hermes --tui	现代终端 UI
hermes -z "prompt"	单次查询（适合脚本）
hermes status	查看所有组件状态
hermes model	切换模型／供应商
hermes config	查看或编辑配置
hermes sessions list	列出对话记录
hermes -c	继续上次对话
hermes cron	管理定时任务
hermes skills	浏览与安装技能

执行 hermes --help 查看完整命令列表。

注意事项

• Docker 镜像约 1.3 GB（下载大小）。首次部署通常一分钟内即可拉取完成；之后的部署会重用缓存镜像。
• 首次启动需要 30-60 秒来初始化配置文件和同步技能。
• 使用浏览器工具可能导致内存占用过高，若遇到 OOM（内存不足）错误，建议升级至更大的实例（推荐 4 vCPU / 8 GB RAM）。

许可证

Hermes Agent 由 Nous Research 以 MIT 许可证 发布。