Hermes Agent

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

快速开始

1. 部署此模板 — 填入 OpenRouter API 密钥（必填），以及可选的 Telegram Bot Token。
2. 绑定域名 — 前往「网络」标签页，根据需求将域名绑定到对应的端口（详见下方「端口与域名」）。
3. 开始使用 — 通过网页 Dashboard、Telegram 或 OpenAI 兼容 API 操作您的 Agent。

端口与域名

此服务提供两个独立的 HTTP 端口，请只为实际需要的端口绑定域名：

端口	用途	何时需要绑定域名
5000	OpenAI 兼容 API 服务器	仅在需要外部 API 访问时（curl、SDK 等）
9119	网页 Dashboard（需设置 HERMES_DASHBOARD=true）	仅在需要浏览器界面时

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

使用 OpenAI 兼容 API

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

curl https://YOUR_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

1. 在「变量」标签页设置 HERMES_DASHBOARD=true 并重启服务。
2. 在「网络」标签页将域名绑定到 端口 9119。
3. 通过该域名访问 Dashboard。

安全提示： Dashboard 将可从互联网公开访问。请在了解风险后再启用——任何知道网址的人都能访问并控制您的 Agent。可通过 HERMES_DASHBOARD_OAUTH_CLIENT_ID 配置 OAuth 验证（详见环境变量参考文档）。

消息平台

部署时默认设置 Telegram 作为示例。您可以在部署后设置对应的环境变量，启用 14+ 支持平台中的任一个（Discord、Slack、WhatsApp、Signal、Matrix、Email、微信、企业微信、飞书、钉钉、QQ Bot、Mattermost、BlueBubbles/iMessage、SMS、Home Assistant、通用 webhook）。

详见官方 Messaging Gateway 指南。

使用 Zeabur AI Hub（OpenRouter 替代方案）

除了 OpenRouter，也可以使用 Zeabur AI Hub — 一个 OpenAI 兼容的 LLM 聚合服务。部署后：

1. 把 AI Hub 密钥填入 OPENROUTER_API_KEY（沿用同一个变量）。
2. 通过 Zeabur「文件」标签页编辑 /opt/data/config.yaml：
   • model.base_url: "https://sfo1.aihub.zeabur.ai/v1"（Tokyo 用 hnd1）
   • model.default: "claude-sonnet-4-5"（或任一 AI Hub 模型）
3. 重启服务。

注意：OPENROUTER_BASE_URL 环境变量无法覆盖 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 镜像约 4.5 GB（含 Playwright + Chromium 浏览器自动化工具）。首次部署拉取镜像可能需要数分钟。
• 首次启动需要 30-60 秒来初始化配置文件和同步技能。
• 使用浏览器工具可能导致内存占用过高，若遇到 OOM（内存不足）错误，建议升级至更大的实例（推荐 4 vCPU / 8 GB RAM）。

许可证

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