---
title: "Hermes Agent 安裝教學：從零開始部署你的 AI 工作代理"
description: "Hermes Agent 是能操作終端機與瀏覽器的開源 AI 工作代理。整理 macOS、Linux、WSL2、Windows 安裝步驟與首次設定，說明如何連接模型、檢查環境並啟動第一個工作階段，以及安裝後的安全設定：從唯讀任務開始、憑證不進 Git、高風險動作保留人工確認，並附常見問題排查。"
canonical: "https://yotron-ai.com/blog/hermes-agent-installation-guide"
published: "2026-08-28"
last-updated: "2026-08-28"
---

# Hermes Agent 安裝教學：從零開始部署你的 AI 工作代理

Hermes Agent 是能操作終端機與瀏覽器的開源 AI 工作代理。整理 macOS、Linux、WSL2、Windows 安裝步驟與首次設定，說明如何連接模型、檢查環境並啟動第一個工作階段，以及安裝後的安全設定：從唯讀任務開始、憑證不進 Git、高風險動作保留人工確認，並附常見問題排查。

Hermes Agent 是 Nous Research 開發的開源 AI 工作代理。和一般聊天介面不同，它可以在你的授權範圍內操作終端機、檔案、瀏覽器與外部工具，適合用來執行研究、程式開發、資料整理與流程自動化。

本篇示範如何在 **macOS、Linux、WSL2 與 Windows** 安裝 Hermes Agent，並完成第一次啟動。命令以官方文件為準；如果安裝腳本日後更新，請優先以官方文件的版本為依據。

## 安裝前先準備什麼

開始前，先確認三件事：

1. 你使用的是 macOS、Linux、WSL2 或 Windows PowerShell。
2. 你有可連線的模型供應商帳號，並知道該供應商使用 API key 還是 OAuth。
3. 你了解 Hermes Agent 可能執行本機指令。正式導入企業流程前，應先用測試資料與低權限帳號驗證。

Hermes Agent 的安裝程式來自 GitHub。和任何遠端安裝腳本一樣，正式環境建議先閱讀腳本內容，確認來源後再執行；不要把未知來源的 `curl | bash` 當成無條件信任的指令。

## macOS、Linux 與 WSL2 安裝

在終端機執行官方安裝腳本：

```bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
```

腳本完成後，重新開啟終端機，或載入安裝程式更新過的 shell PATH。接著確認 CLI 已可使用：

```bash
hermes --version
```

如果終端機顯示找不到 `hermes`，先關閉並重新開啟終端機，再檢查 PATH；不要直接重複執行安裝腳本。

### WSL2 使用提醒

Windows 使用者可以在 WSL2 中執行上述 Linux 安裝流程。這通常比原生 Windows 支援更成熟，也比較接近 Linux 與 macOS 的官方使用路徑。請把需要操作的專案放在 WSL2 可正常存取的位置，並確認 Python、Git 等依賴能在同一個環境中被找到。

## Windows 原生安裝

Windows 原生支援目前屬於 early beta。請在 PowerShell 執行：

```powershell
irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
```

安裝完成後，重新開啟 PowerShell，確認 CLI：

```powershell
hermes --version
```

原生 Windows 版本的 CLI 與 Gateway 可以直接執行；官方文件指出，瀏覽器式 dashboard 的部分功能仍需要 POSIX PTY，因此遇到相關限制時，改用 WSL2 通常比較省時間。

## 首次設定：連接模型與檢查環境

CLI 能正常回應後，執行健康檢查：

```bash
hermes doctor
```

Windows PowerShell 使用相同的 `hermes doctor` 命令。接著啟動設定精靈：

```bash
hermes setup
```

設定精靈會引導你選擇模型供應商、終端機工具與代理行為。完成後重新檢查：

```bash
hermes doctor
```

如果你使用支援 OAuth 的供應商，可以依官方文件使用登入流程；如果使用 API key，請把憑證放在 Hermes 的環境設定中，不要直接寫進專案程式碼：

