Hermes Agent 安裝報告

-

 # Hermes Agent 安裝報告

**整理日期：** 2026年4月  
**平台：** Windows 筆記本電腦 + CUDA  
**目標：** 於 WSL2 (Ubuntu) 環境安裝 Hermes Agent 並連接本地 LLM / Moonshot API

---

## 目錄
1. [環境準備](#環境準備)
2. [WSL2 與 Ubuntu 安裝](#wsl2-與-ubuntu-安裝)
3. [Hermes Agent 安裝](#hermes-agent-安裝)
4. [模型配置與調試](#模型配置與調試)
5. [常見問題與解決方案](#常見問題與解決方案)
6. [最終配置](#最終配置)

---

## 環境準備

### 系統要求
- Windows 10/11 (建議 Windows 11)
- 已啟用虛擬化功能 (Virtual Machine Platform)
- PowerShell (Administrator 權限)

---

## WSL2 與 Ubuntu 安裝

### 步驟 1：安裝 WSL2
以系統管理員身份開啟 PowerShell，執行：

```powershell
wsl --install
```

**預期輸出：**
```
正在下載：Windows 子系統 Linux 版 2.6.3
正在安裝：Windows 子系統 Linux 版 2.6.3
已成功執行所要求的操作。請重新開機，變更才能生效。
```

> ⚠️ **注意：** 安裝完成後必須重新開機

### 步驟 2：安裝 Ubuntu
重新開機後，再次以系統管理員身份開啟 PowerShell：

```powershell
wsl --install -d Ubuntu
```

**設定 Unix 使用者帳戶：**
```
Create a default Unix user account: [輸入用戶名]
New password: [輸入密碼]
Retype new password: [確認密碼]
passwd: password updated successfully
```

### 步驟 3：驗證安裝
開啟新 PowerShell 視窗，執行：

```powershell
wsl -l -v
```

**預期輸出：**
```
  NAME      STATE           VERSION
* Ubuntu    Running         2
```

---

## Hermes Agent 安裝

### 步驟 4：更新系統
於 Ubuntu 終端機執行：

```bash
sudo apt update && sudo apt upgrade -y
```

### 步驟 5：執行安裝腳本

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

### 步驟 6：設定 Hermes Agent
執行設定精靈：

```bash
hermes setup
```

**選擇設定模式：**
```
How would you like to set up Hermes?
 →  Quick setup — provider, model & messaging (recommended)
    Full setup — configure everything
```

**選擇 Provider：**
```
Select provider:
    ...
 →  More providers...
```

**選擇自定義端點：**
```
 →  Custom endpoint (enter URL manually)
```

**配置本地 LLM (Ollama)：**
```
API base URL: http://[WSL網關IP]:11434/v1
API key: [留空]
Model name: gemma4:e4b
Context length: 8192 或留空
```

**設定訊息平台：**
```
Connect a messaging platform?
 →  Set up messaging now (recommended)
    Skip — set up later with 'hermes setup gateway'
```

> 💡 **提示：** 如暫時不需 Telegram/Discord 整合，可直接按 Enter 跳過

### 步驟 7：驗證安裝
安裝完成後，工具可用性摘要：

```
◆ Tool Availability Summary
  6/11 tool categories available:

   ✓ Vision (image analysis)
   ✗ Mixture of Agents (missing OPENROUTER_API_KEY)
   ✗ Web Search & Extract (missing API keys)
   ✓ Browser Automation (Local browser)
   ✗ Image Generation (missing FAL_KEY)
   ✓ Text-to-Speech (Edge TTS)
   ✗ RL Training (missing TINKER_API_KEY)
   ✗ Skills Hub (missing GITHUB_TOKEN)
   ✓ Terminal/Commands
   ✓ Task Planning (todo)
   ✓ Skills (view, create, edit)
```

**常用指令：**
```bash
hermes              # 開始對話
hermes gateway      # 啟動訊息閘道
hermes doctor       # 檢查問題
hermes config       # 查看設定
```

---

## 模型配置與調試

### 關鍵：確定 WSL 網關 IP

於 WSL Ubuntu 開啟**第二個終端機視窗**，執行：

```bash
# 方法 1：查看 DNS 設定
cat /etc/resolv.conf
# 尋找 nameserver 後的 IP（例如 172.25.80.1）

# 方法 2：查看路由（推薦）
ip route | grep default
# 尋找 default via 後的 IP（例如 172.21.96.1）
```

> ⚠️ **重要：** 此 IP 每次 WSL 重新啟動可能改變，請務必確認

### 修正配置
如安裝時輸入錯誤 IP，可直接修改設定：

```bash
hermes config set model.base_url http://[正確IP]:11434/v1
hermes config set model.name gemma4:e4b
```

或手動編輯設定檔：

```bash
nano ~/.hermes/config.yaml
```

**需修改欄位：**
- `base_url`: 更正為正確的 WSL 網關 IP
- `model`: 更正為正確的模型名稱

---

## 常見問題與解決方案

### 問題 1：Hermes 顯示 "formulating..." 後無回應

**原因：** 無法連線至 Ollama（IP 錯誤或 Ollama 未啟動）

**解決：**
1. 按 `Ctrl + C` 強制結束
2. 確認正確 WSL 網關 IP
3. 確認 Ollama 於 Windows 端已啟動：
   ```bash
   curl http://[WSL網關IP]:11434/api/tags
   ```
4. 修正配置後重新啟動

### 問題 2：Gemma 4 模型反應異常

**現象：** 回應不自然、邏輯混亂

**解決：** 改用 Moonshot Kimi 2.5 或其他商業 API

### 問題 3：Moonshot API 端點錯誤

**現象：** Hermes 預設使用 `https://api.moonshot.ai/v1`，但實際需使用 `https://api.moonshot.cn/v1`

**解決：** 使用自定義端點設定：
```bash
hermes config set model.base_url https://api.moonshot.cn/v1
hermes config set model.default kimi-2.5
```

---

## 最終配置

### 本地 LLM 配置（Ollama + Gemma）

```bash
hermes config set model.base_url http://172.21.96.1:11434/v1
hermes config set model.default gemma4:e4b
```

**驗證 Ollama 連線：**
```bash
curl http://172.21.96.1:11434/api/tags
```

### Moonshot API 配置（推薦）

```bash
hermes config set model.base_url https://api.moonshot.cn/v1
hermes config set model.default kimi-2.5
```

---

## 附錄：檔案位置

| 類型 | 路徑 |
|------|------|
| 主要設定 | `~/.hermes/config.yaml` |
| API 金鑰 | `~/.hermes/.env` |
| 資料儲存 | `~/.hermes/cron/`, `~/.hermes/sessions/`, `~/.hermes/logs/` |

---

## 總結

本安裝流程涵蓋：
1. ✅ WSL2 + Ubuntu 環境建立
2. ✅ Hermes Agent 安裝與基礎設定
3. ✅ 本地 LLM (Ollama) 連線配置
4. ✅ Moonshot API 整合
5. ✅ 常見問題排解

**建議：** 如追求穩定性，建議使用 Moonshot Kimi 2.5 而非本地 Gemma 4 模型。

---

*報告整理完成*

留言

張貼留言

這個網誌中的熱門文章

Fortigate IP/MAC 綁定，更嚴謹的網路控管。

-
這類文章網上很多了，所以本篇是寫給我自己看的。 談到Firewall的IP/MAC綁定，先說明其功用。所謂IP/MAC綁定，即是IP/MAC Binding，意思是檢查到達Firewall並要出去外網的IP封包，是否附合指定的MAC。更簡單來說，指定的電腦要配合管理員指定的IP，才能通過Firewall出去外網。 通常幾步要做。 一‧ 設定DHCP Server 就是因應不同上網設備(或更深層地說，是網卡)，給他們指定固定的內網IP，在IP/MAC綁定上是必要的，如果DHCP Server本身不能派給上網設備一個指定的IP，可能讓設備本身得不到正確的IP而不能上網。當然，就算不做IP/MAC綁定也好，為了方便Firewall Policy的設置，也應該做一個DHCP指定IP的設定。設定步驟如下： 打開Console >config system dhcp reserved-address >edit Ivan-Computer >set ip 192.168.1.100 >set mac 00:aa:bb:cc:dd:ee >end 二. 設定IP/MAC Binding table 設定好DHCP reserved table之後，就要設定IP/MAC Binding table。這個表記載著MAC與IP的配對資料。設定步驟如下： 打開Console >config firewall ipmacbinding table >edit 1  (註: 用數字作為id) >set ip 192.168.1.100 >set mac 00:aa:bb:cc:dd:ee >set name Ivan-Computer >set status enable >end 三. 啟動Firewall上的IP/MAC Bindnig DHCP和IPMAC Binding 的表都設置完成後，就可以啟動Firewall上的IP/MAC Binding。 設置步驟如下： 打開Console >config firewall ipmacbinding setting >set bindthroughfw enable ...
<< 繼續閱讀 >>

Fortigate 不同型號間的Firewall Configuration 檔案轉換

-
來源: http://kb.fortinet.com/kb/documentLink.do?externalID=10063 Technical Tip : How to load/convert a FortiGate configuration file from one unit to another (file conversion for a different model). This article explains how to transfer a FortiGate configuration file to a new   FortiGate unit of a different model.   1.  Open the backup configuration file from the previous and different FortiGate Unit. 2.  Download a backup of a new configuration file from the new unit. This procedure is   different depending on which FortiOS version is running on the FortiGate: In FortiOS 3.0, 4.0, 4.1.x, download a factory default configuration file from    System>Maintenance>Backup&Restore In FortiOS 4.2 download a factory default configuration file from   System>Dashboard>System Information>System Configuration 3.  From the factory default configuration file copy the "config-version"...
<< 繼續閱讀 >>

Fortigate 只接受特定外網IP 進行PING

-
圖片
Fortigate 只接受特定外網IP 要設定，讓特定外網IP Ping Fortigate，在執行上比較麻煩，意思是你不能特別關閉PING，再讓PING端口開啟給一個指定IP。 求其次，你只能設置讓特定IP能訪問Fortigate Firewall，順便能PING。 一般來說，Interfaces裡的Restricted Access功能，大家都很熟悉，裡面能讓WAN開啟HTTPS，SSH，PING服務去做管理，而這個Restricted Access部份，是設計給”Administrator”使用的。意思是指 System>Administrators 裡面的Users。 所以，只要修改Administrators>admin，裡面Enable “Restrict login to trust hosts” ，並加入管理者的常用外網IP，就能讓Fortigate只接受特定IP訪問，包括HTTPS和PING。 但有種情況，我只想要某IP，只能PING，而不能做其他訪問，要如何做？ 以下解說： 1. 在System>Admin Profiles 新增一個Admin設置，老外都喜歡叫no_logon，Access Control設成全部None。 2. 在System>Administrators 新增一個User，例如ping_only， Administrator Profile設成剛剛的no_logon。 3. 把剛剛新增的User的Restrict login to trusted hosts. 並設置指定外網IP。 4. 單是限制這個User並不足夠，「所有」其他Admin帳戶都要設置Restrict login to trusted hosts. 並設置成管理者常用的外網IP。 增加no_logon的Admin Profile，設置為「無權限」 為ping_only新增一個trust host 結論可想而見， ping_only的trusted hosts可以PING到該Fortigate Firewall，但不能登錄。 而admin帳戶的Trust hosts就可以Ping可以登錄。 後記，有些...
<< 繼續閱讀 >>