Hermes Agent 是 Nous Research 推出的一款開源 AI Agent，可從終端機執行，能連接不同的模型供應商，在多次工作階段之間記住有用的上下文，還能透過工具、技能、訊息閘道與自動化功能進行擴充。本指南將協助你了解如何安裝 Hermes。在 macOS 或 Windows 上使用標準安裝程式時，你不需要自行手動安裝 Python 或 Node.js，因為官方安裝程式會幫你處理好主要的相依套件。
安裝 Hermes Agent 之前
Hermes Agent 是以終端機為主的軟體，因此你需要透過命令列來安裝。請依你的電腦選擇對應的章節：
macOS：從「應用程式 > 工具程式 > 終端機」開啟終端機，或按下 Command + Space 並搜尋「Terminal」。
Windows：先安裝 WSL2，開啟你的 Linux 發行版終端機，再依照 Linux 指令操作。
你還需要安裝 Git。請先確認是否已安裝 Git：
預期輸出：
如果出現 git: command not found，請先安裝 Git：
如果你在 macOS 上沒有安裝 Homebrew，可以執行以下指令，透過 Apple Command Line Tools 安裝 Git：
步驟 1：在 macOS 或 Windows 上安裝 Hermes Agent
在終端機中複製並貼上官方安裝程式指令：
安裝程式會下載 Hermes Agent、準備好其 Python 環境、安裝所需的相依套件，並將 hermes 指令加入你的 shell 路徑中。在一般使用者安裝方式下，Hermes 的資料會儲存在 ~/.hermes/ 目錄中。
指令執行完成後，重新載入你的 shell：
如果你使用的是 macOS 上常見的 Zsh，請執行：
預期結果：
現在確認 Hermes Agent 指令是否可用：
預期結果：
隨著 Hermes Agent 的更新，實際版本號可能會有所變動。
步驟 2：設定你的模型供應商
Hermes Agent 需要先設定模型供應商，才能進行回覆或使用工具。最適合新手的設定方式是互動式設定：
精靈會讓你選擇一個供應商，例如 Kimi/Moonshot。在確認基本聊天功能可正常運作之前，先不要設定路由、備援、閘道或排程（cron）。
選擇預設模型。kimi-k2.6 是目前 Kimi 最先進的模型。
如果你已經知道想要設定的值，可以直接使用 hermes config set。例如：
如果你還沒有 API 金鑰，Kimi 會是不錯的選擇。
步驟 1：啟用你的 Kimi API
在 Hermes Agent 中使用 Kimi API 之前，請先到 Kimi Platform 啟用你的 Kimi API 金鑰。建議儲值 20 美元以上以解鎖 Tier 2 權限，可降低延遲並在處理複雜的多步驟任務時提供更穩定的效能
步驟 2：建立你的 Kimi API 金鑰
前往 Kimi Platform 中的 API Keys 頁面，點擊「Create API Key」。請務必複製並妥善保存你的 API 金鑰，因為此金鑰只會在建立時顯示一次。
步驟 3：輸入你的 API 金鑰
貼上你的 Kimi API 金鑰，並連接 Hermes Agent。
步驟 3：啟動 Hermes Agent
完成模型設定後，啟動經典版 CLI：
或試試較新的終端機介面：
你應該會看到歡迎畫面或提示，顯示你所選擇的供應商／模型。用一個簡單的請求來測試看看：
成功時應該會看到：
如果 Hermes Agent 能打開，但回覆模型或驗證錯誤，請執行：
然後重新選擇你的供應商，並確認 API 金鑰或 OAuth 登入是否正確。
第 4 步：把 Hermes Agent 變成機器人
和 OpenClaw 一樣，Hermes Agent 也可以作為機器人，連接到你的聊天應用程式：
設定完成後，檢查閘道狀態：
只有在終端機中確認模型供應商可以正常運作後，才使用閘道。如果 CLI 連基本對話都無法完成，機器人通常也會因為同樣的原因失敗。
常見的 Hermes Agent 安裝問題
hermes: command not found
原因：你的終端機尚未重新載入 PATH 的變更。
解決方法：
或者：
然後試試：
git: command not found
原因：缺少 Git。
在 Ubuntu、Debian 或 WSL2 上的解決方法：
在 macOS 上使用 Homebrew 的解決方法：
未設定 API 金鑰
原因：已安裝 Hermes Agent，但尚未設定供應商金鑰或登入。
解決方法：
或手動設定金鑰：
hermes doctor 顯示設定檔缺漏或過期
原因：更新後，你的設定檔可能不完整。
解決方法：
自訂端點能連線，但回覆內容不正確
原因：基礎 URL、模型名稱或上下文長度設定錯誤。
解決方法：先在另一個獨立的客戶端測試該端點，確認它與 OpenAI 相容，並確保模型至少支援 64K 上下文，以滿足一般 Hermes Agent 工作流程的需求。
快速指令參考
結語
安裝 Hermes Agent 最簡單的方法，就是使用官方的一行式安裝程式、重新載入你的 shell、執行 hermes model，再透過一次實際對話搭配 hermes doctor 來驗證設定是否成功。第一次設定時盡量保持簡單：一台機器、一個供應商、一次成功的對話。等基本的 Hermes Agent 助理穩定運作後，你就可以放心地在此基礎上加入 Docker 隔離、閘道機器人、技能、排程自動化，以及自訂模型供應商。
常見問題
~/.hermes/，並可透過技能、記憶、排程工作與訊息閘道進行擴充。hermes model，選擇一個供應商，例如 Kimi，接著啟動 hermes，測試一次一般對話，再執行 hermes doctor，並確認 hermes --continue 能恢復你的工作階段。完成後，可依需求加入 Docker 隔離、技能、MCP 伺服器、語音、排程（cron）或訊息閘道等功能。