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

一、什么是 Hermes Agent？

Hermes Agent 是由 Nous Research 開(kāi)發(fā)的開(kāi)源自主 AI 智能體（MIT 協(xié)議）。它不是綁定在集成編輯器上的編碼助手，也不是圍繞單一 API 的聊天機(jī)器人封裝——它是一個(gè)越用越強(qiáng)大的自主智能體，擁有獨(dú)一無(wú)二的閉環(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)用程序，提供圖形化界面，讓你無(wú)需命令行即可使用完整的 Agent 功能：

?? #1 Connect — 全平臺(tái)連接

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

?? #2 Remember — 持久記憶

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

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

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

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

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

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

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

?? #6 Experiment — 隔離沙箱

五種后端——本地、Docker、SSH、Singularity、Modal——配合容器加固和命名空間隔離。

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

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

系統(tǒng)要求：

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

預(yù)先檢查：

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

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

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

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

系統(tǒng)要求：

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

預(yù)先檢查：

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

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

?? 提示： 如果 macOS 上沒(méi)有 Git，請(qǐng)先安裝 Xcode Command Line Tools：

xcode-select --install

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

系統(tǒng)要求：

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

預(yù)先檢查：

# 檢查 Git 是否已安裝
git --version
# 如果沒(méi)有 Git，安裝它（Ubuntu/Debian）
sudo apt update && sudo apt install -y git
# Fedora
sudo dnf install -y git
# Arch
sudo pacman -S git

四、下載 Hermes Desktop 桌面版

官方下載地址

訪(fǎng)問(wèn) Hermes Desktop 官方頁(yè)面獲取最新版安裝包：

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

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

五、安裝過(guò)程詳解

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

步驟 1：下載安裝程序

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

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

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

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

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

步驟 4：安裝完成

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

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

如遇報(bào)錯(cuò)，需下載安裝WebView2安裝包

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

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

1、直接生成啟動(dòng)批處理，放在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、先給文件夾放開(kāi)權(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)行，程序會(huì)自動(dòng)讀取當(dāng)前目錄的WebView2，不再報(bào)缺失。

5.2 macOS 安裝

步驟 1：下載安裝程序

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

步驟 2：打開(kāi) DMG 鏡像

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

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

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

步驟 4：首次啟動(dòng)

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

5.3 Linux 安裝

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

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

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

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

# 步驟 1：下載并運(yùn)行安裝腳本（包含桌面版）
curl -fsSL https://hermes-agent.nousresearch.com/install.sh --include-desktop | bash
# 安裝腳本會(huì)自動(dòng)執(zhí)行以下操作：
# ? 檢測(cè)并安裝 uv（Python 包管理器）
# ? 安裝 Python 3.11（通過(guò) uv）
# ? 安裝 Node.js v22
# ? 安裝 ripgrep
# ? 安裝 ffmpeg
# ? 克隆 Hermes Agent 倉(cāng)庫(kù)
# ? 創(chuàng)建虛擬環(huán)境
# ? 安裝所有 Python 依賴(lài)
# ? 設(shè)置全局 hermes 命令
# ? 安裝桌面應(yīng)用
# 步驟 2：重新加載 shell 配置
source ~/.bashrc    # 如果你使用 bash
# 或
source ~/.zshrc     # 如果你使用 zsh
# 步驟 3：驗(yàn)證安裝
hermes --version
# 步驟 4：?jiǎn)?dòng)桌面版
hermes desktop

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

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

6.1 Linux / macOS / WSL2 命令行安裝

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

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

安裝完成后：

# 重新加載 shell 配置
source ~/.bashrc    # bash 用戶(hù)
# 或
source ~/.zshrc     # zsh 用戶(hù)
# 啟動(dòng) Hermes
hermes

?? Android / Termux 用戶(hù)： Termux 上的安裝路徑經(jīng)過(guò)專(zhuān)門(mén)測(cè)試，請(qǐng)參考 Termux 安裝指南。

6.2 Windows PowerShell 原生命令行安裝

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

打開(kāi) PowerShell，執(zhí)行：

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

安裝器會(huì)自動(dòng)處理：

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

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

hermes

?? WSL2 用戶(hù)： 如果你想在 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)行。

七、首次配置與啟動(dòng)

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

7.1 快速配置（推薦）

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

hermes setup --portal

這個(gè)命令會(huì)：

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

7.2 手動(dòng)配置模型

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

# 選擇 LLM 提供商和模型
hermes model
# 也可以手動(dòng)設(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

支持的提供商：

切換模型非常簡(jiǎn)單，無(wú)需代碼更改：

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

7.3 配置工具集

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

八、Nous Portal 一站式配置

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

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

訂閱層級(jí)：

設(shè)置步驟：

