從零開始，手把手教你安裝配置 Hermes Agent —— 一個支持工具調(diào)用的 AI 助手

前言

最近 AI 編程助手層出不窮，但大多數(shù)都局限于網(wǎng)頁聊天或 IDE 插件。今天給大家介紹一個真正能在本地調(diào)用工具、執(zhí)行命令、管理文件的 AI Agent —— Hermes Agent。

它能做什么？

• 直接在終端里和 AI 對話
• 讓 AI 幫你讀寫文件、執(zhí)行命令
• 管理定時任務(wù)、瀏覽網(wǎng)頁、搜索信息
• 支持多種模型（OpenAI、Kimi、Claude 等）
• 擁有技能系統(tǒng)，可擴展功能

本文將帶你從零開始，一步步完成安裝和配置。

一、環(huán)境準備

1.1 系統(tǒng)要求

• 操作系統(tǒng)：macOS / Linux / Windows (WSL2) / Android (Termux)
• 網(wǎng)絡(luò)：能訪問 GitHub 和模型 API
• 注意：安裝腳本會自動處理 Python 環(huán)境，無需手動安裝

1.2 安裝 uv（可選但推薦）

雖然 Hermes 安裝腳本會自動處理依賴，但如果你希望使用更快的 Python 包管理器，可以提前安裝 uv：

curl -LsSf https://astral.sh/uv/install.sh | sh

安裝完成后，重啟終端或執(zhí)行：

source ~/.bashrc  # 或 ~/.zshrc

驗證安裝：

uv --version

提示：不安裝 uv 也能正常使用 Hermes，安裝腳本會自動使用系統(tǒng)自帶的 pip。

二、Windows 系統(tǒng)安裝指南

重要：Hermes Agent 不支持原生 Windows。Windows 用戶必須通過 WSL2（Windows Subsystem for Linux）來安裝和運行。

2.1 安裝 WSL2

步驟 1：檢查 Windows 版本

按 Win + R，輸入 winver，回車。確保你的 Windows 版本是：

• Windows 10：版本 2004 或更高（內(nèi)部版本 19041 或更高）
• Windows 11：所有版本都支持

如果版本過低，請先更新 Windows。

步驟 2：啟用 WSL

以管理員身份打開 PowerShell（右鍵開始菜單 → Windows PowerShell (管理員)），執(zhí)行：

wsl --install

這個命令會自動：

1. 啟用 WSL2
2. 啟用虛擬機平臺
3. 下載并安裝 Ubuntu（默認發(fā)行版）
4. 將 WSL2 設(shè)置為默認版本

如果已經(jīng)安裝了 WSL1，需要升級到 WSL2：

wsl --set-default-version 2

步驟 3：重啟電腦

安裝完成后，系統(tǒng)會提示你重啟。重啟后，Ubuntu 會自動繼續(xù)安裝。

步驟 4：配置 Ubuntu

重啟后，Ubuntu 會自動啟動，要求你設(shè)置：

1. 用戶名：輸入你喜歡的用戶名（如 hermes）
2. 密碼：輸入并確認密碼（輸入時不會顯示字符，這是正常的）

步驟 5：更新 Ubuntu 系統(tǒng)

在 Ubuntu 終端中執(zhí)行：

sudo apt update && sudo apt upgrade -y

步驟 6：安裝必要依賴

sudo apt install -y curl git build-essential

2.2 在 WSL2 中安裝 Hermes

現(xiàn)在你已經(jīng)進入了 Linux 環(huán)境，可以按照 Linux 的安裝方式繼續(xù)：

注意：先將電腦的科學(xué)上網(wǎng)的 TUN 模式 打開，它能讓你的終端在執(zhí)行指令時也走代理。

在 Ubuntu 終端中執(zhí)行：

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

這個腳本會自動：

1. 下載最新版 Hermes
2. 安裝到 ~/.local/bin/hermes
3. 配置環(huán)境變量

安裝完成后，執(zhí)行：

source ~/.bashrc
hermes --version

如果看到版本信息，說明安裝成功！

2.3 配置 Windows 終端（推薦）

為了獲得更好的使用體驗，建議安裝 Windows Terminal：

