一、什么是 Hermes Agent？

Hermes Agent 是由 Nous Research 開發(fā)的開源自主 AI 智能體（MIT 協(xié)議）。它不是綁定在集成編輯器上的編碼助手，也不是圍繞單一 API 的聊天機(jī)器人封裝——它是一個越用越強(qiáng)大的自主智能體，擁有獨(dú)一無二的閉環(huán)學(xué)習(xí)系統(tǒng)：

二、Hermes Desktop 桌面版核心功能

Hermes Desktop 是 Hermes Agent 的原生桌面應(yīng)用程序，提供圖形化界面，讓你無需命令行即可使用完整的 Agent 功能：

• Connect — 全平臺連接:Telegram、Discord、Slack、WhatsApp、Signal、郵件、CLI——以及持續(xù)增加的平臺。一個智能體，一份記憶，覆蓋所有渠道。
• Remember — 持久記憶:它會學(xué)習(xí)你的項(xiàng)目、自動生成技能，并且永遠(yuǎn)不會忘記它解決過的問題。
• Schedule — 自動化調(diào)度:用自然語言設(shè)置定時任務(wù)——報告、備份、簡報——通過網(wǎng)關(guān)無人值守運(yùn)行。
• Delegate — 任務(wù)委托:生成擁有獨(dú)立對話、終端和 Python RPC 腳本的隔離子智能體，實(shí)現(xiàn)零上下文成本的流水線。
• Search — 瀏覽網(wǎng)頁:網(wǎng)頁搜索、瀏覽器自動化、視覺理解、圖像生成、語音合成、多模型推理。
• Experiment — 隔離沙箱:五種后端——本地、Docker、SSH、Singularity、Modal——配合容器加固和命名空間隔離。

三、安裝前準(zhǔn)備

3.1 Windows 系統(tǒng)準(zhǔn)備

系統(tǒng)要求：

• Windows 10 或 Windows 11
• 至少 2GB 可用磁盤空間
• 穩(wěn)定的網(wǎng)絡(luò)連接

預(yù)先檢查：

打開 PowerShell（推薦使用管理員權(quán)限），確認(rèn)系統(tǒng)版本：

# 檢查 Windows 版本
[System.Environment]::OSVersion.Version
# 檢查是否有 Git（可選，安裝器會自動處理）
git --version

提示： Hermes 的 Windows 安裝器非常智能——它會自動處理所有依賴項(xiàng)（Python 3.11、Node.js v22、ripgrep、ffmpeg），甚至包含一個便攜式 Git Bash（MinGit，約 45MB），無需管理員權(quán)限，完全獨(dú)立于系統(tǒng)已安裝的 Git。如果你已經(jīng)安裝了 Git，安裝器會檢測到并使用它。

3.2 macOS 系統(tǒng)準(zhǔn)備

系統(tǒng)要求：

• macOS 12（Monterey）或更高版本
• 至少 2GB 可用磁盤空間
• 穩(wěn)定的網(wǎng)絡(luò)連接

預(yù)先檢查：

打開終端（Terminal），確認(rèn)系統(tǒng)版本和 Git：

# 檢查 macOS 版本
sw_vers

# 檢查 Git（安裝 Hermes 的唯一前置要求）
git --version

提示： 如果 macOS 上沒有 Git，請先安裝 Xcode Command Line Tools：

xcode-select --install

3.3 Linux 系統(tǒng)準(zhǔn)備

系統(tǒng)要求：

• 任意 Linux 發(fā)行版（Ubuntu、Debian、Fedora、Arch、openSUSE 等）
• 至少 2GB 可用磁盤空間
• 穩(wěn)定的網(wǎng)絡(luò)連接
• 唯一前置要求： Git

預(yù)先檢查：

# 檢查 Git 是否已安裝
git --version

# 如果沒有 Git，安裝它（Ubuntu/Debian）
sudo apt update && sudo apt install -y git

# Fedora
sudo dnf install -y git

# Arch
sudo pacman -S git

四、下載 Hermes Desktop 桌面版

官方下載地址