# 方式一：安裝后直接使用 Portal 配置（最快）
hermes setup --portal
# 方式二：隨時(shí)查看 Portal 信息
hermes portal info
# 訪(fǎng)問(wèn) Portal 管理頁(yè)面
# https://portal.nousresearch.com/manage-subscription

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

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

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

# 1. 驗(yàn)證 hermes 命令可用
hermes --version
# 2. 運(yùn)行診斷（會(huì)告訴你缺少什么以及如何修復(fù)）
hermes doctor
# 3. 檢查配置
hermes config check
# 4. 啟動(dòng)對(duì)話(huà)
hermes
# 5. 啟動(dòng)桌面版（如果安裝了桌面版）
hermes desktop
# 6. 啟動(dòng)消息網(wǎng)關(guān)（用于 Telegram、Discord 等）
hermes gateway setup   # 首次配置
hermes gateway start   # 啟動(dòng)網(wǎng)關(guān)

常用命令速查表：

十、安裝布局詳解

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

Windows 原生安裝

%LOCALAPPDATA%\hermes\              # 主數(shù)據(jù)目錄
├── hermes-agent\                   # 代碼倉(cāng)庫(kù)
├── git\                            # 便攜式 Git Bash（MinGit）
├── config.yaml                     # 配置文件
├── sessions\                       # 會(huì)話(huà)數(shù)據(jù)
├── skills\                         # 技能文件
├── memory\                         # 記憶數(shù)據(jù)
└── ...
%LOCALAPPDATA%\hermes\hermes-agent\ # 或通過(guò) PATH 可訪(fǎng)問(wèn)
hermes                              # 全局命令（在 PowerShell/CMD 中可用）

Linux / macOS 安裝布局

從命令行啟動(dòng)桌面版

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

hermes desktop

這個(gè)命令會(huì)自動(dòng)下載并啟動(dòng) Hermes Desktop 桌面應(yīng)用。

常見(jiàn)問(wèn)題排查（FAQ）

?hermes: command not found

原因： Shell 還沒(méi)有加載新的 PATH 配置。

解決方案：

# 重新加載 shell 配置
source ~/.bashrc    # bash 用戶(hù)
source ~/.zshrc     # zsh 用戶(hù)
# Windows 用戶(hù)：關(guān)閉并重新打開(kāi) PowerShell

? API Key 未設(shè)置

原因： 還沒(méi)有配置 LLM 提供商。

解決方案：

# 快速配置（推薦）
hermes setup --portal
# 或手動(dòng)配置
hermes model
# 或
hermes config set OPENROUTER_API_KEY your_key_here

? 更新后配置丟失

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

解決方案：

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

? Windows 安裝時(shí)被殺毒軟件攔截

解決方案：

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

? macOS 提示"應(yīng)用已損壞，無(wú)法打開(kāi)"

解決方案：

# 方法一：移除隔離屬性
xattr -cr /Applications/Hermes.app
# 方法二：在系統(tǒng)設(shè)置中允許
# 系統(tǒng)設(shè)置 → 隱私與安全性 → 安全性 → 點(diǎn)擊"仍然允許"

? 安裝速度很慢

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

解決方案：

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

? 想跳過(guò)瀏覽器自動(dòng)化安裝

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

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. 配置消息平臺(tái)

Hermes 支持通過(guò)消息平臺(tái)與你對(duì)話(huà)，配置步驟：

# 配置消息網(wǎng)關(guān)（交互式設(shè)置）
hermes gateway setup
# 選擇你要連接的平臺(tái)：
# - Telegram
# - Discord
# - Slack
# - WhatsApp
# - Signal
# - Email
# - 微信企業(yè)版 / 飛書(shū) / QQ Bot
# - ...更多平臺(tái)
# 啟動(dòng)網(wǎng)關(guān)
hermes gateway start

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

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

# 技能存儲(chǔ)位置
~/.hermes/skills/    # Linux/macOS
%LOCALAPPDATA%\hermes\skills\    # Windows
# 瀏覽技能
hermes /skills
# 訪(fǎng)問(wèn)技能中心
# https://agentskills.io

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

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

4. 使用 SOUL.md 定制人格

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

5. MCP 集成

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

6. 從 OpenClaw 遷移

如果你之前使用 OpenClaw：

# 交互式遷移
hermes claw migrate
# 預(yù)覽遷移內(nèi)容
hermes claw migrate --dry-run
# 僅遷移用戶(hù)數(shù)據(jù)（不包含密鑰）
hermes claw migrate --preset user-data
# 覆蓋已有沖突
hermes claw migrate --overwrite

部署整體步驟

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

第一步：下載安裝 → 第二步：hermes setup --portal → 第三步：開(kāi)始對(duì)話(huà)！

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

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

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

參考鏈接

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

最新評(píng)論