前言 · 為什麼選 Hermes Agent
1 分鐘讀完，再決定要不要花 60 分鐘裝它
這是一份專為「非開發者」撰寫的 AI 助理框架分析。如果您沒有深厚的程式碼背景，主要看重「好不好用」、「功能是否齊全」以及「維護起來會不會很痛苦」，以下是選擇 Hermes Agent 相較於另外三款（OpenClaw、NanoClaw、nanobot）的深度比較與優勢分析。
對非開發者最友善的 4 個亮點
- 會自我學習與成長：少數內建「學習迴圈」的助理。從對話中記住您的偏好、建立長期記憶，甚至在完成複雜任務後自動學會新的「技能」（Skills），下次會做得更好。
- 不綁死單一 AI 模型：可隨時切換 AI 大腦（OpenAI、Claude、Google Gemini，甚至免費的開源模型），完全不需要改程式碼，不會被單一廠商綁架。
- 無縫接軌您的生活：支援 17 種以上通訊軟體，包含 Telegram、WhatsApp、Discord、Slack、Email。架設在雲端後可直接用手機 Telegram 傳訊息或語音請它幫忙做事。
- 自動化排程：內建定時任務，可用自然語言請它「每天早上發送新聞摘要給我」或「每週備份資料」，自動執行。
vs. OpenClaw — 「適中好用」對決「過度複雜」
OpenClaw 的問題：極度龐大（270 萬行程式碼），功能多到不可思議，但安裝門檻極高，需要 Node.js、Docker、甚至編譯底層環境。對非開發者是噩夢，「大砲打蚊子」。
Hermes 的優勢：相對輕量，官方甚至內建「從 OpenClaw 搬家（Migrate）」功能，可自動把設定、記憶和 API 密鑰無縫轉移過來。
vs. NanoClaw — 「模型自由」對決「深度綁定」
NanoClaw 的問題：為解決 OpenClaw 太複雜而誕生的「輕量安全版」，把每個 AI 關在獨立 Docker 容器中以確保安全。但深度綁定 Anthropic（Claude）模型，每次對話可能需支付 Claude API 費用，成本較高且缺乏彈性。安裝也強烈依賴 Docker 容器技術，對新手仍有門檻。
Hermes 的優勢：模型選擇自由（支援 200+ 模型），運作方式更符合一般人對軟體的理解，不需要搞懂容器隔離技術也能享受強大功能。
vs. nanobot — 「成熟產品」對決「學術專案」
nanobot 的問題：在亞洲市場（微信、釘釘）支援度極高，但本質是一個大學（香港大學）的「學術專案」，還是 Alpha（測試）版本，可能有很多 Bug，且未來若學生或研究員畢業，專案可能面臨無人維護的風險。
Hermes 的優勢：由活躍的商業/社群團隊（Nous Research）開發，每天都有大量更新，版本迭代快，有專門社群維護除錯，長期穩定性與支援度比學術專案更有保障。
⚠️ 非開發者的「現實提醒」
雖然 Hermes 在比較中勝出，作為非開發者，您仍需有以下心理準備：
- 不是「下載就能用」的手機 App：本課程帶您在自己的 Windows 筆電上裝（透過微軟官方的 Linux 子系統 WSL2）。整個過程約 60 分鐘，需要連續不被打斷的時間。
- 會用到終端機（Terminal），但全程有指令可複製：您會在 PowerShell 和 Ubuntu 終端機裡貼幾行指令，不需要看懂指令的內容。每個步驟旁都有「Copy」按鈕。
- 需要自己申請一個 API Key：用 email 註冊 OpenRouter（免費，不用刷卡），拿到一串密碼貼到 hermes 設定裡。Step 3 會帶您做。
總結
如果您希望擁有一個聰明、能記憶、能串接各種通訊軟體，且未來不會被單一公司綁架的專屬 AI 助理，Hermes Agent 是這四者中最平衡、生態最完整且最友好的選擇。
準備好了？按下「下一步」開始 60 分鐘安裝流程。
Step 1 / 9 · 開始之前
大約 60 分鐘，零預備
這份教材會帶你從零安裝好 hermes-agent——一個可以在你筆電裡跟你聊天、執行任務、甚至自己學東西的 AI agent。Hermes 不支援原生 Windows，所以我們會先在 Windows 裡裝一個 Linux 子系統 (WSL2)，再把 hermes 裝進那個 Linux 裡。
今天要走完 4 個 checkpoints
- ☐ 安裝 WSL2 + Ubuntu
- ☐ 申請 OpenRouter（免費 LLM API 入口，不需要刷卡）
- ☐ 安裝 hermes-agent
- ☐ 完成第一次對話
準備物
- Windows 10（1903 以上）或 Windows 11
- 有管理員權限的帳號
- 能收得到 email
- 連續 60 分鐘不被打斷
加碼預告（時間夠才會講）
如果安裝順利、有時間剩，會帶你看 LINE Messaging API 或 Telegram bot 的申請流程，這樣下一堂課就能直接接通讓你從手機跟 hermes 講話。
右下角「下一步」按鈕在頁面底部，本頁不需要做任何事，準備好就往下走。
Step 2 / 9 · 啟動 WSL2 安裝
~4 分鐘觸發、之後 5–10 分鐘背景下載
WSL = Windows Subsystem for Linux，微軟官方的 Linux 子系統。安裝這條指令會自動下載 WSL 核心 + Ubuntu。
動作
- 開始功能表搜尋「PowerShell」
- 右鍵 → 「以系統管理員身分執行」（藍底白標題會出現）
- 把下面這行貼進去，按 Enter
- 看到下載進度條後，不要關掉視窗，繼續往下讀
指令
wsl --install等下載時可以順便讀：殼層 / 終端機 / WSL 是什麼
殼層 (shell) 是讓你打字命令給作業系統的程式。Windows 的 PowerShell、cmd 都是殼層；Linux 上常見的是 bash、zsh。
終端機 (terminal) 是顯示殼層的視窗。你看到的黑底白字就是終端機。
WSL 把一個完整 Linux 跑在你 Windows 裡（不是虛擬機，效能接近原生）。Hermes 在 Linux 跑，所以我們要它。
等下載時可以順便做：把下一步要的 OpenRouter 開起來
下載 5–10 分鐘是死時間，可以順手開另一個瀏覽器分頁跑下一步：Step 3 · 申請 OpenRouter API Key
🚨 我卡住了
- Windows 太舊（1903 以下）→ 先跑 Windows Update 再回來
- 跳「WSL not enabled」→ 跑
wsl --install --no-distribution重啟、再跑wsl --install -d Ubuntu - 跳「具有所提供名稱的發佈已經存在」（英文版：A distribution with the supplied name already exists，錯誤碼
Wsl/InstallDistro/ERROR_ALREADY_EXISTS）→ 表示這台機器之前裝過 Ubuntu。- 想沿用既有環境：跑
wsl -d Ubuntu直接啟動，跳到 Step 5。 - 想砍掉重來：
wsl --unregister Ubuntu再wsl --install -d Ubuntu。注意：unregister 會清掉舊 Ubuntu 裡的所有檔案，無法還原。
- 想沿用既有環境：跑
- 沒有管理員權限（公司電腦常見）→ 這台機器無法繼續，請改個人電腦
Step 3 / 9 · 申請 OpenRouter API Key
~5 分鐘，純瀏覽器操作
OpenRouter 是一個 LLM API 的整合入口：一支 API key 可以呼叫 200+ 模型，包含好幾個免費模型。課堂上我們會用免費的 deepseek 系列讓你不用刷卡就能跑通；課後若要重度使用，建議儲值 Credits 解鎖更穩定的付費 model。
動作
- 新分頁開啟 https://openrouter.ai
- 右上角「Sign In」→ 用 email 註冊（Google 登入也可以）
- 登入後進入 Dashboard → 左側 Keys
- 點「Create Key」→ 名稱隨便（例：
hermes-course）→ 建立 - ⚠️ Key 只會顯示一次，立刻複製，貼到 Windows 的「記事本」暫存
- （建議）回 Dashboard 左側點 Credits（或直接訪 openrouter.ai/credits）→ 選
$5（新手建議起跳金額）→ 信用卡付款 → 餘額立即更新
建議試用的 model
免費路徑（課堂示範用）跟付費路徑都可以，看你手上有沒有 Credits：
- 免費：挑名稱含
deepseek且標:free的（例：deepseek/deepseek-chat:free） - 付費（推薦）：
deepseek/deepseek-v4-pro或minimax/minimax-m2.7——速度與穩定度都明顯比免費 model 好
為什麼需要 API key
API key 等於 hermes 對 OpenRouter 講話的密碼。每次發一句話，OpenRouter 用這把 key 認得是你、扣你帳號的額度。Key 外洩等於別人可以拿來用、花你的錢（雖然這次是免費 model，但養成好習慣不要外流）。
免費 model 是什麼意思（以及為什麼建議課後儲值）
OpenRouter 上一些 model（例如 deepseek/deepseek-chat:free、qwen 系列等）標註 :free，背後由提供方贊助、對使用者免費。
但有兩個現實限制：
- 速率限制：每分鐘只能打幾次，課堂中段可能會被擋
- 回應較不穩定：偶爾延遲很高、偶爾跳 error，不適合你想真的拿它做事
學會夠用，但**課後想日常使用 hermes 的話，建議儲值 $5 起跳**。OpenRouter 採按量計費（用多少付多少），$5 通常可以撐很久。儲值後就能用 deepseek/deepseek-v4-pro、minimax/minimax-m2.7，或 GPT/Claude/Gemini 等主流付費 model。
🚨 我卡住了
- 驗證信沒收到 → 等 2–3 分鐘、檢查垃圾信。還是沒有 → 改用 OpenAI 或 Anthropic（要刷卡）
- 不小心關掉 Create Key 視窗，key 沒抄到 → 沒救，回 Keys 頁面砍掉重建一支
Step 4 / 9 · 重啟 Windows
~5 分鐘
WSL 安裝完成後 Windows 會要求重新啟動。重啟後 Linux 子系統才會正式可用。
動作
- 回到 PowerShell 視窗，確認看到 「The requested operation is successful. Changes will not be effective until the system is rebooted.」 或類似訊息
- 儲存所有開著的工作（重啟後不會自動回來）
- Windows 開始功能表 → 電源 → 重新啟動
離開頁面也沒關係
這個教學頁會自動記得你看到第幾步。重啟完回來、重新打開這個網址，會自動跳回 Step 4，按下一步繼續。
Step 5 / 9 · Ubuntu 首次啟動
~7 分鐘
重啟後第一次啟動 Ubuntu 會做幾項初始化：建立你的 Linux 帳號、設密碼。這個帳號跟 Windows 帳號完全分開。
動作
- 開始功能表搜尋「Ubuntu」→ 開啟它
- 等待「
Installing, this may take a few minutes」訊息消失 - 看到
Enter new UNIX username:→ 打一個小寫、無空白的名字（例：lewsi）按 Enter - 看到
New password:→ 打密碼。螢幕不會顯示任何字元（連點點都沒有），這是正常的。打完按 Enter - 再打一次密碼確認 → 看到
$提示符就完成了 - 試打三個指令熟悉一下
練習指令
pwd
ls
cd ~Linux 終端機三招
pwd= print working directory，告訴你現在在哪個資料夾ls= list，列出當前資料夾內容cd ~= change directory，~是你的家目錄（home）
Linux 密碼為什麼不顯示
Unix 傳統。打字時不顯示任何字元（不像 Windows 顯示星號），是為了讓旁邊的人連密碼長度都看不到。新手第一次都以為鍵盤壞了。
🚨 我卡住了
- Username 顯示 invalid → 不能有大寫、空白、底線開頭。改成全小寫純字母
- 兩次密碼不一樣 → 它會要你重來，沒事
- Ubuntu app 一直顯示 Installing → 等到 5 分鐘以上沒動 → 關掉重開（資料不會丟）
Step 6 / 9 · 安裝 hermes
~15 分鐘（多半在等下載）
這是整堂課最久的一段。一行 curl 指令會下載官方安裝腳本並立刻執行：裝 uv、建 Python 虛擬環境、把 hermes 裝進去、把 hermes 指令連結到你的 PATH。
動作
- 確認你還在 Ubuntu 視窗、看到
$提示符 - 把下面整行貼進去（在 Ubuntu 終端機是 Ctrl+Shift+V 貼上）
- 按 Enter，看著它跑
- 看到
Hermes installed!訊息就完成（5–10 分鐘）
指令
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bashcurl | bash 在做什麼？這安全嗎？
curl 是「從網路抓檔」的指令；| bash 是「把抓到的內容直接餵給 bash 執行」。
等於：下載一個腳本立刻跑它。一般情況下這有風險（中間人攻擊或來源不可信），這次因為來源是 hermes 官方 GitHub repo、走 HTTPS、是業界廣泛使用的 quick-install 模式，所以可接受。
等下載時可以順便讀：下一步 hermes setup 會問你 4 件事
- Provider（供應商）→ 選 OpenRouter
- Model（模型）→ 選一個有「
:free」標籤的 deepseek 模型 - API Key → 貼你 Step 3 拿到的 key
- Tools / Terminal（工具與終端後端）→ 全部用預設按 Enter 跳過
先看一遍，下一步會比較不慌。
🚨 我卡住了
- 下載卡 5 分鐘以上沒動 → 正常，繼續等。網速差可能要 10 分鐘
- SSL certificate problem（極少）→ 跑
sudo apt update && sudo apt install -y ca-certificates後重試 - 結束後跑
hermes顯示 command not found → 跑source ~/.bashrc
Step 7 / 9 · hermes setup 設定精靈
~8 分鐘
hermes setup 是 hermes 官方的設定精靈，會依序問你 provider、model、API key、tools、terminal。我們會選 OpenRouter + 免費 deepseek 模型，其他全部預設。
動作
- 先 reload bash 環境，讓系統認得新的
hermes指令
source ~/.bashrc- 啟動精靈
hermes setup- 依下面 5 個提示一個一個填
5 個提示怎麼答
| 提示 | 選 / 填 |
|---|---|
| Choose your provider | 用方向鍵選 openrouter，Enter |
| Choose a model | 免費：挑名稱含 deepseek 且標 :free 的；付費（推薦）：deepseek/deepseek-v4-pro 或 minimax/minimax-m2.7。Enter |
| Enter your API key | ⚠️ 建議手動 key in（Ubuntu 終端機 paste 偶爾會把 key 截斷或變空白），或先看下面「補救」section 用 script 把 key 寫進 .env。若還是要 paste：Ctrl+Shift+V，Enter |
| Configure tools? | 直接 Enter（預設） |
| Configure terminal backend? | 直接 Enter（預設 = local） |
看到 Setup complete! 就成功。
每個提示在做什麼
- Provider = 你要呼叫哪家 LLM API（OpenAI、Anthropic、OpenRouter 等）
- Model = 那家底下的哪個模型
- API key = 拿來證明「這個請求是我發的」的密碼
- Tools = hermes 可以用哪些工具（讀檔、寫檔、執行指令等），先用預設安全
- Terminal backend = hermes 開新終端的方式（local = 直接在你 Ubuntu 跑）
🚨 我卡住了
- 不小心 Ctrl+C 中斷 → 重跑
hermes setup - API key 貼進去變空白 / 跑 hermes 出 400 error → 用下面的補救 script 直接改
~/.hermes/.env - 看不到
:free模型 → OpenRouter 偶爾會調整 free 列表，挑名字最像的，下一步試了就知道
補救：直接改 hermes 的 .env
hermes 的 API key 存在 ~/.hermes/.env。如果 hermes setup 在 TUI 裡 paste 出問題（截斷、變空白），最快的修法是直接 sed 改這支檔案——不必重跑整個 setup 精靈。
此為 hermes 上游官方暫未完全修正 paste 問題的繞行解。下面兩個版本擇一用：
Variant A · 互動腳本（推薦）
貼 key 進去後自動寫入 .env，避免在 TUI 裡 paste：
cd ~/.hermes && read -sp "Paste your OpenRouter API key: " KEY && echo && sed -i "s/^OPENROUTER_API_KEY=.*/export OPENROUTER_API_KEY=$KEY/" .env && unset KEYVariant B · 手動範本
把 YOUR_API_KEY 替換成你的實際 key 再貼進終端機：
cd ~/.hermes && sed -i 's/^OPENROUTER_API_KEY=.*/export OPENROUTER_API_KEY=YOUR_API_KEY/' .env跑完任一個之後，下一步直接 hermes 就能對話。
Step 8 / 9 · 第一次對話
~5 分鐘
所有設定完成。打 hermes 啟動 TUI（文字介面），然後跟它講話。
動作
- 啟動 hermes
hermes- 看到 hermes 的 ASCII art 標題 + 輸入框
- 打第一句話試試看，例如：
介紹一下你自己- 按 Enter，你會看到回應 一個字一個字浮出來（streaming）
- 多聊幾句也行
- 結束對話 → 打
/exit按 Enter，或按 Ctrl+D
什麼是 streaming
LLM 一次產生一個 token（大約一個字或半個詞），生一個吐一個給你看，不用等整段話算完。這就是你看到的「打字機效果」。技術上這是 Server-Sent Events 的 chunked response。
常用 hermes 指令
/new或/reset— 開新對話（清空當前 context）/model— 切換 model/exit— 結束Ctrl+C— 中斷當前回應（不離開 hermes）
🚨 我卡住了
- 跑
hermes收到 400 / Unauthorized → API key 沒寫對。最常見原因是 Step 7 在 TUI 裡 paste 時被截斷。回 Step 7 結尾的「補救：直接改 hermes 的 .env」section，跑 Variant A 或 B 任一個，再執行hermes即可。不必重跑hermes setup。 - 送出後沒回應、卡很久 → 免費模型的速率限制。Ctrl+C 中斷，跑
/model換另一個 free model - 顯示亂碼或方框 → Windows Terminal 字型問題。設定 → Profile → Ubuntu → 字型改
Cascadia Code或Consolas - 所有設定看起來都對但跑 hermes 出 error → 跑
hermes doctor，它會告訴你哪邊配置有問題
Step 9 / 9 · 你做到了 + 下一步
~5 分鐘
恭喜，4 個 checkpoints 都完成：
- ✓ WSL2 + Ubuntu 安裝
- ✓ OpenRouter API key
- ✓ hermes-agent 安裝
- ✓ 第一次對話
建議下一步
- 把這個頁面 加書籤，未來想複習可以隨時回來
- 跑
hermes doctor做一次體檢，確認所有元件都健康 - 下次課程：把 hermes 接到 LINE 或 Telegram，這樣可以從手機跟它講話
加碼 A：申請 LINE Messaging API channel
下一堂課要用，現在拿 token 之後可以直接接通。
- 開 https://developers.line.biz/console/
- 用你的 LINE 帳號登入
- 「Create new provider」→ 隨便取名（例：
my-hermes） - 進入 provider → 「Create a Messaging API channel」→ 填 channel 名稱、icon、類別
- 建立後進入 channel → 「Messaging API」分頁
- 找到 Channel access token (long-lived) → Issue → 複製到記事本
加碼 B：申請 Telegram bot
比 LINE 更快，2 分鐘。
- 在你手機/電腦的 Telegram 開 @BotFather
- 送
/newbot - 依提示填 bot 顯示名稱、username（必須
_bot結尾） - BotFather 會回一段話，裡面有 HTTP API token（一串長字元）
- 複製到記事本
✓ 拿到 token 了？接著進 Lesson 2 · Telegram 整合，把這支 bot 接通到 hermes。
到這邊就是今天的全部內容。下次見。