訪問 Hermes Desktop 官方頁面獲取最新版安裝包：

https://hermes-agent.nousresearch.com/desktop

注意： 請只從官方渠道下載。不要從第三方網(wǎng)站下載安裝包，以確保安全。

五、安裝過程詳解

5.1 Windows 安裝（詳細(xì)圖文步驟）

步驟 1：下載安裝程序

1. 打開瀏覽器，訪問 https://hermes-agent.nousresearch.com/desktop
2. 點(diǎn)擊 “Windows Download” 按鈕下載 Hermes-Setup.exe
3. 文件大小約 100-200MB，請耐心等待下載完成

步驟 2：運(yùn)行安裝程序

1. 雙擊下載的 Hermes-Setup.exe
2. 如果 Windows 彈出"Windows 已保護(hù)你的電腦"的提示：
   • 點(diǎn)擊 “更多信息”
   • 然后點(diǎn)擊 “仍要運(yùn)行”
3. 如果出現(xiàn)用戶賬戶控制（UAC）提示，點(diǎn)擊 “是”

步驟 3：跟隨安裝向?qū)?/p>

1. 選擇安裝路徑（默認(rèn)路徑即可，推薦保持默認(rèn)）
2. 等待安裝器自動下載和配置所有依賴項(xiàng)：
   • uv（快速 Python 包管理器）
   • Python 3.11（通過 uv 安裝，無需 sudo）
   • Node.js v22（用于瀏覽器自動化和 WhatsApp 網(wǎng)橋）
   • ripgrep（快速文件搜索）
   • ffmpeg（音頻格式轉(zhuǎn)換，用于 TTS）
   • MinGit（便攜式 Git Bash，約 45MB）
3. 等待倉庫克隆和虛擬環(huán)境創(chuàng)建完成

步驟 4：安裝完成

1. 安裝完成后，桌面會出現(xiàn) Hermes Agent 圖標(biāo)
2. 開始菜單中也會出現(xiàn) Hermes Agent 快捷方式
3. 命令行中 hermes 命令已全局可用

安裝器會自動處理一切： 依賴項(xiàng)安裝、倉庫克隆、虛擬環(huán)境創(chuàng)建、全局 hermes 命令設(shè)置和 LLM 提供者配置。安裝完成后即可直接使用。

1、直接生成啟動批處理，放在Downloads目錄

在 C:\Users\Administrator\Downloads 新建 RunHermes.bat，內(nèi)容：

@echo off
set WEBVIEW2_BROWSER_EXECUTABLE_FOLDER=%~dp0Microsoft.WebView2.FixedVersionRuntime.148.0.3967.96.x64
::改成你hermes.exe路徑
start "" "D:\你的Hermes目錄\hermes.exe"

2、先給文件夾放開權(quán)限（管理員CMD逐條運(yùn)行）

icacls "C:\Users\Administrator\Downloads\Microsoft.WebView2.FixedVersionRuntime.148.0.3967.96.x64" /grant *S-1-15-2-2:(OI)(CI)(RX)
icacls "C:\Users\Administrator\Downloads\Microsoft.WebView2.FixedVersionRuntime.148.0.3967.96.x64" /grant *S-1-15-2-1:(OI)(CI)(RX)

3、使用方式

右鍵RunHermes.bat→以管理員身份運(yùn)行，程序會自動讀取當(dāng)前目錄的WebView2，不再報缺失。

5.2 macOS 安裝

步驟 1：下載安裝程序

1. 打開瀏覽器，訪問 https://hermes-agent.nousresearch.com/desktop
2. 點(diǎn)擊 “Mac OS Download” 按鈕下載 Hermes-Setup.dmg

步驟 2：打開 DMG 鏡像

1. 雙擊下載的 Hermes-Setup.dmg
2. 如果 macOS 提示"無法驗(yàn)證開發(fā)者"：
   • 打開 系統(tǒng)設(shè)置 → 隱私與安全性
   • 找到被阻止的 Hermes 應(yīng)用，點(diǎn)擊 “仍然允許”
   • 或者在 DMG 窗口中右鍵點(diǎn)擊 Hermes 應(yīng)用，選擇 “打開”

