Hermes Agent Docker：2026 年完整部署指南

兩種 Docker 模式說明 - 開始之前選擇

大多數指南完全跳過此決定並跳到 docker run。不。這兩種模式具有明顯不同的安全性和操作設定檔。

模式 1 — Hermes 在容器內運行

Hermes 及其所有相依性都位於影像內。您可以透過命名磁碟區來管理狀態。容器重新啟動策略使其在重新啟動後保持活動狀態。這是最常見的生產模式。

• 與主機完全分離—不會意外寫入您的機器
• 完全的便攜性；使用相同的撰寫文件在任何地方重新部署
• 開銷比本地運行稍高

模式 2 — Docker 作為終端後端沙箱

在這裡，Hermes 直接在主機（或容器中）運行，並呼叫 Docker 守護程序來啟動臨時容器以執行 shell。您可以透過設定 DOCKER_HOST 來設定它，以便 Hermes 可以存取守護程式：

export DOCKER_HOST=unix:///var/run/docker.sock   # Linux
export DOCKER_HOST=tcp://host.docker.internal:2375  # Windows/Mac (Docker Desktop)

先決條件和環境設置

在拉取任何鏡像之前，請確認：

• Docker Engine 24+ 或者 Docker Desktop 4.26+
• 準備 LLM API 金鑰：OpenAI (OPENAI_API_KEY)、Anthropic (Anthropic_API_KEY) 或本地 Ollama 端點
• 連接埠 443 上的出站網際網路存取（用於 LLM API 呼叫）
• 至少 2 GB RAM 分配給容器（對於 Ollama 支援的設置，建議使用 4 GB）

Windows-特定設定（Docker 桌面 + WSL2）

Windows 是大多數 Docker 部署悄悄崩潰的地方。注意這些：

# Correct — Docker Desktop translates this automatically
volumes:
  - hermes_data:/root/.hermes

DOCKER_HOST=npipe:////./pipe/docker_engine

[wsl2]
memory=4GB
processors=2

快速入門－5分鐘使用Docker運行Hermes Agent

拉取官方鏡像並執行安裝精靈：

# Pull the latest image
docker pull nousresearch/hermes-agent:latest

# Run with a persistent volume for state
docker run -it \
  -v hermes_home:/root/.hermes \
  -e OPENAI_API_KEY=your_key_here \
  nousresearch/hermes-agent:latest

這 設定嚮導 首次運行時啟動。它會提示您：

1. 選擇您的 LLM 提供者（OpenAI、Anthropic、Ollama 或自訂端點）
2. 輸入您的 API 金鑰或端點 URL
3. 配置終端後端（本機或 Docker 沙箱）

完成後，驗證會話是否正常運作：

> hello

使用 Docker Compose 進行生產部署

裸 docker run 指令適用於測試。對於任何持久性的事情，請使用 Compose。

version: "3.9"

