Hermes Agent 桌面版安裝部署完全指南：一步步安裝自進(jìn)化Agent智能體

一、什么是 Hermes Agent？

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

官方資源：

• ?? 官網(wǎng)：https://hermes-agent.nousresearch.com/desktop
• ?? 文檔：https://hermes-agent.nousresearch.com/docs/
• ?? GitHub：https://github.com/NousResearch/hermes-agent
• ?? Discord：https://discord.gg/NousResearch
• ?? Portal：https://portal.nousresearch.com

二、Hermes Desktop 桌面版核心功能

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

?? #1 Connect — 全平臺連接

Telegram、Discord、Slack、WhatsApp、Signal、郵件、CLI——以及持續(xù)增加的平臺。一個智能體，一份記憶，覆蓋所有渠道。

?? #2 Remember — 持久記憶

它會學(xué)習(xí)你的項(xiàng)目、自動生成技能，并且永遠(yuǎn)不會忘記它解決過的問題。

? #3 Schedule — 自動化調(diào)度

用自然語言設(shè)置定時任務(wù)——報告、備份、簡報——通過網(wǎng)關(guān)無人值守運(yùn)行。

?? #4 Delegate — 任務(wù)委托

生成擁有獨(dú)立對話、終端和 Python RPC 腳本的隔離子智能體，實(shí)現(xiàn)零上下文成本的流水線。

?? #5 Search — 瀏覽網(wǎng)頁

網(wǎng)頁搜索、瀏覽器自動化、視覺理解、圖像生成、語音合成、多模型推理。

?? #6 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ū)?/h5>

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 提供者配置。安裝完成后即可直接使用。

如遇報錯，需下載安裝WebView2安裝包

webview2下載
https://developer.microsoft.com/en-us/microsoft-edge/webview2?form=MA13LH#download

hermes下載
https://hermes-agent.nousresearch.com/desktop#downloads

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

?? Android / Termux 用戶： Termux 上的安裝路徑經(jīng)過專門測試，請參考 Termux 安裝指南。

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)擊"仍然允許"

? 安裝速度很慢

原因： 需要下載多個依賴項(xiàng)。

解決方案：

• 確保網(wǎng)絡(luò)連接穩(wěn)定
• 如果在國內(nèi)，可能需要配置代理
• 耐心等待，首次安裝需要下載 Python、Node.js 等依賴

? 想跳過瀏覽器自動化安裝

如果你運(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

參考鏈接

到此這篇關(guān)于Hermes Agent 桌面版安裝部署完全指南：一步步安裝自進(jìn)化Agent智能體的文章就介紹到這了,更多相關(guān)Hermes Agent 安裝部署內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論