安裝 Hermes 並設定 OmniProxy

Hermes 是一款能夠保留對話與任務經驗的助手，它能將已完成的工作轉化為日後可重複使用的技能。透過單一 Gateway，它還可以連接 Telegram、Discord、Slack、WhatsApp、Signal 以及終端機。Gateway 作為接收與轉發訊息的統一入口。你可以從常用的聊天工具發送程式碼審查、事故記錄或客戶資料給它，然後讓它回到儲存庫繼續工作。

開始之前

首先，根據你的電腦作業系統選擇安裝方式。macOS 和 Windows 可以直接使用圖形化安裝程式，而 Linux、macOS 和 WSL2 則可以使用終端機指令碼。WSL2 是 Windows 用於執行 Linux 環境的功能。Android 手機上的 Termux 和 Docker 有各自的安裝方式，但本指南僅涵蓋一般電腦上的安裝。

想要視窗介面嗎？

macOS, Windows

macOS：開啟 DMG 檔案
Windows：開啟安裝程式
將應用程式安裝至系統

僅限終端機

Linux, macOS, WSL2

使用 install.sh 指令
在 Windows 上使用 install.ps1
安裝後輸入 hermes

暫時不要使用這些方式

pip, brew, AUR

這些安裝方式未獲官方支援
且安裝後難以更新
請改用左側的兩種選項之一

本指南涵蓋兩種途徑：圖形化安裝程式與終端機指令碼。pip、brew 和 AUR 並非官方支援的安裝方式。

開始之前，請準備一台 macOS、Windows 或 Linux 電腦，並確保它能開啟終端機並存取 GitHub。如果你打算將 Hermes 安裝在外接硬碟上，請先連接硬碟並確認其有足夠的剩餘空間。

安裝並首次啟動

如果你需要圖形化應用程式

前往 Hermes 網站的下載區並下載適用於你作業系統的安裝程式。安裝程式已包含執行環境，因此首次開啟時無需在本地進行編譯。

macOS：開啟 DMG 檔案並將 Hermes.app 移至「應用程式」資料夾。DMG 是 macOS 常用的安裝映像檔。此安裝程式僅支援 Apple Silicon；不支援 Intel Mac。
Windows：使用 Windows 應用程式安裝程式開啟 .appinstaller 檔案。它會安裝一個已簽署的 MSIX，這是 Windows 使用的一種應用程式套件。
Linux：桌面安裝程式僅適用於 macOS 和 Windows。在 Linux 上，請使用下方的終端機指令。安裝完成後，你可以執行 hermes desktop。

如果你只需要終端機介面

如果你使用 Linux、macOS 或 WSL2，請在終端機執行：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

在使用 Windows 內建的 PowerShell 時，請執行：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安裝程式會下載 Hermes 程式碼及執行所需的程式。如果下載中斷，請再次執行相同的指令。安裝完成後，請關閉目前的終端機，開啟一個新視窗，並輸入：

hermes

如果你看到 Hermes 的提示字元，代表指令已準備就緒。接著你可以執行 hermes doctor；此安裝檢查會告訴你還缺少什麼。

將程式儲存於外接硬碟

於 2026 年 10 月 9 日，Hermes Agent v0.21.6 被安裝在連接至 Mac 的外接硬碟上。程式儲存於 /Volumes/AItools/tools/hermes-agent，啟動指令位於 ~/.local/bin/hermes，而設定與對話資料則保留在 ~/.hermes。

如果你的硬碟名稱不同，請將 --dir 後的路徑替換為你自己的資料夾。Hermes 執行期間，硬碟必須保持連接狀態。

curl -fsSL https://hermes-agent.nousresearch.com/install.sh -o install.sh
bash install.sh --dir /Volumes/AItools/tools/hermes-agent --non-interactive

程式

外接硬碟

tools/hermes-agent
將程式碼放在這裡

指令

~/.local/bin/hermes

在終端機輸入 hermes
開啟新視窗後生效

設定與對話記錄

~/.hermes

config.yaml 在此處
拔除硬碟前請先退出程式

這就是當時在該 Mac 上檔案的排列方式。預設安裝會將程式放在使用者目錄中，結果相同：開啟新終端機並輸入 hermes。

從 OmniProxy 取得連線資料

在此，Hermes 是連接至 OmniProxy，而非直接連接至 Grok 或 Gemini。請在 OmniProxy 中設定 Grok 與 Gemini 的服務網址；不要直接在 Hermes 中輸入它們。

你的電腦

Hermes

本地閘道

OmniProxy

網址中包含 /v1

Grok

grok-4.7

Gemini

gemini-3.8-flash

Hermes 看到的是 OmniProxy。OmniProxy 會將請求轉發給 Grok 和 Gemini。

模型 ID 是 API 用於識別模型的確切名稱。請為這兩個模型使用以下名稱：

對於 Grok，輸入 grok-4.7。xAI API 為 https://api.x.ai/v1，聊天請求使用 /v1/chat/completions。請參閱 Grok 模型文件。
對於 Gemini，輸入 gemini-3.8-flash。Google 的 OpenAI 相容 API 為 https://generativelanguage.googleapis.com/v1beta/openai/。請參閱 Gemini 的 OpenAI 相容性文件。