services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes-agent
    restart: unless-stopped
    stdin_open: true
    tty: true

    environment:
      # Use environment secrets — never hardcode keys in compose files
      OPENAI_API_KEY: ${OPENAI_API_KEY}
      Anthropic_API_KEY: ${Anthropic_API_KEY}
      HERMES_LOG_LEVEL: info

    volumes:
      - hermes_home:/root/.hermes         # Config + conversation history
      - hermes_skills:/root/.hermes/skills # Skill store — see next section

    deploy:
      resources:
        limits:
          memory: 2G
          cpus: "1.5"

    healthcheck:
      test: ["CMD", "hermes", "--health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 15s

    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"

volumes:
  hermes_home:
  hermes_skills:

將您的 API 金鑰儲存在 .env 檔案中（從不提交版本控制）：

OPENAI_API_KEY=sk-...
Anthropic_API_KEY=sk-ant-...

在容器重建過程中保留 Hermes 技能

這是最容易被忽略的生產問題。愛馬仕商店將技能與一般配置分開學習。明確掛載這些路徑：

更新影像時：

docker compose pull
docker compose up -d   # Named volumes persist automatically

進階拓撲 - 主機-Docker（同級容器）設置

當您希望 Hermes 編排同級容器以實現隔離的程式碼執行時，可以使用此架構 - 例如，安全地執行使用者提交的程式碼。

┌─────────────────────────────────┐
│         Docker Host             │
│                                 │
│  ┌──────────────┐               │
│  │ hermes-agent │◄──socket──────┤── /var/run/docker.sock
│  │  container   │               │
│  └──────┬───────┘               │
│         │ docker run (sibling)  │
│  ┌──────▼───────┐               │
│  │  sandbox-1   │  (ephemeral)  │
│  └──────────────┘               │
└─────────────────────────────────┘

為該拓撲編寫配置：

services:
  hermes:
    image: nousresearch/hermes-agent:latest
    restart: unless-stopped
    environment:
      OPENAI_API_KEY: ${OPENAI_API_KEY}
      DOCKER_HOST: unix:///var/run/docker.sock
      HERMES_TERMINAL_BACKEND: docker
    volumes:
      - hermes_home:/root/.hermes
      - /var/run/docker.sock:/var/run/docker.sock  # Socket mount
    group_add:
      - "999"   # docker group GID — adjust to match your host

透過 Telegram Bot 將 Hermes 連接到 Claude

No 書面指南目前涵蓋了這一點 - 它僅以視訊形式顯示。這是完整的設定。

/newbot
→ Name: Hermes Agent
→ Username: your_hermes_bot
→ Save the token: 123456:ABC-DEF...

environment:
  Anthropic_API_KEY: ${Anthropic_API_KEY}
  HERMES_LLM_PROVIDER: Anthropic
  HERMES_TELEGRAM_TOKEN: ${TELEGRAM_BOT_TOKEN}
  HERMES_TELEGRAM_ALLOWED_USERS: "your_telegram_user_id"

docker compose up -d

多架構部署（ARM64 / Oracle 免費方案 / Raspberry Pi）

nousresearch/hermes-agent 映像是作為多架構清單提供。支援 ARM64 — 在 ARM 主機上明確拉取它：

# Oracle Free Tier (Ampere A1) or Raspberry Pi 4/5
docker pull --platform linux/arm64 nousresearch/hermes-agent:latest

# Verify the architecture
docker inspect nousresearch/hermes-agent:latest | grep Architecture

已知的 ARM 特定問題：

• 一些 Ollama 模型量化 (Q8) 在 ARM 上運行速度較慢；偏好 Q4_K_M 進行本地推理
• 如果您點選 exec format error，請確認您正在使用 --platform linux/arm64 標誌
• Apple Silicon 上的 Docker Desktop 原生處理 ARM — 無需平台標誌

排除常見的 Hermes Agent Docker 故障

您最有可能遇到的故障的參考表：

常見問題

最後的想法：清單和後續步驟

學習循環是 Hermes 與您在 Docker 中運行的所有其他代理程式的區別所在。上面的設定確保循環實際上 累積 - 不會重置 - 每次發布更新時。

在調用部署生產就緒之前，請確認：

• ☐ 為 hermes_home 和 hermes_skills 所建立的命名卷
• ☐ API 金鑰儲存在 .env 中，未在 compose 中硬編碼
• ☐ restart: unless-stopped 策略處於作用中狀態
• ☐ 健康檢查通過：docker inspect hermes-agent --format='{{.State.Health.Status}}'
• ☐ 設定日誌輪替（max-size、max-file）
• ☐ 設定資源限制以防止記憶體耗盡
• ☐ 設定精靈已完成並驗證了第一個聊天會話
• ☐ （如果 Mode 2）確認 Docker 套接字安裝並考慮套接字代理

立即獲得價值的後續步驟：

1. 執行一些實際任務 - 文件摘要、程式碼審查、網路研究 - 為技能庫播種
2. 完成 10-15 個任務後，執行 hermes skills list 查看學到了什麼
3. 請查看 Nous Research GitHub 以取得涵蓋自訂技能範本和記憶體調整的代理程式配置文檔
4. 如果您使用 Oracle 免費套餐，請設定基於 cron 的 docker compose pull && docker compose up -d 來實現零停機影像更新，同時保留學習狀態