步驟 3：安裝應(yīng)用

1. 將 Hermes 圖標(biāo)拖拽到 Applications 文件夾
2. 打開 Applications 文件夾，雙擊 Hermes 啟動

步驟 4：首次啟動

1. 首次啟動時，Hermes 會自動配置所需的依賴項(xiàng)
2. 等待初始化完成后即可使用

5.3 Linux 安裝

Linux 系統(tǒng)通過終端命令安裝桌面版：

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

--include-desktop 參數(shù)會同時安裝命令行工具和桌面應(yīng)用程序。

詳細(xì)的終端安裝過程如下：

# 步驟 1：下載并運(yùn)行安裝腳本（包含桌面版）
curl -fsSL https://hermes-agent.nousresearch.com/install.sh --include-desktop | bash

# 安裝腳本會自動執(zhí)行以下操作：
# ? 檢測并安裝 uv（Python 包管理器）
# ? 安裝 Python 3.11（通過 uv）
# ? 安裝 Node.js v22
# ? 安裝 ripgrep
# ? 安裝 ffmpeg
# ? 克隆 Hermes Agent 倉庫
# ? 創(chuàng)建虛擬環(huán)境
# ? 安裝所有 Python 依賴
# ? 設(shè)置全局 hermes 命令
# ? 安裝桌面應(yīng)用

# 步驟 2：重新加載 shell 配置
source ~/.bashrc    # 如果你使用 bash
# 或
source ~/.zshrc     # 如果你使用 zsh

# 步驟 3：驗(yàn)證安裝
hermes --version

# 步驟 4：啟動桌面版
hermes desktop

六、命令行方式安裝（CLI 模式）

如果你只需要命令行版本，或者想先裝 CLI 后再決定是否使用桌面版，可以使用以下方法。

6.1 Linux / macOS / WSL2 命令行安裝

打開終端，執(zhí)行以下一行命令：

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

安裝完成后：

# 重新加載 shell 配置
source ~/.bashrc    # bash 用戶
# 或
source ~/.zshrc     # zsh 用戶

# 啟動 Hermes
hermes

6.2 Windows PowerShell 原生命令行安裝

重要說明： Windows 原生版本完全支持 Hermes——CLI、網(wǎng)關(guān)、TUI 和工具都原生運(yùn)行。安裝程序會自動處理所有依賴項(xiàng)，包括一個便攜式 Git Bash（MinGit，約 45MB），無需管理員權(quán)限。

打開 PowerShell，執(zhí)行：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安裝器會自動處理：

• uv（快速 Python 包管理器）
• Python 3.11
• Node.js v22
• ripgrep
• ffmpeg
• 便攜式 Git Bash（MinGit，解壓到 %LOCALAPPDATA%\hermes\git）
• 倉庫克隆、虛擬環(huán)境、全局命令設(shè)置

安裝完成后，在新的 PowerShell 窗口中運(yùn)行：

hermes

WSL2 用戶： 如果你想在 WSL2 中使用，也可以使用 Linux 的安裝命令：

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

注意：只有基于瀏覽器的儀表板聊天面板需要 WSL2（它使用 POSIX PTY），經(jīng)典 CLI 和網(wǎng)關(guān)都在 Windows 上原生運(yùn)行。

七、首次配置與啟動

安裝完成后，需要進(jìn)行基本配置才能開始使用。

7.1 快速配置（推薦）

最快捷的方式——使用 Nous Portal 一鍵配置：

hermes setup --portal

這個命令會：

1. 通過 OAuth 登錄 Nous Portal
2. 設(shè)置 Nous 為默認(rèn)提供者
3. 開啟 Tool Gateway（網(wǎng)頁搜索、圖像生成、TTS、云瀏覽器）
4. 配置完成，立即可用！

7.2 手動配置模型

如果你想使用自己的 API Key 或其他模型提供商：

# 選擇 LLM 提供商和模型
hermes model