若要將 Hermes 切換至 Gemini，只需將模型名稱更改為 gemini-3.8-flash。繼續使用 OmniProxy 位址作為 API 端點。

從 OmniProxy 複製端點網址與金鑰，然後輸入對應的模型 ID：

Base URL: https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: grok-4.7

Base URL 是 Hermes 發送請求的端點。在此處，它必須以 /v1 結尾。API Key 是 OmniProxy 發給 Hermes 的金鑰。請將預留位置替換為你自己的值，且不要將其發佈在公開頁面上。

如果你的本地 OmniProxy 執行個體不需要金鑰，你可以將 API Key 留空。如果該位址可供其他人存取，則應使用金鑰。同時請確認 Hermes 執行的環境可以連線到該位址。如果 Hermes 與 OmniProxy 位於同一台電腦上，你可以使用本地位址。

輸入工具設定

首先，退出目前的對話，然後在終端機執行：

hermes model

選擇 Custom endpoint (self-hosted / VLLM / etc.)。自訂端點意味著 Hermes 將連接至你指定的服務位址，而不是使用預設的供應商。

設定精靈會依序詢問端點網址、金鑰與模型名稱。輸入上一節中的三個值。若要使用 Gemini，請輸入 gemini-3.8-flash 作為模型名稱。

你也可以直接編輯 ~/.hermes/config.yaml。YAML 是一種使用縮排來表示設定關係的文字格式。以下設定使用 Grok：

model:
  default: grok-4.7
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

若要使用 Gemini，請將 default 更改為 gemini-3.8-flash，並保持其他三個值不變：

model:
  default: gemini-3.8-flash
  provider: custom
  base_url: https://your-omniproxy-origin.example/v1
  api_key: <YOUR_OMNIPROXY_API_KEY>

儲存後，再次執行 hermes 並開始新的對話。在已經開啟的對話中，/model 只能在已儲存的供應商之間切換；它無法新增此設定。

透過實際任務驗證

hermes doctor

安裝檢查通過

發送簡短訊息

看到 Hermes 回覆

開啟請求日誌

驗證模型名稱

設定必須完成以上三個步驟後才能使用。

執行 hermes doctor 以檢查安裝是否完成。
執行 hermes 並要求它用一句話解釋它能做什麼。你應該會看到回應。
開啟 OmniProxy 請求日誌，確認請求來自 Hermes，並檢查模型名稱是否為 grok-4.7 或 gemini-3.8-flash。

看到設定精靈儲存成功，或 API 回傳成功回應，並不代表 Hermes 就能為你完成任務。請求日誌中的模型名稱必須與你輸入的值相符。

若要在瀏覽器中進行對話，請在本地執行：

hermes dashboard --no-open --host 127.0.0.1 --port 9119

然後開啟 http://127.0.0.1:9119。此位址僅適用於目前這台電腦。

常見錯誤

輸入 hermes 顯示找不到指令：請關閉終端機並開啟新視窗。如果仍然找不到指令，請確認 ~/.local/bin 是否在 PATH 中。PATH 是系統搜尋指令的目錄列表。在 Windows 上，請確認安裝程式新增的啟動目錄已在 PATH 中。
安裝下載中途停止：請再次執行相同的安裝指令。已下載的部分將會被重複使用。
Hermes 沒有回應或顯示無法連接：請確認 OmniProxy 正在執行，並檢查 Base URL 是否以 /v1 結尾。如果 Hermes 在 Docker 中執行而 OmniProxy 在主機上執行，請勿使用 127.0.0.1，因為它僅在容器內部有效。
出現金鑰錯誤：請更新 OmniProxy 金鑰，然後更改 config.yaml 中的 api_key。xAI 或 Google 金鑰應放在 OmniProxy 的供應商設定中；不要輸入在這個 Hermes 欄位中。
顯示模型無法使用：請開啟 OmniProxy 中的目前模型列表，並完全依照列表中的名稱複製 grok-4.7 或 gemini-3.8-flash。
Hermes 有回應但無法執行任務（如讀取檔案或執行指令）：請在 OmniProxy 中切換至另一個具備這些功能的模型，然後開始新的 Hermes 對話。
程式位於外接硬碟，且拔除硬碟後 hermes doctor 報告儲存錯誤：請先重新連接硬碟。不要讓 Hermes 在硬碟中斷連接時建立獨立的設定檔。

參考資料

關於安裝步驟，請參閱 Hermes 安裝文件與平台支援。關於自訂端點設定，請參閱 Hermes 供應商文件。關於模型 ID，請參閱 Grok 模型文件與 Gemini 的 OpenAI 相容性文件。

macOS 安裝程序於 2026 年 10 月 9 日使用 Hermes Agent v0.21.6 完成。grok-4.7 與 gemini-3.8-flash 是該日期 xAI 與 Google 文件中的標準模型 ID。輸入這些值時，請使用 OmniProxy 中顯示的名稱。

將所有佔位符替換為您自己的 OmniProxy 配置值。切勿發布真實金鑰。

保存的結果或 HTTP 200 單獨存在並不證明完整的 Agent 相容性。請在 OmniProxy 的呼叫記錄中檢查來源與模型。

官方來源 · Hermes ↗