1. 打開 Microsoft Store
2. 搜索 "Windows Terminal"
3. 點擊安裝

安裝后，你可以：

• 同時打開多個標簽頁（PowerShell、CMD、Ubuntu）
• 自定義主題和字體
• 使用快捷鍵快速切換

設(shè)置默認啟動 WSL：

打開 Windows Terminal → 設(shè)置 → 啟動 → 默認配置文件 → 選擇 "Ubuntu"

2.4 WSL2 常見問題

Q1: WSL 安裝失敗，提示 "虛擬機平臺未啟用"？

以管理員身份打開 PowerShell，執(zhí)行：

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

然后重啟電腦，再次嘗試安裝。

Q2: 如何進入 WSL 的 Ubuntu？

方法 1：在開始菜單搜索 "Ubuntu"，點擊打開

方法 2：在 PowerShell/CMD 中執(zhí)行：

wsl

方法 3：在文件資源管理器地址欄輸入 \\wsl$\Ubuntu，可以訪問 WSL 文件系統(tǒng)

Q3: WSL 中如何訪問 Windows 文件？

Windows 盤符會自動掛載到 /mnt 目錄：

# 訪問 C 盤
cd /mnt/c

# 訪問 D 盤
cd /mnt/d

# 訪問 Windows 桌面
cd /mnt/c/Users/你的用戶名/Desktop

Q4: 如何在 VS Code 中編輯 WSL 文件？

在 WSL 終端中執(zhí)行：

code .

這會自動安裝 VS Code 的 WSL 擴展，并在 Windows 上打開 VS Code 編輯 WSL 中的文件。

Q5: WSL 網(wǎng)絡(luò)連接問題？

如果 WSL 無法訪問網(wǎng)絡(luò)，嘗試：

# 在 PowerShell（管理員）中執(zhí)行
netsh winsock reset
netsh int ip reset
ipconfig /flushdns

然后重啟電腦。

三、macOS / Linux 安裝指南

3.1 一鍵安裝（推薦）

注意：先將電腦的科學(xué)上網(wǎng)的 TUN 模式 打開，它能讓你的終端在執(zhí)行指令時也走代理。

在終端中執(zhí)行以下命令：

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

這個腳本會自動：

1. 下載最新版 Hermes
2. 安裝到 ~/.local/bin/hermes
3. 配置環(huán)境變量

3.2 手動安裝

如果你不想用腳本，也可以手動安裝：

# 克隆倉庫
git clone https://github.com/hermes-agent/hermes.git

# 進入目錄
cd hermes

# 使用 uv 安裝
uv pip install -e .

# 或者使用 pip
pip install -e .

3.3 驗證安裝

安裝完成后，執(zhí)行：

hermes --version

如果看到類似下面的輸出，說明安裝成功：

Hermes Agent v0.10.0 (2026.4.16)
Project: /Users/yourname/.hermes/hermes-agent
Python: 3.11.15
OpenAI SDK: 2.32.0
Up to date

四、初始配置

4.1 運行配置向?qū)?/h3>

首次使用，建議運行交互式配置向?qū)В?/p>

hermes setup

這個向?qū)龑?dǎo)你完成：

• 選擇默認模型和提供商
• 配置 API 密鑰
• 設(shè)置工具集
• 選擇個性化風格

4.2 手動配置

如果你更喜歡手動配置，可以直接編輯配置文件：

# 打開配置文件
hermes config

或者直接用編輯器打開：

# macOS
open ~/.hermes/config.yaml

# Linux/WSL
nano ~/.hermes/config.yaml

4.3 配置文件詳解

一個典型的 config.yaml 如下：

model:
  default: kimi-k2.6          # 默認使用的模型
  provider: kimi-coding       # 模型提供商
  base_url: https://api.kimi.com/coding  # API 地址
providers: {}                 # 額外的提供商配置
fallback_providers: []        # 備用提供商
toolsets:
  - hermes-cli                # 啟用的工具集
agent:
  max_turns: 90               # 最大對話輪數(shù)
  gateway_timeout: 1800       # 網(wǎng)關(guān)超時時間（秒）
  verbose: false              # 是否顯示詳細信息
  reasoning_effort: medium    # 推理強度

