Agentic Research
中文
English Edition/Tools

This article is not yet available in English. You are reading the Traditional Chinese original. The English edition will appear here once it is translated.

Browse articles that do have an English edition

Hermes Agent 安裝教學：桌面版與命令列兩條路徑

2026/09/3018 min readBryan Chan閱讀中文原文
TopicsHermes Agent安裝教學AI AgentCLI

讀完這篇你會得到：一個能啟動的 hermes 命令（或桌面應用）、設定好的模型、通過 hermes doctor 健檢，並送出第一則訊息。官方說命令列安裝的基本流程兩分鐘內可完成；加上設定與驗證，預留 10 到 15 分鐘。

Hermes Agent 是 Nous Research 開源的多通道 AI Agent（代理）：一個 gateway 程序可同時接上飛書／Lark、Telegram、Discord、Slack、WhatsApp 等二十多個通訊平台，共用同一套 session、工具與排程。本篇只負責「裝好並跑起來」；把飛書 Bot 接上的完整流程在 把 AI Agent 接上飛書/Lark:新手的第一個企業渠道，不在這裡重複。

適用平台

官方支援四條安裝路徑：

路徑適用平台說明
桌面安裝包macOS（僅 Apple Silicon）、WindowsmacOS 是 DMG；Windows 是 .appinstaller（簽章 MSIX）
命令列安裝腳本Linux / macOS / WSL2只裝命令列版；之後可用 hermes desktop 補裝桌面應用
PowerShell 腳本Windows 原生命令列版的 Windows 路徑
Termux APTaarch64 Android先設定官方簽章 repo，再 pkg install hermes-agent

Intel Mac 不在支援範圍：官方把 macOS x86 列為不支援平台（見平台支援文件），桌面包與腳本路徑都不要在 Intel Mac 上試。

前置需求

  • 命令列路徑（Linux / macOS / WSL2）需要 Git、curl、tar 與 SHA-256 工具 — 多數系統自帶；Windows 腳本在缺 Git 時會自動下載釘版 Git for Windows。
  • Terminal（終端機）與CLI（命令列介面）基本操作；PATH 與路徑 的概念在排查時會用到。
  • 一個模型入口，三選一：任一支援供應商的 API Key；Nous Portal 訂閱（hermes setup --portal 一條指令完成登入、設供應商、開 Tool Gateway）；或先裝好、之後用 hermes model 再設。金鑰範例一律寫成 sk-xxxxxxxx 這種佔位符 — 真金鑰不要貼進聊天視窗、不要提交進 Git。
  • 不需要自己裝 Python 或 Node：安裝腳本會 clone 原始碼、bootstrap uv，再由 PM 裝好釘版 Python、Node.js、npm、ripgrep、FFmpeg。官方第一方安裝執行的是 Python 3.14。
  • 概念預習（可跳過）：Harness（執行環境／框架）、Tool Call（工具呼叫）、LLM（大型語言模型）。

步驟

安裝 Hermes Agent 的六個步驟先在桌面應用與命令列兩條路徑中選定一條：桌面路徑是下載安裝包（macOS 僅支援 Apple Silicon，Windows 是 .appinstaller／MSIX），命令列路徑是執行官方安裝腳本。裝完重新載入 shell 並首次啟動，設定模型與工具，最後健檢並發第一則訊息。沒有 hermes init 這個指令，完整精靈是 hermes setup。Hermes Agent先選一條路徑桌面應用（點圖示就好） 或 命令列（要會開終端機）桌面路徑macOS：僅 Apple SiliconWindows：.appinstaller / MSIX命令列路徑$ curl -fsSL …/install.sh | bash$ iex (irm …/install.ps1)設定模型與工具hermes setup / model / tools健檢與第一則訊息$ hermes doctor$ hermes # 開始對話不會用終端機就選桌面路徑，兩者能力相同示意圖，非截圖。只畫與當前步驟相關的區域，實際介面有更多選項。
1/6選定安裝路徑
第 1 步，共 6 步 選定安裝路徑
安裝 Hermes Agent 的兩條路徑示意（六步）

步驟一：選定安裝路徑

30 秒決策：

  • 用 Apple Silicon Mac 或 Windows、想要桌面應用 → 走步驟二。
  • Linux / macOS / WSL2、習慣命令列 → 走步驟三（POSIX 腳本）。
  • Windows 原生＋命令列 → 走步驟三（PowerShell 腳本）。
  • Android 手機（aarch64）→ Termux 路徑：先設定官方簽章 repo，再 pkg install hermes-agent；repo 設定指令以官方 Termux 文件為準，本篇不重貼。桌面／伺服器腳本不是 Termux 的安裝路徑。

預期輸出：你明確知道接下來走哪一步。走桌面路徑的做完步驟二直接跳步驟四。

步驟二：安裝桌面應用（桌面路徑）

到官網 hermes-agent.nousresearch.com 下載對應平台的安裝包：

  • macOS：打開 DMG，把 Hermes.app 複製到「應用程式」資料夾。
  • Windows：用 Windows App Installer 打開下載的 .appinstaller 檔，它會安裝簽章 MSIX 包並記錄更新來源。

