Hermes Agent完整安裝教學筆記

初版：2026-04-10。2026-11-01依官方文件重新查證，有3處已改： ① 安裝腳本網址換了；② Windows現在可以直接裝，不一定要WSL2；③ 從OpenClaw搬家的指令改成hermes import-agent openclaw（舊的hermes claw migrate裝了外掛後仍可用）。官方文件：https://hermes-agent.nousresearch.com/docs

前置準備

不管VPS還是Windows，安裝前先確認有沒有git：

git --version

有出現版本號就可以開始。其他需要的東西（Python、Node.js、ffmpeg），初版時安裝腳本會自動處理；實際以安裝畫面為準。

方法一：VPS安裝（推薦，可以24小時待命）

初版是在Hostinger的VPS上裝，其他家的Linux VPS步驟相同。

Step 1｜SSH連線進VPS

ssh root@你的IP -p 你的PORT

Step 2｜一行指令安裝

官方現行的安裝指令（2026-11-01查證）：

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

等它跑完。這種「下載腳本直接執行」的方式，請確認網址是官方網域再貼。

Step 3｜重新載入shell

source ~/.bashrc

Step 4｜互動式設定

hermes setup

選擇模型供應商，填入API Key。初版時支援OpenRouter、Anthropic Claude、Google AI Studio、MiniMax等20多家；目前清單以設定畫面為準。

Step 5｜健康檢查

hermes doctor

有問題它會告訴你怎麼修。

Step 6｜綁定Telegram

1. 打開Telegram，搜尋 @BotFather
2. 輸入/newbot，幫Bot取名字
3. 複製拿到的Token（等於Bot的密碼，不要外流）
4. 回到VPS執行下面這行，選Telegram，貼上Token：

hermes gateway setup

Step 7｜設成背景服務（重開機自動啟動）

hermes gateway install
hermes gateway start

官方說明：install會把它裝成背景服務（Linux是systemd），start啟動這個服務。確認狀態：

hermes gateway status

Step 8｜Telegram測試

打開Telegram，找到你的Bot，傳一句話。有回應就代表部署完成。

方法二：Windows本機安裝

初版寫「Windows不直接支援，要先裝WSL2」。官方文件現在列出Windows原生安裝，用系統管理員以外的一般PowerShell執行即可（以官方頁面為準）：

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

想照初版用WSL2（Windows裡的Linux環境）也可以：

1. 用系統管理員開PowerShell，執行wsl --install，裝好後重開機
2. 開始選單搜尋「Ubuntu」打開，接著跟VPS一樣：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
source ~/.bashrc
hermes setup
hermes gateway setup

注意：裝在自己電腦上，電腦關機Agent就停了。想要24小時待命，建議用VPS。

從OpenClaw搬家（選用）

如果你目前在用OpenClaw，官方現在的做法是先裝匯入外掛，再預覽、確認後搬：

hermes plugins install agent-importers

hermes import-agent openclaw --dry-run

hermes import-agent openclaw

• --dry-run只預覽，不動任何東西
• 不加的話也會先顯示預覽，再問你要不要執行
• API Key預設不會搬；要一起搬，官方文件寫要加--migrate-secrets
• 新裝的Hermes第一次跑hermes setup，如果偵測到~/.openclaw，會主動問你要不要匯入

初版列的可搬內容是SOUL.md（人格設定）、記憶（MEMORY.md、USER.md）、Skills、API Keys、Telegram／Discord設定；實際搬了什麼，以預覽畫面為準。

常用指令速查

• hermes：開始對話
• hermes setup：重新設定
• hermes model：切換模型
• hermes doctor：健康檢查
• hermes update：更新版本
• hermes gateway start：啟動Gateway
• hermes gateway restart：重新啟動Gateway
• hermes gateway status：查看狀態
• hermes gateway stop：停止Gateway

指令會隨版本變，不確定時打hermes --help或看官方指令表：https://hermes-agent.nousresearch.com/docs/reference/cli-commands

相關連結

• 官方文件：https://hermes-agent.nousresearch.com/docs
• 從OpenClaw搬家：https://hermes-agent.nousresearch.com/docs/guides/migrate-from-openclaw
• GitHub：https://github.com/NousResearch/hermes-agent