Hermes Agent 安裝教學

AI資訊

Hermes Agent 安裝教學

Hermes Agent 安裝教學：從零到上手5分鐘全攻略

Hermes Agent作為2026年最受矚目的開源AI代理框架，安裝過程極其簡化，一行指令即可完成所有環境配置與部署。這份完整教學涵蓋Windows、macOS、Linux三大平台，包含常見踩雷排除與進階生產環境設定，讓香港開發者快速部署個人AI助手。

 

系統需求與前置準備

Hermes Agent最低需求：

• 作業系統：Linux（Ubuntu 20.04+）、macOS 12+ 或 Windows（WSL2）

• Python：3.11+（自動安裝）

• 記憶體：4GB+ RAM（8GB推薦）

• 儲存空間：2GB+（技能庫隨使用增長）

• 網路：穩定連線（下載依賴與模型）

香港用戶注意：家用寬頻足夠，建議使用Hostinger或Vultr VPS（月費HK$50起）避免Token延遲。

 

方法一：一行指令快速安裝（推薦99%用戶）

這是最簡單途徑，官方腳本自動處理Python虛擬環境、Node.js、ripgrep、ffmpeg等20+依賴。

Linux/macOS終端機執行：

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

 

Windows用戶必經步驟：

1. 啟用WSL2（5分鐘）：

# 以系統管理員身分開PowerShell
wsl --install
# 重開機後從Microsoft Store安裝Ubuntu 22.04

 

2.進入Ubuntu終端，執行上述curl指令

安裝完成標誌：

✓ Hermes Agent v0.8.0+ installed successfully
✓ Global 'hermes' command available
✓ Configuration wizard ready: hermes setup

 

方法二：手動安裝（開發者進階）

適用需要自訂環境或離線部署：

# 1. 安裝Python 3.11（Ubuntu範例）
sudo apt update && sudo apt install python3.11 python3.11-venv python3-pip git curl

# 2. 克隆儲存庫（重要：包含子模組）
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# 3. 建立虛擬環境
python3.11 -m venv venv
source venv/bin/activate  # Windows: venvScriptsactivate

# 4. 安裝依賴
pip install -e ".[all]"
pip install -e "./tinker-atropos"
npm install

# 5. 建立設定目錄
mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills}
cp cli-config.yaml.example ~/.hermes/config.yaml

# 6. 建立全域指令
sudo ln -sf "$(pwd)/venv/bin/hermes" /usr/local/bin/hermes

 

初次設定精靈（3分鐘完成）

執行首次設定，所有選項都有安全預設：

hermes setup

 

關鍵設定說明：

1. LLM Provider [OpenRouter/Anthropic/OpenAI] → 輸入1（OpenRouter免費額度足夠）
2. API Key → 貼上你的 sk-or-v1-xxx（OpenRouter官網取得）
3. 預設模型 → qwen2.5-coder:7b（免費高效）
4. 記憶體容量 → 4096（預設足夠）
5. 啟用Telegram閘道？[Y/n] → Y（香港最方便）

 

Telegram Bot綁定（手機遠端控制）

香港用戶最愛的無縫體驗：

# 1. 建立Bot（Telegram搜尋 @BotFather）
/newbot → 取名HermesHK → 取得TOKEN

# 2. 取得User ID（搜尋 @userinfobot）
直接傳送訊息給機器人，複製回傳的數字

# 3. 設定環境變數
echo "TELEGRAM_TOKEN=你的TOKEN" >> ~/.hermes/.env
echo "TELEGRAM_USER_ID=你的ID" >> ~/.hermes/.env

# 4. 啟動閘道
hermes gateway start telegram

 

測試指令：Telegram傳送 /status，應回傳「Hermes Agent v0.8.0 已啟動」

Docker容器化部署（生產環境）

# docker-compose.yml
version: '3.8'
services:
  hermes:
    image: python:3.11-slim
    container_name: hermes-agent
    volumes:
      - ./hermes-agent:/app
      - hermes_data:/data
      - ./config:/root/.hermes
    environment:
      - PYTHONPATH=/app
      - HERMES_CONFIG_DIR=/root/.hermes
    ports:
      - "8000:8000"  # Web UI（選用）
    command: sh -c "pip install -e . && hermes gateway start"
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "hermes", "status"]
      interval: 30s
      timeout: 10s
      retries: 3

volumes:
  hermes_data:

 

執行：docker-compose up -d

常見問題排除（香港用戶專屬）

問題	解決方案
curl: command not found	sudo apt install curl
hermes: command not found	source ~/.bashrc 或重開終端
Telegram不回應	檢查 .env 檔案語法，無空格
OpenRouter連不上	香港用 mirror 網路模式，非 NAT
記憶體不足	VPS升級至2GB RAM或關閉語音功能
WSL2網路異常	wsl --shutdown 後重開PowerShell

驗證安裝與基本指令

# 診斷工具（必跑）
hermes doctor

# 檢查狀態
hermes status

# 進入互動模式
hermes chat

# 列出技能
hermes skills list

# 查看記憶體使用
hermes memory stats

Hermes Agent v0.8.0 (stable)
3 LLM providers configured
118 skills loaded
Memory: 2.1MB / 4GB (52%)
Gateways: Telegram, Discord

 

從OpenClaw遷移（30秒完成）

# 匯出OpenClaw記憶
cp ~/.claw/sessions/* ~/.hermes/sessions/
cp ~/.claw/skills/* ~/.hermes/skills/

# Hermes自動轉換格式
hermes migrate openclaw

 

進階生產部署：VPS一鍵腳本

#!/bin/bash
# hermes-vps-deploy.sh（香港Vultr優化）
apt update && apt upgrade -y
apt install htop ufw curl git -y
ufw allow 22 && ufw allow 443 && ufw enable

# 一鍵安裝+Telegram
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes setup --non-interactive --telegram

# 開機啟動
crontab -l > mycron
echo "@reboot /home/ubuntu/.local/bin/hermes gateway start telegram" >> mycron
crontab mycron

echo "Hermes Agent 已部署！傳送 /status 到Telegram測試"

 

Hermes Agent安裝完成後，你的AI將開始自我學習之旅。首次使用重點培養專屬技能，越用越符合你的遊戲開發、課程設計或奢侈品行銷需求，真正實現「專屬AI秘書」。立即部署，開啟智慧自動化新紀元！

 

可以瀏覽/報讀 「香港AI學院」的 「Hermes Agent AI教學課程」以了解及學習更多Hermes Agent各種設定、功能、技巧和應用。