預期輸出：macOS 在啟動台／應用程式資料夾看到 Hermes；Windows 的 App Installer 顯示安裝完成。桌面安裝包內含 agent、Python 與相依套件，首次啟動不需要現場建置執行環境；存取模型供應商與選配整合仍需要網路。

步驟三：執行安裝腳本（命令列路徑）

Linux / macOS / WSL2：

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

Windows（PowerShell）：

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

選配開關：不想裝瀏覽器工具加 --skip-browser（Windows：-SkipBrowser）；不想裝 computer-use 驅動加 --skip-computer-use（-SkipComputerUse）。這些選擇會被記住，之後的安裝與 hermes update 不會擅自裝回來；想反悔用 hermes pm install agent-browser 或 hermes pm install cua-driver 補裝。

預期輸出：終端機每個步驟印一行狀態；git、uv 與建置的完整輸出寫進資料目錄下的 logs/install.log。某步失敗時會印出該步輸出的最後幾行與日誌路徑 — 把那段錯誤留著，排查時用。下載失敗不會中止整個安裝，腳本會印出重試指令。互動式執行到最後會直接引導你進入 setup 與 gateway 設定（不想被引導可加 --non-interactive，Windows 是 -NonInteractive）。

步驟四：重新載入 shell，首次啟動

命令列安裝（POSIX）之後，在同一個終端機：

source ~/.bashrc   # zsh 使用者：source ~/.zshrc
hermes

預期輸出：hermes 進入互動介面，可以直接開始對話。原始碼安裝的位置：程式碼在 ~/.hermes/hermes-agent/、啟動器在 ~/.local/bin/hermes、資料在 ~/.hermes/（Windows 原始碼安裝落在 %LOCALAPPDATA%\hermes\）。桌面應用則直接從啟動台／開始功能表打開。

命令列版日後想補裝桌面應用：hermes desktop。

步驟五：設定模型與工具

hermes setup          # 完整精靈：模型、工具、gateway 一次設好

也可以事後逐項調整：

hermes model          # 選 LLM 供應商與模型
hermes tools          # 決定啟用哪些工具
hermes gateway setup  # 設定通訊平台（互動式）
hermes config set     # 單獨設某個值
hermes config get     # 查某個值

捷徑：hermes setup --portal 一條指令完成登入 Nous Portal、把 Nous 設為供應商、打開 Tool Gateway（含網頁搜尋、圖片生成、TTS、雲端瀏覽器），不用逐個工具湊 API key。

預期輸出：精靈逐項完成，設定寫入 ~/.hermes/；hermes config get 可讀回你設的值。API key 由精靈互動收取 — 不要把它們貼在任何聊天視窗，也不要提交進版控。

步驟六：健檢，然後發第一則訊息

hermes doctor

預期輸出：doctor 告訴你缺什麼、怎麼修，並回報安裝來源（原始碼、桌面包、Docker、Termux 等更新機制各歸其主）。沒有缺項後，在 hermes 互動介面輸入一個會用到工具的問題（例如「列出目前目錄的檔案」），看到 Agent 調用工具並回答 — 安裝完成。

要接飛書、Telegram 等通訊平台：用 hermes gateway setup 設定後啟動 gateway。飛書的完整流程（建應用、事件訂閱、allowlist 與安全預設）見 把 AI Agent 接上飛書/Lark:新手的第一個企業渠道。

怎麼確認你裝對了

  1. hermes doctor 無缺項，且回報的安裝來源與你的安裝方式一致；
  2. hermes 能啟動互動介面並得到回覆；
  3. POSIX 原始碼安裝：~/.local/bin/hermes 存在、~/.hermes/ 下有設定；
  4. 更新之後設定仍在（若不在，見下方 hermes config migrate）。

常見錯誤與修法

前三條來自官方安裝文件的疑難排解表，其餘是文件各節明確寫出的行為：

症狀原因修法
hermes: command not foundshell 未重新載入，或啟動器目錄不在 PATHsource ~/.bashrc（或 ~/.zshrc）；確認 ~/.local/bin 在你的 PATH 與路徑 中
API key not set尚未設定供應商hermes model 互動設定；或 hermes config set OPENROUTER_API_KEY sk-xxxxxxxx（佔位符示意，換成你自己的金鑰）
更新後設定遺失設定格式遷移未完成先 hermes config check，再 hermes config migrate
安裝中途某步失敗網路或相依下載失敗看終端機印出的最後幾行與資料目錄下的 logs/install.log；失敗的下載不中止安裝，腳本會印出重試指令
Intel Mac 裝不上官方不支援 macOS x86見平台支援文件；換 Apple Silicon Mac、Linux 或 Windows 機器
Nix 安裝路徑失效Nix 已非官方明確支援路徑（僅 best-effort）既有 Nix 使用者見官方 Nix & NixOS 設定；新安裝建議走腳本或桌面包

下一步

More in Tools