Hermes Agent 是 Nous Research 開發的開源 AI 工作代理。和一般聊天介面不同，它可以在你的授權範圍內操作終端機、檔案、瀏覽器與外部工具，適合用來執行研究、程式開發、資料整理與流程自動化。
本篇示範如何在 macOS、Linux、WSL2 與 Windows 安裝 Hermes Agent，並完成第一次啟動。命令以官方文件為準；如果安裝腳本日後更新，請優先以官方文件的版本為依據。
安裝前先準備什麼
開始前，先確認三件事：
- 你使用的是 macOS、Linux、WSL2 或 Windows PowerShell。
- 你有可連線的模型供應商帳號，並知道該供應商使用 API key 還是 OAuth。
- 你了解 Hermes Agent 可能執行本機指令。正式導入企業流程前，應先用測試資料與低權限帳號驗證。
Hermes Agent 的安裝程式來自 GitHub。和任何遠端安裝腳本一樣，正式環境建議先閱讀腳本內容，確認來源後再執行；不要把未知來源的 curl | bash 當成無條件信任的指令。
macOS、Linux 與 WSL2 安裝
在終端機執行官方安裝腳本：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
腳本完成後，重新開啟終端機，或載入安裝程式更新過的 shell PATH。接著確認 CLI 已可使用：
hermes --version
如果終端機顯示找不到 hermes，先關閉並重新開啟終端機，再檢查 PATH；不要直接重複執行安裝腳本。
WSL2 使用提醒
Windows 使用者可以在 WSL2 中執行上述 Linux 安裝流程。這通常比原生 Windows 支援更成熟，也比較接近 Linux 與 macOS 的官方使用路徑。請把需要操作的專案放在 WSL2 可正常存取的位置，並確認 Python、Git 等依賴能在同一個環境中被找到。
Windows 原生安裝
Windows 原生支援目前屬於 early beta。請在 PowerShell 執行：
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
安裝完成後，重新開啟 PowerShell，確認 CLI：
hermes --version
原生 Windows 版本的 CLI 與 Gateway 可以直接執行；官方文件指出，瀏覽器式 dashboard 的部分功能仍需要 POSIX PTY，因此遇到相關限制時，改用 WSL2 通常比較省時間。
首次設定：連接模型與檢查環境
CLI 能正常回應後，執行健康檢查：
hermes doctor
Windows PowerShell 使用相同的 hermes doctor 命令。接著啟動設定精靈：
hermes setup
設定精靈會引導你選擇模型供應商、終端機工具與代理行為。完成後重新檢查：
hermes doctor
如果你使用支援 OAuth 的供應商，可以依官方文件使用登入流程；如果使用 API key，請把憑證放在 Hermes 的環境設定中，不要直接寫進專案程式碼：
hermes config env-path
hermes config path
這兩個命令會顯示環境檔與設定檔位置。常見的 macOS、Linux 與 WSL2 路徑位於 ~/.hermes/ 下；Windows 原生安裝則位於 %LOCALAPPDATA%\\hermes。不同版本的預設路徑可能調整，請以命令輸出為準。
啟動第一個工作階段
互動式使用直接執行：
hermes
第一次不要從高風險任務開始。先測試一個不會修改資料的請求，例如：
請說明目前工作目錄中有哪些檔案，但不要建立、修改或刪除任何檔案。
若你只想執行單次查詢，也可以使用非互動模式：
hermes chat -q "請用三點說明目前專案的 README 內容"
這種方式適合腳本、CI 或可重複的低風險查詢；涉及刪除、部署、發送訊息或修改正式資料時，仍應保留人工審核。
安裝後的安全設定
Hermes Agent 的價值在於能做事，但這也代表權限邊界不能省略。
先從唯讀任務開始
先讓代理讀取文件、整理資料或產生草稿，再逐步開放寫檔、執行命令與連接外部服務。不要一開始就把生產環境、客戶個資或付款系統交給它操作。
憑證不要進 Git
API key、OAuth token 與 .env 檔案不應提交到 Git。若需要團隊共用，請使用團隊核准的祕密管理工具，並為不同環境使用不同憑證。
高風險動作保留人工確認
刪除檔案、修改正式資料、發送對外訊息、部署服務與付款等動作，都應設定審核點。AI 能幫你縮短操作時間，不代表它可以替你承擔商業責任。
定期執行健康檢查
更新 Hermes 或調整模型供應商後，重新執行：
hermes doctor
hermes status --all
如果工具或技能剛完成設定，通常需要重新啟動 CLI 或建立新的工作階段，讓新的設定生效。
常見問題排查
hermes: command not found
重新開啟終端機，確認安裝目錄已加入 PATH，再執行 hermes --version。如果仍然失敗，回到官方安裝文件檢查目前平台的安裝方式，不要混用 Windows、WSL2 與 macOS 的路徑。
hermes doctor 顯示模型或憑證錯誤
先確認你選的供應商、模型名稱與 API key 是否一致，再執行 hermes setup 重新設定。OAuth 供應商則重新執行官方登入流程；不要把完整 token 貼到公開 issue 或聊天室。
工具沒有出現在工作階段
使用 hermes tools list 查看工具狀態。啟用工具後，重新啟動 CLI 或建立新的工作階段；工具設定不一定會套用到已經開啟的對話。
結語：先讓代理完成一個可驗證的小流程
Hermes Agent 的安裝本身只需要幾個命令，真正的導入難點在於模型選擇、工具權限、資料邊界與人工審核。建議從一個可量化、低風險的流程開始，例如「讀取每週報表並產生摘要」，驗證準確率與節省時間後，再擴大到跨系統自動化。
優創智能股份有限公司協助企業把 AI 從展示功能導入實際工作流程：先盤點流程與資料權限，再設計可監控、可回溯、有人員把關的 AI 工作代理架構。
官方文件
本文命令與功能以 2026 年 8 月官方文件為基準；Hermes Agent 持續更新，實際介面與支援平台請以官方文件為準。
參考資料
本文由優創智能股份有限公司整理，實際版本與功能請以 Hermes Agent 官方文件為準。
相關推薦與延伸閱讀
- Agent SDK 是什麼？OpenAI Agents SDK 核心架構與企業自動化指南：Agent SDK 是什麼？完整拆解 OpenAI Agents SDK 的四大核心組件（Agents、Handoffs、Guardrails、Sessions
- Claude Agent SDK 每月 $100 額度教學：Max 5x 政策解析與台灣企業導入指南：Anthropic Max 5x 使用者每月可領 $100 Claude Agent SDK 額度，不佔訂閱限制。了解政策細節與台灣企業的導入方式。本文說明這次
- Codex 瀏覽器自動化教學：AI 操作 Chrome 抓蝦皮資料、自動填表與實戰指令：解析 Codex 如何操作 Chrome 瀏覽器實現無程式碼自動化！手把手掌握蝦皮與電商後台爬蟲、報表彙整與實用 Prompt 指令，附防封號避坑指南。涵蓋跨平