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

前言

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

它能做什么？

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

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

一、環(huán)境準(zhǔn)備

1.1 系統(tǒng)要求

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

1.2 安裝 uv（可選但推薦）

雖然 Hermes 安裝腳本會(huì)自動(dòng)處理依賴(lài)，但如果你希望使用更快的 Python 包管理器，可以提前安裝 uv：

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

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

source ~/.bashrc  # 或 ~/.zshrc

驗(yàn)證安裝：

uv --version

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

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

重要：Hermes Agent 不支持原生 Windows。Windows 用戶(hù)必須通過(guò) WSL2（Windows Subsystem for Linux）來(lái)安裝和運(yùn)行。

2.1 安裝 WSL2

步驟 1：檢查 Windows 版本

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

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

如果版本過(guò)低，請(qǐng)先更新 Windows。

步驟 2：?jiǎn)⒂?WSL

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

wsl --install

這個(gè)命令會(huì)自動(dòng)：

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

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

wsl --set-default-version 2

步驟 3：重啟電腦

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

步驟 4：配置 Ubuntu

重啟后，Ubuntu 會(huì)自動(dòng)啟動(dòng)，要求你設(shè)置：

1. 用戶(hù)名：輸入你喜歡的用戶(hù)名（如 hermes）
2. 密碼：輸入并確認(rèn)密碼（輸入時(shí)不會(huì)顯示字符，這是正常的）

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

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

sudo apt update && sudo apt upgrade -y

步驟 6：安裝必要依賴(lài)

sudo apt install -y curl git build-essential

2.2 在 WSL2 中安裝 Hermes

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

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

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

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

這個(gè)腳本會(huì)自動(dòng)：

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

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

source ~/.bashrc
hermes --version

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

2.3 配置 Windows 終端（推薦）

為了獲得更好的使用體驗(yàn)，建議安裝 Windows Terminal：

1. 打開(kāi) Microsoft Store
2. 搜索 "Windows Terminal"
3. 點(diǎn)擊安裝

安裝后，你可以：

• 同時(shí)打開(kāi)多個(gè)標(biāo)簽頁(yè)（PowerShell、CMD、Ubuntu）
• 自定義主題和字體
• 使用快捷鍵快速切換

設(shè)置默認(rèn)啟動(dòng) WSL：

打開(kāi) Windows Terminal → 設(shè)置 → 啟動(dòng) → 默認(rèn)配置文件 → 選擇 "Ubuntu"

2.4 WSL2 常見(jiàn)問(wèn)題

Q1: WSL 安裝失敗，提示 "虛擬機(jī)平臺(tái)未啟用"？

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

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

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

Q2: 如何進(jìn)入 WSL 的 Ubuntu？

方法 1：在開(kāi)始菜單搜索 "Ubuntu"，點(diǎn)擊打開(kāi)

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

wsl

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

Q3: WSL 中如何訪問(wèn) Windows 文件？

Windows 盤(pán)符會(huì)自動(dòng)掛載到 /mnt 目錄：

# 訪問(wèn) C 盤(pán)
cd /mnt/c

# 訪問(wèn) D 盤(pán)
cd /mnt/d

# 訪問(wèn) Windows 桌面
cd /mnt/c/Users/你的用戶(hù)名/Desktop

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

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

code .

這會(huì)自動(dòng)安裝 VS Code 的 WSL 擴(kuò)展，并在 Windows 上打開(kāi) VS Code 編輯 WSL 中的文件。

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

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

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

然后重啟電腦。

三、macOS / Linux 安裝指南

3.1 一鍵安裝（推薦）

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

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

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

這個(gè)腳本會(huì)自動(dòng)：

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

3.2 手動(dòng)安裝

如果你不想用腳本，也可以手動(dòng)安裝：

# 克隆倉(cāng)庫(kù)
git clone https://github.com/hermes-agent/hermes.git

# 進(jìn)入目錄
cd hermes

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

# 或者使用 pip
pip install -e .

3.3 驗(yàn)證安裝

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

hermes --version

如果看到類(lèi)似下面的輸出，說(shuō)明安裝成功：

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 運(yùn)行配置向?qū)?/h3>

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

hermes setup

這個(gè)向?qū)?huì)引導(dǎo)你完成：

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

4.2 手動(dòng)配置

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

# 打開(kāi)配置文件
hermes config

或者直接用編輯器打開(kāi)：

# macOS
open ~/.hermes/config.yaml

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

4.3 配置文件詳解

一個(gè)典型的 config.yaml 如下：

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

五、配置 API 密鑰

5.1 獲取 API Key

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

5.2 設(shè)置 API Key

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

# 臨時(shí)設(shè)置（當(dāng)前終端會(huì)話(huà)有效）
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。

方式三：直接寫(xiě)入配置文件

編輯 ~/.hermes/config.yaml：

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

六、啟動(dòng)你的第一次對(duì)話(huà)

6.1 交互式聊天

hermes chat

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

6.2 常用命令速查

# 查看幫助
hermes --help

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

# 檢查配置和依賴(lài)
hermes doctor

# 更新到最新版本
hermes update

# 查看會(huì)話(huà)歷史
hermes sessions list

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

七、進(jìn)階配置

7.1 安裝技能（Skills）

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

# 查看可用技能
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è)置定時(shí)任務(wù)

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

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

7.4 個(gè)性化風(fēng)格

Hermes 內(nèi)置多種對(duì)話(huà)風(fēng)格，可以在配置中選擇：

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

八、常見(jiàn)問(wèn)題

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

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

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

Q2: 命令找不到？

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

echo $PATH | grep ".local/bin"

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

Q3: API 調(diào)用失?。?/h3>

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

Q4: 如何切換模型？

# 交互式選擇
hermes model

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

Q5: Windows 用戶(hù)遇到 "無(wú)法識(shí)別 hermes 命令"？

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

九、卸載

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

hermes uninstall

這會(huì)刪除：

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

結(jié)語(yǔ)

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

安裝完成后，建議你：

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

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

最新評(píng)論