五、配置 API 密鑰

5.1 獲取 API Key

根據(jù)你選擇的模型提供商，獲取對應(yīng)的 API Key：

5.2 設(shè)置 API Key

方式一：環(huán)境變量（推薦）

# 臨時設(shè)置（當前終端會話有效）
export KIMI_API_KEY="your-api-key-here"

# 永久設(shè)置（添加到 ~/.zshrc 或 ~/.bashrc）
echo 'export KIMI_API_KEY="your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

方式二：使用 hermes login

hermes login kimi-coding

按提示輸入你的 API Key。

方式三：直接寫入配置文件

編輯 ~/.hermes/config.yaml：

providers:
  kimi-coding:
    api_key: "your-api-key-here"

六、啟動你的第一次對話

6.1 交互式聊天

hermes chat

進入交互模式后，你可以直接輸入問題，Hermes 會調(diào)用 AI 回答。

6.2 常用命令速查

# 查看幫助
hermes --help

# 查看狀態(tài)
hermes status

# 檢查配置和依賴
hermes doctor

# 更新到最新版本
hermes update

# 查看會話歷史
hermes sessions list

# 恢復(fù)之前的會話
hermes --resume <session-id>

七、進階配置

7.1 安裝技能（Skills）

Hermes 支持技能系統(tǒng)，可以擴展功能：

# 查看可用技能
hermes skills list

# 安裝技能
hermes skills install <skill-name>

# 例如安裝瀏覽器技能
hermes skills install browser

7.2 配置 MCP 服務(wù)器

MCP（Model Context Protocol）讓 Hermes 能連接更多工具：

# 查看 MCP 配置
hermes mcp list

# 添加 MCP 服務(wù)器
hermes mcp add <name> <command>

7.3 設(shè)置定時任務(wù)

# 查看定時任務(wù)
hermes cron list

# 創(chuàng)建定時任務(wù)
hermes cron create --schedule "0 9 * * *" --prompt "每天早上9點提醒我"

7.4 個性化風格

Hermes 內(nèi)置多種對話風格，可以在配置中選擇：

agent:
  personality: helpful  # 可選: helpful, concise, technical, creative, teacher, kawaii, catgirl, pirate, shakespeare

八、常見問題

Q1: 安裝時提示權(quán)限不足？

# 使用 sudo 或修改安裝路徑
sudo curl -fsSL ... | bash

# 或者安裝到用戶目錄
export HERMES_INSTALL_DIR="$HOME/.local"

Q2: 命令找不到？

檢查 ~/.local/bin 是否在 PATH 中：

echo $PATH | grep ".local/bin"

# 如果沒有，添加到 ~/.zshrc 或 ~/.bashrc
export PATH="$HOME/.local/bin:$PATH"

Q3: API 調(diào)用失敗？

1. 檢查 API Key 是否正確
2. 檢查網(wǎng)絡(luò)是否能訪問 API 地址
3. 查看余額是否充足
4. 使用 hermes doctor 診斷問題

Q4: 如何切換模型？

# 交互式選擇
hermes model

# 直接指定
hermes chat --model gpt-4

Q5: Windows 用戶遇到 "無法識別 hermes 命令"？

確保你在 WSL 的 Ubuntu 終端 中運行，而不是 Windows 的 PowerShell 或 CMD。

九、卸載

如果不需要了，可以一鍵卸載：

hermes uninstall

這會刪除：

• ~/.local/bin/hermes
• ~/.hermes/ 目錄
• 相關(guān)的環(huán)境變量配置

結(jié)語

Hermes Agent 是一個功能強大的本地 AI 助手，通過工具調(diào)用能力，它不僅能聊天，還能真正幫你完成實際工作。

安裝完成后，建議你：

1. 先嘗試簡單的對話熟悉交互
2. 逐步探索文件操作、命令執(zhí)行等工具
3. 根據(jù)需要安裝技能擴展功能
4. 加入社區(qū)交流使用心得

以上就是Hermes Agent保姆級安裝流程的詳細內(nèi)容，更多關(guān)于Hermes Agent安裝流程的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論