Hermes Agent

Hermes Agent 是 Nous Research 開源的 AI 代理框架。提供 OpenAI 相容 API，具備跨對話記憶功能，可回顧過去的對話內容。完成的工作流程會存為可重用的技能檔案。內建網頁瀏覽及排程任務功能。

運作方式

此模板以 gateway 模式部署 Hermes Agent，在你的 Zeabur 實例上啟動 HTTP API 伺服器。API 遵循 OpenAI chat completions 格式，任何相容的客戶端都能連接。

代理本身不在本地運行 LLM 模型 — 它將請求轉發到外部供應商（OpenRouter、OpenAI、Anthropic 或你設定的任何 OpenAI 相容端點）。

使用方式

方式 1：連接聊天介面

在 Zeabur 部署 NextChat 或 Open WebUI 等前端，設定指向你的 Hermes Agent：

• API Base URL： https://<your-domain>
• 模型名稱： hermes-agent
• API Key： 留空（預設不需要）

方式 2：直接呼叫 API

# 發送訊息
curl https://<your-domain>/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model": "hermes-agent", "messages": [{"role": "user", "content": "你好"}]}'

# 列出可用模型
curl https://<your-domain>/v1/models

# 健康檢查
curl https://<your-domain>/health

方式 3：連接通訊平台

部署後在 Service > Variables 中新增 bot token：

• TELEGRAM_BOT_TOKEN — Telegram 整合
• SLACK_BOT_TOKEN + SLACK_SIGNING_SECRET — Slack 整合
• DISCORD_BOT_TOKEN — Discord 整合

主要功能

• 跨對話記憶 — 對話紀錄儲存在本地，可跨 session 搜尋
• 技能檔案 — 完成的多步驟工作流程存為可重用的技能定義
• 網頁存取 — 內建瀏覽器可讀取網頁；可選配 Exa/Firecrawl 搜尋整合
• 排程任務 — 基於 cron 的排程器，可設定重複性任務
• 多供應商 — 支援 OpenRouter、OpenAI、Anthropic 及自訂 OpenAI 相容端點

設定

必要： 至少一組 LLM 供應商 API 金鑰。

變數	用途
OPENROUTER_API_KEY	透過 OpenRouter 存取多種模型（建議入門使用）
OPENAI_API_KEY	直接使用 OpenAI 模型
ANTHROPIC_API_KEY	直接使用 Anthropic Claude 模型
LLM_MODEL	覆寫預設模型選擇
EXA_API_KEY	啟用 Exa 網頁搜尋
TELEGRAM_BOT_TOKEN	啟用 Telegram 機器人

選用變數請在部署後於 Zeabur Service > Variables 中設定。

注意事項

• RAM：最低 1 GB，建議 2-4 GB。瀏覽器自動化（Playwright）需要至少 2 GB。記憶體不足時代理可能會被系統終止。
• 首次部署需要幾分鐘（映像檔約 2.4 GB 壓縮），後續重啟從快取拉取，幾秒內啟動。
• 不需要 GPU — 代理透過 HTTP 呼叫外部 LLM API。
• 所有狀態（記憶、技能、設定）在重啟後保留。

授權

MIT — GitHub