# 也可以手動設(shè)置特定的 API Key
hermes config set OPENAI_API_KEY sk-your-key-here
hermes config set ANTHROPIC_API_KEY sk-ant-your-key-here
hermes config set OPENROUTER_API_KEY sk-or-your-key-here

支持的提供商：

切換模型非常簡單，無需代碼更改：

hermes model    # 交互式選擇模型
# 或直接指定
# 在聊天中使用 /model <provider:model>

7.3 配置工具集

# 配置啟用哪些工具
hermes tools

# 運(yùn)行完整配置向?qū)Вㄒ淮涡耘渲盟袃?nèi)容）
hermes setup

八、Nous Portal 一站式配置

Nous Portal 是 Hermes 官方的訂閱服務(wù)，一個訂閱涵蓋所有功能：

• 300+ 模型 — 使用 /model <name> 隨時切換
• Tool Gateway（工具網(wǎng)關(guān)） — 網(wǎng)頁搜索（Firecrawl）、圖像生成（FAL）、語音合成（OpenAI）、云瀏覽器（Browser Use），全部通過一個訂閱路由

訂閱層級：

設(shè)置步驟：

# 方式一：安裝后直接使用 Portal 配置（最快）
hermes setup --portal

# 方式二：隨時查看 Portal 信息
hermes portal info

# 訪問 Portal 管理頁面
# https://portal.nousresearch.com/manage-subscription

你仍然可以為每個工具使用自己的 API Key——網(wǎng)關(guān)是按后端的，不是全有或全無的。

九、安裝后驗(yàn)證與常見操作

安裝完成后，請執(zhí)行以下驗(yàn)證步驟：

# 1. 驗(yàn)證 hermes 命令可用
hermes --version

# 2. 運(yùn)行診斷（會告訴你缺少什么以及如何修復(fù)）
hermes doctor

# 3. 檢查配置
hermes config check

# 4. 啟動對話
hermes

# 5. 啟動桌面版（如果安裝了桌面版）
hermes desktop

# 6. 啟動消息網(wǎng)關(guān)（用于 Telegram、Discord 等）
hermes gateway setup   # 首次配置
hermes gateway start   # 啟動網(wǎng)關(guān)

常用命令速查表：

十、安裝布局詳解

了解 Hermes 安裝了什么文件到哪里，管理和排錯很有幫助。

Windows 原生安裝

%LOCALAPPDATA%\hermes\              # 主數(shù)據(jù)目錄
├── hermes-agent\                   # 代碼倉庫
├── git\                            # 便攜式 Git Bash（MinGit）
├── config.yaml                     # 配置文件
├── sessions\                       # 會話數(shù)據(jù)
├── skills\                         # 技能文件
├── memory\                         # 記憶數(shù)據(jù)
└── ...

%LOCALAPPDATA%\hermes\hermes-agent\ # 或通過 PATH 可訪問
hermes                              # 全局命令（在 PowerShell/CMD 中可用）

Linux / macOS 安裝布局

從命令行啟動桌面版

如果你先安裝了命令行版本，后來想使用桌面版，無需重新下載安裝包：

hermes desktop

這個命令會自動下載并啟動 Hermes Desktop 桌面應(yīng)用。

常見問題排查（FAQ）

hermes: command not found

原因： Shell 還沒有加載新的 PATH 配置。

解決方案：

# 重新加載 shell 配置
source ~/.bashrc    # bash 用戶
source ~/.zshrc     # zsh 用戶

# Windows 用戶：關(guān)閉并重新打開 PowerShell

API Key 未設(shè)置

原因： 還沒有配置 LLM 提供商。

解決方案：

# 快速配置（推薦）
hermes setup --portal

# 或手動配置
hermes model
# 或
hermes config set OPENROUTER_API_KEY your_key_here

更新后配置丟失

原因： 配置格式可能發(fā)生了變化。

解決方案：

hermes config check     # 檢查當(dāng)前配置
hermes config migrate   # 遷移配置到新格式

Windows 安裝時被殺毒軟件攔截

解決方案：

