
TL;DR 快速結論
如果你只想趕快裝起來用,30 秒搞定:
Windows → 打開 PowerShell(管理員),貼上這行:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
macOS / Linux → 打開終端機,貼上這行:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
裝完執行 hermes setup --portal,用瀏覽器登入 Nous Portal 拿免費額度 → 就可以開始用了。
你有沒有過這種經驗?
下載一個 AI 工具,興奮地打開 terminal,結果裝了兩小時還在踩坑。
WSL2 版本不對、Python 版本衝突、PATH 沒設好、模型串不起來⋯⋯最後你會懷疑:「我只是想用 AI,為什麼要先學會當系統管理員?」
Hermes Agent(暱稱「愛馬仕」)是目前 GitHub 上成長最快的 AI Agent 框架之一,GitHub 超過 14 萬顆星,2026 年 6 月已發布到 v0.16.0。它讓你的電腦有一個會自己學習、會記住事情、能自動執行任務的 AI 助手。
但問題來了:安裝過程如果不對,體驗會從「哇好強」變成「我又浪費一個週末」。
這篇是我在自己的 Windows 電腦上實測驗證過的安裝指南。以下所有指令、版本號都是真實輸出。跟著做,30 分鐘內你的電腦就會多一個 AI 同事。
Hermes Agent 是什麼?為什麼大家都在裝?

Hermes Agent 是一個在終端機裡跑的 AI 代理人,最大的特色是會自己從經驗中學習。
跟 ChatGPT 那種「問一句答一句」不同,Hermes 可以:
- 記住你 — 從對話中學習你的偏好,越用越懂你
- 自己學技能 — 完成任務後自動把流程封裝成 Skill,下次直接呼叫
- 執行複雜任務 — 寫 code、搜尋資料、操作檔案、排程任務
- 串接到 Telegram — 你在手機上就能叫它做事
跟 OpenClaw(龍蝦)最大的差別是:Hermes 會自己進化。 OpenClaw 的 Skills 是社群寫好給你裝,Hermes 的 Skills 是自己從經驗中生成的,越用越聰明。
Hermes Agent 安裝前需要準備什麼?

| 項目 | 說明 |
|---|---|
| 作業系統 | Windows 10/11、macOS、Linux |
| 網路 | 需要能連 GitHub |
| 模型 API Key | 免費方案:安裝後執行 hermes setup --portal 直接登入拿額度 |
| 進階免費:註冊 OpenRouter(200次/天,模型選擇更多) | |
| 付費方案:OpenCode Go($10/月,我目前在用的配置) | |
| 時間 | 約 15-30 分鐘 |
不用準備的:
- ❌ 不用裝 Python(安裝程式會自帶 Python 3.11.15)
- ❌ 不用裝 Node.js(安裝程式會自帶 Node.js 22)
- ❌ 不用裝 Git(安裝程式會自帶 PortableGit)
- ❌ 不用 WSL2(除非你想選)
Windows 和 WSL2 安裝方式怎麼選?

Windows 使用者
Windows 原生安裝是 2026 年最大的更新。 現在不需要 WSL2,不需要 Docker,直接在 PowerShell 跑一行指令就搞定。
我的建議:如果你是想「裝來玩看看」,選 原生安裝;如果你是開發者、要深度整合 GitHub Actions 或跑複雜 automation,選 WSL2。
| 比較 | 原生 Windows | WSL2 |
|---|---|---|
| 安裝時間 | ⚡ 5 分鐘 | 15-30 分鐘 |
| 檔案存取 | 直接讀 C/D 槽 | 透過 /mnt/c/,I/O 慢 30-50% |
| 穩定性 | 良好(90%+ 功能正常) | 極佳(官方推薦) |
| 建議對象 | 新手、快速體驗 | 開發者、進階使用者 |
✅ 我在 Windows 11 上實測原生安裝,版本 v0.16.0,15 分鐘內全部裝好。
macOS / Linux 使用者
一行指令搞定,沒有 Windows 那些 PATH 問題。
Windows 原生安裝:Step by Step
Step 1:打開 PowerShell
按 Windows + X → 選 「Windows PowerShell (管理員)」 或 「終端機 (管理員)」。
Step 2:貼上安裝指令
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
安裝程式會自動處理一切:下載 Python 3.11.15、Node.js 22、Git、ffmpeg、ripgrep,全部裝到 %LOCALAPPDATA%\hermes\ 底下,完全隔離,不影響你系統原有的環境。
安裝完成後關掉 PowerShell,重新打開一個新的。
Step 3:確認版本
hermes --version
你應該會看到類似這樣的輸出:
Hermes Agent v0.16.0 (2026.6.5)
Python: 3.11.15
✅ 實測版本為 v0.16.0(2026 年 6 月 5 日發布),安裝目錄
%LOCALAPPDATA%\hermes\。
macOS / Linux 安裝
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
裝完後:
source ~/.bashrc # 或 source ~/.zshrc
hermes --version
Hermes Agent 的模型要怎麼設定?免費方案有哪些?
Hermes Agent 本身不跑模型,你需要讓它連接到一個模型提供者。 安裝完如果沒設定模型,執行 hermes 會卡住。
免費方案 1:Nous Portal(官方推薦,最簡單)
Nous Portal 是 Nous Research 官方推出的免費模型入口,一行指令就能完成設定:
hermes setup --portal
終端機會顯示一組網址和驗證碼:

