Hermes Agent

Hermes Agent 是由 Nous Research 開發的自主 AI 代理，具備持久記憶、40 多種內建工具、排程任務及多平台訊息整合。

快速開始

1. 部署此模板 — 填一個 Dashboard 網域（例如 my-hermes）。選填：現在就設定你的 LLM 供應商，填入 LLM_API_KEY、LLM_BASE_URL、LLM_MODEL（任何 OpenAI 相容供應商）；留空則稍後再設定模型。
2. 開啟 Dashboard — 前往你的網域（已自動綁定到 Dashboard）。之後可在「網路」分頁綁定自訂網域。
3. 登入 — 帳號 admin，密碼為服務的 PASSWORD（顯示於服務說明中）。直接在瀏覽器裡對話——不需要 Telegram。

想改用其他供應商或 Telegram 嗎？請設定你的 OpenAI 相容供應商變數（LLM_API_KEY / LLM_BASE_URL / LLM_MODEL），並在部署後新增訊息平台的環境變數——詳見下方的模型與供應商及訊息平台。

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 指南。

模型與供應商

此模板可搭配你自備的任何 OpenAI 相容供應商運行。請在「變數」分頁設定以下項目並重啟：

• API 金鑰 — 把 LLM_API_KEY 設為你的供應商金鑰。
• 端點 — 把 LLM_BASE_URL 設為供應商的 OpenAI 相容 base URL，例如 https://api.openai.com/v1。若設定了金鑰卻把 base URL 留空，Agent 會報錯直到你填入——這是刻意設計，讓設定錯誤顯而易見。
• 模型 — 把 LLM_MODEL 設為模型 id，例如 gpt-4o-mini。
• 其他供應商（Minimax、Kimi、GLM/智譜、Gemini、NVIDIA、xAI……）— 為該供應商設定 LLM_API_KEY / LLM_BASE_URL / LLM_MODEL，或新增該供應商自己的 API 金鑰環境變數（例如 KIMI_API_KEY、MINIMAX_API_KEY），並在「Exec」分頁用 hermes model 選擇模型。詳見 Configuration 指南與環境變數參考。

當設定了 LLM_API_KEY 時，LLM_API_KEY ／ LLM_BASE_URL ／ LLM_MODEL 會在每次啟動時套用到 /opt/data/config.yaml 的 model 區塊（provider 為 custom）。若想自行手動管理 config.yaml，把 LLM_API_KEY 留空即可。

設定

• 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 授權條款 釋出。