```bash
hermes config env-path
hermes config path
```

這兩個命令會顯示環境檔與設定檔位置。常見的 macOS、Linux 與 WSL2 路徑位於 `~/.hermes/` 下；Windows 原生安裝則位於 `%LOCALAPPDATA%\\hermes`。不同版本的預設路徑可能調整，請以命令輸出為準。

## 啟動第一個工作階段

互動式使用直接執行：

```bash
hermes
```

第一次不要從高風險任務開始。先測試一個不會修改資料的請求，例如：

```text
請說明目前工作目錄中有哪些檔案，但不要建立、修改或刪除任何檔案。
```

若你只想執行單次查詢，也可以使用非互動模式：

```bash
hermes chat -q "請用三點說明目前專案的 README 內容"
```

這種方式適合腳本、CI 或可重複的低風險查詢；涉及刪除、部署、發送訊息或修改正式資料時，仍應保留人工審核。

## 安裝後的安全設定

Hermes Agent 的價值在於能做事，但這也代表權限邊界不能省略。

### 先從唯讀任務開始

先讓代理讀取文件、整理資料或產生草稿，再逐步開放寫檔、執行命令與連接外部服務。不要一開始就把生產環境、客戶個資或付款系統交給它操作。

### 憑證不要進 Git

API key、OAuth token 與 `.env` 檔案不應提交到 Git。若需要團隊共用，請使用團隊核准的祕密管理工具，並為不同環境使用不同憑證。

### 高風險動作保留人工確認

刪除檔案、修改正式資料、發送對外訊息、部署服務與付款等動作，都應設定審核點。AI 能幫你縮短操作時間，不代表它可以替你承擔商業責任。

### 定期執行健康檢查

更新 Hermes 或調整模型供應商後，重新執行：

```bash
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 工作代理架構。

## 官方文件

- [Hermes Agent 官方文件](https://hermes-agent.nousresearch.com/docs/)
- [Hermes Agent GitHub](https://github.com/NousResearch/hermes-agent)
- [CLI 安裝腳本](https://github.com/NousResearch/hermes-agent/blob/main/scripts/install.sh)
- [Windows 安裝腳本](https://github.com/NousResearch/hermes-agent/blob/main/scripts/install.ps1)

---

*本文命令與功能以 2026 年 8 月官方文件為基準；Hermes Agent 持續更新，實際介面與支援平台請以官方文件為準。*

## 參考資料

- [Hermes Agent 官方文件](https://hermes-agent.nousresearch.com/docs/)
- [NousResearch/hermes-agent](https://github.com/NousResearch/hermes-agent)
- [Hermes Agent 安裝腳本](https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh)
- [Hermes Agent Windows 安裝腳本](https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

---

*本文由優創智能股份有限公司整理，實際版本與功能請以 Hermes Agent 官方文件為準。*

---

## 相關推薦與延伸閱讀

- [Agent SDK 是什麼？OpenAI Agents SDK 核心架構與企業自動化指南](/blog/openai-agents-sdk-business-automation-guide)：Agent SDK 是什麼？完整拆解 OpenAI Agents SDK 的四大核心組件（Agents、Handoffs、Guardrails、Sessions
- [Claude Agent SDK 每月 $100 額度教學：Max 5x 政策解析與台灣企業導入指南](/blog/claude-agent-sdk-100-credit-max-plan-guide)：Anthropic Max 5x 使用者每月可領 $100 Claude Agent SDK 額度，不佔訂閱限制。了解政策細節與台灣企業的導入方式。本文說明這次
- [Codex 瀏覽器自動化教學：AI 操作 Chrome 抓蝦皮資料、自動填表與實戰指令](/blog/codex-chrome-browser-automation-taiwan-sme)：解析 Codex 如何操作 Chrome 瀏覽器實現無程式碼自動化！手把手掌握蝦皮與電商後台爬蟲、報表彙整與實用 Prompt 指令，附防封號避坑指南。涵蓋跨平