如何在 MS Windows 裡，安全地安裝 Hermes Agent

6月 09, 2026

readme.md

最近很紅的 AI 代理工具 Hermes Agent 讓使用者可以安裝一個 AI 秘書處理工作，然而由於這個 agent 的權限很大，為了避免試用時誤傷自己電腦的資料，有的朋友選擇了用一台全新的獨立電腦如 Mac mini 來玩，或是部署在 VPS 雲端上，這是最安全的做法。

然而，如果要在自己的 MS Windows 下來安裝，又要確保 Hermes Agent 安裝在獨立的環境，不會讀到原有電腦其它資料。這裡整理一種方法，就是在 Windows 系統下模擬一個 Ubuntu Linux 系統，然後安裝 Hermes Agent，這麼一來，它的權限就只會侷限在 Linux 系統裡的工作資料夾了。

由於筆者的電腦系統仍是舊的 Windows 10，故以此來說明。但是用 Windows 11 是一樣可以的。

在 Windows 10 中使用 WSL 2 和 Docker 部署 Hermes Agent（通常為基於大語言模型的 AI Agent 執行環境，如 Hermes-Agent / SuperAGI 或類似開源專案）是一個非常高效的選擇。

以下為您整理出 Step-by-Step 安裝指南。

在 Windows 下安裝虛擬 Ubuntu 環境

準備工作：啟用 WSL 2 與安裝 Ubuntu

如果您的電腦尚未啟用 WSL 2，請先依序執行以下步驟：

1. 啟用 Windows 功能

在 Windows 搜尋列輸入 PowerShell 或 cmd，按右鍵選擇「以系統管理員身分執行」，打開終端機視窗。
複製並貼上以下指令，啟用 WSL 和虛擬機器平台功能：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重新啟動電腦以套用變更。

2. 設定 WSL 2 為預設版本

重啟後，再次打開 PowerShell（系統管理員），輸入以下指令：

wsl --set-default-version 2

3. 安裝 Linux 發行版（推薦 Ubuntu）

在 PowerShell 中輸入以下指令來安裝 Ubuntu：

wsl --install -d Ubuntu-24.04

安裝完成後，系統會自動彈出 Linux 視窗，並在終端機文字視窗裡，要求您設定 Username（使用者名稱） 和 Password（密碼）。請牢記此密碼（輸入密碼時畫面不會顯示任何字元，這是正常的）。

在 Ubuntu 環境安裝 Hermes Agent

方法一：用 Hermes Agent 官網提供的安裝方法（最原味）

**事前準備：**建議先在手機安裝好 Telegram，並且在 Ubuntu 先安裝好 qrcode 套件，以方便待會直接自動設定 Telegram 串接：

pip install qrcode

只要在 Ubuntu 的終端機視窗輸入以下指令：

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

然後再進行互動式安裝設定，

接著輸入：

hermes setup

輸入以下指令啟動手機通訊的 gateway：

hermes gateway

啟動 Hermes 聊天介面：

hermes chat

或啟動 Hermes TUI 介面：

hermes -tui

就可以開始下指令和提問了。

方法二：使用 Docker 安裝 Hermes Agent（較安全）

第一步：安裝 Windows 版 Docker Desktop

為了讓 Docker 與 WSL 2 完美結合，最快也最穩定的方式是安裝 Docker Desktop。

前往 Docker 官網下載 Windows 版本的 Docker Desktop 安裝檔。
執行安裝檔，請務必勾選 "Use the WSL 2 based engine"（使用基於 WSL 2 的引擎）選項。
安裝完成後，系統可能會要求您登出或重啟電腦。
打開 Docker Desktop，點擊右上角的 齒輪圖標 (Settings)：

移至 General，確認勾選 Use the WSL 2 based engine。
移至 Resources > WSL Integration，將 Ubuntu（或您安裝的 Linux 名稱）開關打開（Enable）。
點擊 Apply & restart。

💡 檢查點： 打開您的 Ubuntu 終端機，輸入 docker --version 和 docker compose version。如果能正確顯示版本號，代表 Docker 已經成功穿透到 WSL 2 環境中了！

第二步：在 WSL 2 中安裝 Hermes Agent 專案

接下來的操作，請全部在 Ubuntu 終端機（WSL 環境）中執行。

1. 更新系統套件

在 Ubuntu 中輸入以下指令，以更新系統檔案（會要求輸入您剛剛建立的 Linux 密碼）：

sudo apt update
sudo apt upgrade -y

2. 安裝 docker

# 安裝 Docker
sudo apt-get install -y docker.io

# 啟動並設定 Docker 開機自動執行
sudo systemctl start docker
sudo systemctl enable docker

# 將目前使用者加入 docker 群組（免去每次都要打 sudo）
sudo usermod -aG docker $USER

注意：執行完 usermod 後，請輸入 exit 登出 SSH，再重新連線進來，群組設定才會生效。

3. 安裝 Hermes Agent

如果要設定用 Telegram 來串接 Hermes Agent，請先在手機上安裝好 Telegram app。

# 建立本機資料夾用來存放 Hermes 的資料與設定檔
mkdir -p ~/.hermes

# 互動式安裝設定
docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup

Quick setup：選擇此項開始快速設定。
試用可選免費方案：過程中依指示開啟 Hermes 的帳號設定網頁，試用可選擇免費方案。
模型選擇：試用可選擇免費語言模型 nvidia/nemotron-3-ultra:free 。
Storage：選擇 Keep current (local) 保持存在本地。
Messaging：選擇 Set up messaging now 開始設定通訊軟體（選擇 Telegram)。

4. 啟動 Hermes Agent

docker run -d \
  --name hermes-agent \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  nousresearch/hermes-agent gateway run

檢查是否正常運行

# 查看是否掛載
docker ps

# 查看日誌最後 50 行
docker logs hermes-agent --tail 50

若有掛載，且在 log 裡看到 ⚕ Hermes Gateway Starting... 等文字，就代表成功了。最後的 WARNING 可以忽略不理。

可以在終端機輸入以下指令，進入聊天模式：

docker exec -it hermes-agent hermes

若在終端機上看到啟動畫面，恭喜成功了！可以輸入指令，例如：/model 查看目前使用的語言模型。或 /status 查看目前系統狀態。也可以直接問問題："今天台北天氣如何？"

或進入文字模式的使用者介面（TUI）來下指令或問問題：

docker exec -it hermes-agent hermes --tui

之後若想暫時關閉 Hermes Agent 服務，可以輸入：

docker stop hermes-agent

若要重新啟動：

docker start hermes-agent

Have fun!

搜尋

Dr. HSIEH MEDIA LAB