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 嗎？請在部署後新增對應的環境變數——詳見下方的模型與供應商及訊息平台。

Port 與網域

此服務提供兩個 HTTP port：

Port	Id	用途	網域
9119	web	網頁 Dashboard（預設開啟，已帶登入）	服務的主網域——開啟後登入即可
5000	api	OpenAI 相容 API 伺服器	僅在需要外部 API 存取時才綁定網域

訊息平台（Telegram、Discord、Slack 等）使用對外連線，不需要公開網址或開放任何 port。

使用網頁 Dashboard

Dashboard 預設開啟並帶登入保護。開啟服務的網域（web port）後登入：

• 帳號：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 port（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 授權條款 釋出。