如何安裝 Hermes Agent：初學者設定指南

Hermes Agent 是 Nous Research 推出的開源 AI agent，可從終端機執行、連接不同的模型提供者、跨工作階段記住實用的上下文，並可透過工具、技能、訊息閘道與自動化功能擴充。本指南將協助你了解如何安裝 Hermes。在 macOS 或 Windows 上使用標準安裝程式時，無須手動安裝 Python 或 Node.js，因為官方安裝程式會為你處理主要相依套件。

Hermes Agent 是以終端機為主的軟體，因此你需要透過命令列安裝。請選擇符合你電腦的章節：

• macOS：從「應用程式」>「工具程式」>「終端機」開啟 Terminal，或按下 Command + Space 後搜尋「Terminal」。

• Windows：先安裝 WSL2，開啟你的 Linux 發行版終端機，然後依照 Linux 指令操作。

你還需要 Git。請確認是否已安裝 Git：

預期輸出：

如果看到 git: command not found，請先安裝 Git：

如果 macOS 尚未安裝 Homebrew，請執行以下指令，透過 Apple Command Line Tools 安裝 Git：

在終端機中複製並貼上官方安裝程式指令：

安裝程式會下載 Hermes Agent、準備其 Python 環境、安裝必要相依套件，並將 hermes 指令加入你的 shell 路徑。一般使用者安裝時，Hermes 資料會儲存在 ~/.hermes/ 下。

指令完成後，重新載入 shell：

如果你使用 macOS 常見的 Zsh，請執行：

預期結果：

現在請確認 Hermes Agent 指令已可使用：

預期結果：

隨著 Hermes Agent 更新，確切的版本號可能會變動。

Hermes Agent 必須先設定模型提供者，才能回答問題或使用工具。對初學者而言，最簡單的設定方式是互動式設定：

設定精靈可讓你選擇 Kimi/Moonshot 等提供者。在基本對話可正常運作前，請勿設定路由、備援、閘道或 cron。

選擇預設模型。Kimi K3 是 Kimi 最新的旗艦模型；如果你主要用於程式開發，kimi-k2.7-code 是較佳選擇。

如果你已知道要設定的值，可以使用 hermes config set。例如：

在 Hermes Agent 中使用 Kimi API 前，請先在 Kimi Platform 啟用你的 Kimi API Key。我們建議儲值 $20 以上以解鎖 Tier 2 存取權，這可降低延遲，並為複雜的多步驟任務提供更穩定的效能

前往 Kimi Platform 的 API Keys 區段，然後點選「Create API Key」。請記得複製並妥善保存你的 API key，因為金鑰只會在建立時顯示一次。

貼上你的 Kimi API key，並連接 Hermes Agent。

設定好模型後，啟動經典 CLI：

或者試試較新的終端機 UI：

你應該會看到歡迎畫面或提示詞，其中會顯示你所選的供應商／模型。請用一個簡單的請求測試：

成功時會是這樣：

如果 Hermes Agent 能開啟但回覆模型或驗證錯誤，請執行：

接著再次選擇供應商，並確認 API 金鑰或 OAuth 登入是否正確。

和 OpenClaw 一樣，Hermes Agent 也能作為 bot，並連接至你的聊天應用程式：

完成設定後，檢查 gateway 狀態：

請先確認模型供應商能在終端機中正常運作，再使用 gateway。若 CLI 無法完成基本對話，bot 通常也會因相同原因失敗。

原因：你的終端機尚未重新載入 PATH 變更。

解決方法：

或：

接著嘗試：

原因：未安裝 Git。

在 Ubuntu、Debian 或 WSL2 上的解決方法：

在 macOS 上使用 Homebrew 的解決方法：

原因：已安裝 Hermes Agent，但尚未設定供應商金鑰或登入方式。

解決方法：

或手動設定金鑰：

原因：更新後的設定檔可能不完整。

解決方法：

原因：基礎 URL、模型名稱或上下文長度有誤。

解決方法：請先在另一個用戶端測試端點，確認其與 OpenAI 相容，並確保該模型支援至少 64K 上下文，以供正常的 Hermes Agent 工作流程使用。

安裝 Hermes Agent 最簡單的方式，是使用官方的一行安裝程式，重新載入 shell，執行 hermes model，再透過一次實際對話及 hermes doctor 驗證設定。首次設定請保持簡單：一台電腦、一個供應商、一段可正常運作的對話。等基礎 Hermes Agent 助理穩定後，再逐步加入 Docker 隔離、gateway bot、技能、排程自動化與自訂模型供應商。