Hermes Agent

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

快速開始

1. 部署此模板 — 填入 OpenRouter API 金鑰（必填），以及選填的 Telegram Bot Token。
2. 存取 API 伺服器 — 部署完成後，您的實例會在網域上提供 OpenAI 相容端點。
3. 使用 API — 使用自動產生的 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!"}]}'

訊息平台

部署時預設設定 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 — 所有環境變數
• 編輯後需重啟服務以套用變更。

注意事項

• Docker 映像檔約 4.5 GB（含 Playwright + Chromium 瀏覽器自動化工具）。首次部署拉取映像檔可能需要數分鐘。
• 首次啟動需要 30-60 秒來初始化設定檔和同步技能。
• 使用瀏覽器工具可能導致記憶體用量過高，若遇到 OOM（記憶體不足）錯誤，建議升級至較大的實例（建議 4 vCPU / 8 GB RAM）。

授權

Hermes Agent 由 Nous Research 以 MIT 授權條款 釋出。