1. 暫時關(guān)閉殺毒軟件的實(shí)時保護(hù)
2. 將 Hermes-Setup.exe 添加到排除列表
3. 重新運(yùn)行安裝程序

macOS 提示"應(yīng)用已損壞，無法打開"

解決方案：

# 方法一：移除隔離屬性
xattr -cr /Applications/Hermes.app

# 方法二：在系統(tǒng)設(shè)置中允許
# 系統(tǒng)設(shè)置 → 隱私與安全性 → 安全性 → 點(diǎn)擊"仍然允許"

想跳過瀏覽器自動化安裝

如果你運(yùn)行在無頭服務(wù)器上，不需要瀏覽器自動化功能：

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

如何獲取更多幫助

# 運(yùn)行內(nèi)置診斷工具
hermes doctor

# 查看幫助
hermes --help
hermes <command> --help

# 社區(qū)支持
# Discord: https://discord.gg/NousResearch
# GitHub Issues: https://github.com/NousResearch/hermes-agent/issues

進(jìn)階使用建議

1. 配置消息平臺

Hermes 支持通過消息平臺與你對話，配置步驟：

# 配置消息網(wǎng)關(guān)（交互式設(shè)置）
hermes gateway setup

# 選擇你要連接的平臺：
# - Telegram
# - Discord
# - Slack
# - WhatsApp
# - Signal
# - Email
# - 微信企業(yè)版 / 飛書 / QQ Bot
# - ...更多平臺

# 啟動網(wǎng)關(guān)
hermes gateway start

2. 創(chuàng)建技能（Skills）

Hermes 會自動在復(fù)雜任務(wù)后生成技能，你也可以手動創(chuàng)建：

# 技能存儲位置
~/.hermes/skills/    # Linux/macOS
%LOCALAPPDATA%\hermes\skills\    # Windows

# 瀏覽技能
hermes /skills

# 訪問技能中心
# https://agentskills.io

3. 配置定時任務(wù)

# 在 Hermes 對話中使用自然語言創(chuàng)建定時任務(wù)
# 例如："每天早上 8 點(diǎn)給我發(fā)送技術(shù)簡報到 Telegram"

4. 使用 SOUL.md 定制人格

# 創(chuàng)建全局 SOUL.md 文件來定義 Hermes 的默認(rèn)人格
# 位置：~/.hermes/SOUL.md

5. MCP 集成

# 連接外部 MCP 服務(wù)器以擴(kuò)展工具能力
# 詳見：https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp

6. 從 OpenClaw 遷移

如果你之前使用 OpenClaw：

# 交互式遷移
hermes claw migrate

# 預(yù)覽遷移內(nèi)容
hermes claw migrate --dry-run

# 僅遷移用戶數(shù)據(jù)（不包含密鑰）
hermes claw migrate --preset user-data

# 覆蓋已有沖突
hermes claw migrate --overwrite

部署整體步驟

Hermes Agent 桌面版的安裝部署非常簡單，核心流程可以概括為三步走：

第一步：下載安裝 → 第二步：hermes setup --portal → 第三步：開始對話！

實(shí)際安裝部署與網(wǎng)絡(luò)相關(guān)，網(wǎng)絡(luò)延遲情況下，需多次嘗試下載安裝。

Hermes Agent 是目前最強(qiáng)大的開源 AI 智能體之一，具有以下獨(dú)特優(yōu)勢：

• ? 完全開源 — MIT 協(xié)議，代碼透明可審計
• ? 自學(xué)習(xí)閉環(huán) — 越用越聰明，自動創(chuàng)建和改進(jìn)技能
• ? 全平臺覆蓋 — 20+ 消息平臺，一個網(wǎng)關(guān)搞定
• ? 模型自由切換 — 300+ 模型，無鎖定
• ? 企業(yè)級安全 — 命令審批、授權(quán)、容器隔離
• ? 靈活部署 — 本地、Docker、SSH、Serverless

以上就是Hermes Agent桌面版安裝部署完全指南(2026年最新)的詳細(xì)內(nèi)容，更多關(guān)于Hermes Agent桌面版安裝部署的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論