流程非常簡單:
- 終端機出現一組網址 + 驗證碼
- 複製網址到瀏覽器打開
- 用 GitHub 或 Google 帳號登入,授權 Nous Portal
- 瀏覽器顯示授權成功 → 回到終端機,自動完成設定
全程不用另外註冊任何服務,也不用綁信用卡。
免費方案 2:OpenRouter(模型選擇最多)
OpenRouter 是一個模型聚合平台,免費帳號每天有 200 次請求,支援 27+ 個免費模型:
- 去 OpenRouter.ai 註冊
- 到 API Keys 頁面建立一組 Key
- 執行
hermes setup,Provider 選 OpenRouter,貼上 API Key
付費方案:OpenCode Go(我目前在用的方案)
如果你想要更穩定的連線和更強的模型,我目前用的是 OpenCode Go($10/月)。可以直接存取 deepseek-v4-flash、GPT-4o、Claude Opus 4 等頂級模型,比分開訂閱 Claude Pro + ChatGPT Plus 便宜一半以上。
✅ 我自己的電腦就是用這個配置:模型
deepseek-v4-flashviaopencode-go,運行穩定。
免費方案 3:本地 Ollama(完全離線)
如果你有 GPU(或不在乎速度),可以跑本地模型完全不花錢:
ollama pull qwen3.5:27b
hermes model --local ollama:qwen3.5:27b
需要至少 16GB RAM。
第一個任務測試
裝好 + 設好模型後,試試看 Hermes 是不是真的會動:
hermes
等提示符出現後,輸入你的第一個任務。例如:
你好,我叫 Leo。幫我搜尋今天最新的 AI Agent 相關新聞,整理成三條重點,每條附上來源。
如果 Hermes 正確回覆,代表:
- ✅ 安裝成功
- ✅ 模型串接正常
- ✅ 搜尋工具正常運作
接下來:讓 Hermes 變得更強
裝好只是開始。以下是我裝完後做的三件事:
1. 串接 Telegram(用手機遙控 Hermes)
hermes gateway setup
選 Telegram,貼上你的 Bot Token,以後在手機就能叫 Hermes 做事。
2. 安裝必備 Skills
Hermes 的 Skills 系統是它的核心。安裝後可以用 hermes skills list 查看已裝的技能:
📋 已安裝 Skills:cron-scripts-windows, doc-coauthoring, claude-code,
opencode, hermes-agent, github-pr-workflow ...(共 15+ 個)
以下是 3 個推薦安裝的官方 Skill:
hermes skills install official/research/web-search
hermes skills install official/devops/docker-management
hermes skills install github/github-pr-workflow
3. 學習自己寫 Skill
如果你想完整學會怎麼寫、怎麼測、怎麼發布自己的 Agent Skills,我準備了一份免費的繁體中文完整課程:
從 SKILL.md 格式、Description 優化、到跨平台測試,全部免費公開。
常見問題 FAQ
Q:Windows 安裝出現「無法載入檔案」錯誤?
A:PowerShell 執行政策問題。先執行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 再試一次。
Q:hermes 指令找不到?
A:關掉 PowerShell 重新開一個新的,讓 PATH 生效。如果還是不行,手動加入 %LOCALAPPDATA%\hermes\bin 到系統 PATH。
Q:免費模型會不會很慢?
A:Nous Portal 和 OpenRouter 的免費模型速度一般,日常查詢、寫作、程式碼輔助 OK。重度使用建議付費方案(如 OpenCode Go)。
Q:Hermes Agent 跟 OpenClaw(龍蝦)哪個好?
A:Hermes 勝在「會自我學習」,適合長期使用;OpenClaw 勝在「社群 Skills 多」,適合一次性的自動化任務。如果你不確定,先裝 Hermes。
Q:裝了 Hermes 會影響我電腦上原有的開發環境嗎?
A:不會。 安裝程式把所有依賴(Python、Node.js、Git)都裝在 %LOCALAPPDATA%\hermes\ 隔離目錄,不影響你系統原有的環境。這點我在自己的電腦上已經驗證過。
總結
Hermes Agent 不是另一個聊天的 AI,它是一個會越用越聰明的 AI 同事。
安裝不難,照著這篇做,30 分鐘搞定。花一個週末跟它培養默契,之後它會幫你省下無數時間。
下一步: 👉 Agent Skills 完整課程 — 從零學會寫自己的 AI 技能
資料來源
- Hermes Agent 官方安裝文件:hermes-agent.nousresearch.com/docs
- Hermes Agent GitHub:github.com/NousResearch/hermes-agent
- Nous Portal 官方入口:nousresearch.com
- OpenRouter 模型列表:openrouter.ai/models
- 實測版本:v0.16.0(2026.6.5),Windows 11 原生安裝