OmniProxy.ai
繁體中文（台灣）
EnglishEnglish (Australia)English (Canada)English (United Kingdom)English (United States)简体中文繁體中文（台灣）繁體中文（香港）DeutschDeutsch (Deutschland)EspañolEspañol (Latinoamérica)Español (México)Español (España)Bahasa Indonesia한국어ItalianoFrançaisFrançais (Canada)Français (France)日本語Bahasa MelayuMaltiPolskiPortuguês (Brasil)Português (Portugal)РусскийไทยTürkçeУкраїнськаTiếng Việtአማርኛবাংলাবাংলা (বাংলাদেশ)БългарскиCatalàHrvatskiČeštinaDanskNederlandsNederlands (Nederland)EestiFilipinoSuomiΕλληνικάગુજરાતીગુજરાતી (ભારત)हिन्दीMagyarಕನ್ನಡಕನ್ನಡ (ಭಾರತ)LatviešuLietuviųമലയാളംമലയാളം (ഇന്ത്യ)मराठीमराठी (भारत)Norskଓଡ଼ିଆਪੰਜਾਬੀRomânăСрпскиSlovenčinaSlovenščinaSlovenščina (Slovenija)KiswahiliSvenskaதமிழ்தமிழ் (இந்தியா)తెలుగుతెలుగు (భారతదేశం)
العربيةالعربية (السعودية)עבריתفارسیاردواردو (پاکستان)
Agent

Hermes 安裝與 OmniProxy 設定

想讓助理記住以前做過的事，又不想每次都從頭交代？Hermes 能保留對話與任務經驗，還能從你常用的聊天工具繼續工作。

文件核對日期
2026年10月9日
已核對官方文件
Hermes Agent v0.21.6

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 官方網站的下載區，下載與系統相符的安裝套件。安裝套件已包含執行環境，首次開啟時不必在電腦上即時編譯。

  • macOS：開啟 DMG，將 Hermes.app 放進「應用程式」。DMG 是 macOS 常用的安裝映像檔。這個安裝套件只支援 Apple 晶片，不支援 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。Grok 與 Gemini 的服務位址應設定在 OmniProxy 中，不要直接填入 Hermes。

你的電腦

Hermes

本機閘道

OmniProxy

  • 位址填寫至 /v1

Grok

  • grok-4.7

Gemini

  • gemini-3.8-flash
Hermes 連接的是 OmniProxy。Grok 與 Gemini 由 OmniProxy 轉送。

模型 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，API 位址仍填寫 OmniProxy 的位址。

從 OmniProxy 複製 API 位址與金鑰，再填入對應的模型 ID：

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

Base URL 是 Hermes 傳送請求的 API 位址，此處必須以 /v1 結尾。API Key 是 OmniProxy 提供給 Hermes 的金鑰，請替換為你自己的內容，不要放在公開頁面上。

如果本機的 OmniProxy 不要求金鑰，API Key 可以留空；只要該位址可由其他人存取，就應填寫金鑰。另外，也要確認 Hermes 所在的環境能夠存取此位址。Hermes 與 OmniProxy 都在同一部電腦上時，可以使用本機位址。

填寫工具設定

請先離開目前進行中的聊天，然後在終端機執行：

hermes model

選擇 Custom endpoint (self-hosted / VLLM / etc.)。Custom endpoint 是自訂 API 端點，表示讓 Hermes 連接你指定的服務位址，而不是使用預設的服務來源。

設定精靈會依序詢問 API 位址、金鑰與模型名稱，請填入上一節列出的三項資料。要使用 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 只能在已儲存的服務來源之間切換，不能用來新增這項設定。

驗證實際任務

1

hermes doctor

  • 安裝檢查通過

2

傳送一句簡短訊息

  • 看到 Hermes 的回覆

3

開啟呼叫記錄

  • 核對模型名稱
完成全部三個步驟，才能確認這項設定可用。
  1. 執行 hermes doctor，檢查安裝是否完整。
  2. 執行 hermes，請它用一句話說明自己能做什麼。你應該會看到一段回覆。
  3. 開啟 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。
  • 有回覆，但無法讀取檔案或執行指令等操作：改用 OmniProxy 中另一個具備這些能力的模型，再重新開啟 Hermes。
  • 程式放在外接硬碟，拔除硬碟後 hermes doctor 回報儲存錯誤：請先重新連接該硬碟。不要在硬碟未連接時讓 Hermes 另行建立一套設定。

官方參考資料

安裝步驟請參閱 Hermes 安裝文件 與 平台支援。Custom endpoint 的設定請參閱 Hermes Provider 文件。模型 ID 分別列於 Grok 模型文件 與 Gemini 的 OpenAI 相容說明。

macOS 上的安裝已於 2026-10-09 使用 Hermes Agent v0.21.6 完整測試。grok-4.7 與 gemini-3.8-flash 是當日 xAI 與 Google 文件中的標準模型 ID。實際填寫時，請以 OmniProxy 顯示的名稱為準。

用你自己的 OmniProxy 設定取代每個佔位符。不要發布真實金鑰。

儲存成功或 HTTP 200 不單獨代表完整 Agent 相容性。請在 OmniProxy 呼叫記錄中確認來源和模型。

官方來源 · Hermes ↗