Hermes Agent桌面版安装部署完全指南(2026年最新)

一、什么是 Hermes Agent？

Hermes Agent 是由 Nous Research 开发的开源自主 AI 智能体（MIT 协议）。它不是绑定在集成编辑器上的编码助手，也不是围绕单一 API 的聊天机器人封装——它是一个越用越强大的自主智能体，拥有独一无二的闭环学习系统：

二、Hermes Desktop 桌面版核心功能

Hermes Desktop 是 Hermes Agent 的原生桌面应用程序，提供图形化界面，让你无需命令行即可使用完整的 Agent 功能：

• Connect — 全平台连接:Telegram、Discord、Slack、WhatsApp、Signal、邮件、CLI——以及持续增加的平台。一个智能体，一份记忆，覆盖所有渠道。
• Remember — 持久记忆:它会学习你的项目、自动生成技能，并且永远不会忘记它解决过的问题。
• Schedule — 自动化调度:用自然语言设置定时任务——报告、备份、简报——通过网关无人值守运行。
• Delegate — 任务委托:生成拥有独立对话、终端和 Python RPC 脚本的隔离子智能体，实现零上下文成本的流水线。
• Search — 浏览网页:网页搜索、浏览器自动化、视觉理解、图像生成、语音合成、多模型推理。
• Experiment — 隔离沙箱:五种后端——本地、Docker、SSH、Singularity、Modal——配合容器加固和命名空间隔离。

三、安装前准备

3.1 Windows 系统准备

系统要求：

• Windows 10 或 Windows 11
• 至少 2GB 可用磁盘空间
• 稳定的网络连接

预先检查：

打开 PowerShell（推荐使用管理员权限），确认系统版本：

# 检查 Windows 版本
[System.Environment]::OSVersion.Version
# 检查是否有 Git（可选，安装器会自动处理）
git --version

提示： Hermes 的 Windows 安装器非常智能——它会自动处理所有依赖项（Python 3.11、Node.js v22、ripgrep、ffmpeg），甚至包含一个便携式 Git Bash（MinGit，约 45MB），无需管理员权限，完全独立于系统已安装的 Git。如果你已经安装了 Git，安装器会检测到并使用它。

3.2 macOS 系统准备

系统要求：

• macOS 12（Monterey）或更高版本
• 至少 2GB 可用磁盘空间
• 稳定的网络连接

预先检查：

打开终端（Terminal），确认系统版本和 Git：

# 检查 macOS 版本
sw_vers

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

提示： 如果 macOS 上没有 Git，请先安装 Xcode Command Line Tools：

xcode-select --install

3.3 Linux 系统准备

系统要求：

• 任意 Linux 发行版（Ubuntu、Debian、Fedora、Arch、openSUSE 等）
• 至少 2GB 可用磁盘空间
• 稳定的网络连接
• 唯一前置要求： Git

预先检查：

# 检查 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

注意： 请只从官方渠道下载。不要从第三方网站下载安装包，以确保安全。

五、安装过程详解

5.1 Windows 安装（详细图文步骤）

步骤 1：下载安装程序

1. 打开浏览器，访问 https://hermes-agent.nousresearch.com/desktop
2. 点击 “Windows Download” 按钮下载 Hermes-Setup.exe
3. 文件大小约 100-200MB，请耐心等待下载完成

步骤 2：运行安装程序

1. 双击下载的 Hermes-Setup.exe
2. 如果 Windows 弹出"Windows 已保护你的电脑"的提示：
   • 点击 “更多信息”
   • 然后点击 “仍要运行”
3. 如果出现用户账户控制（UAC）提示，点击 “是”

步骤 3：跟随安装向导

1. 选择安装路径（默认路径即可，推荐保持默认）
2. 等待安装器自动下载和配置所有依赖项：
   • uv（快速 Python 包管理器）
   • Python 3.11（通过 uv 安装，无需 sudo）
   • Node.js v22（用于浏览器自动化和 WhatsApp 网桥）
   • ripgrep（快速文件搜索）
   • ffmpeg（音频格式转换，用于 TTS）
   • MinGit（便携式 Git Bash，约 45MB）
3. 等待仓库克隆和虚拟环境创建完成

步骤 4：安装完成

1. 安装完成后，桌面会出现 Hermes Agent 图标
2. 开始菜单中也会出现 Hermes Agent 快捷方式
3. 命令行中 hermes 命令已全局可用

安装器会自动处理一切： 依赖项安装、仓库克隆、虚拟环境创建、全局 hermes 命令设置和 LLM 提供者配置。安装完成后即可直接使用。

1、直接生成启动批处理，放在Downloads目录

在 C:\Users\Administrator\Downloads 新建 RunHermes.bat，内容：

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

2、先给文件夹放开权限（管理员CMD逐条运行）

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→以管理员身份运行，程序会自动读取当前目录的WebView2，不再报缺失。

5.2 macOS 安装

步骤 1：下载安装程序

1. 打开浏览器，访问 https://hermes-agent.nousresearch.com/desktop
2. 点击 “Mac OS Download” 按钮下载 Hermes-Setup.dmg

步骤 2：打开 DMG 镜像

1. 双击下载的 Hermes-Setup.dmg
2. 如果 macOS 提示"无法验证开发者"：
   • 打开 系统设置 → 隐私与安全性
   • 找到被阻止的 Hermes 应用，点击 “仍然允许”
   • 或者在 DMG 窗口中右键点击 Hermes 应用，选择 “打开”

步骤 3：安装应用

1. 将 Hermes 图标拖拽到 Applications 文件夹
2. 打开 Applications 文件夹，双击 Hermes 启动

步骤 4：首次启动

1. 首次启动时，Hermes 会自动配置所需的依赖项
2. 等待初始化完成后即可使用

5.3 Linux 安装

Linux 系统通过终端命令安装桌面版：

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

--include-desktop 参数会同时安装命令行工具和桌面应用程序。

详细的终端安装过程如下：

# 步骤 1：下载并运行安装脚本（包含桌面版）
curl -fsSL https://hermes-agent.nousresearch.com/install.sh --include-desktop | bash

# 安装脚本会自动执行以下操作：
# ✓ 检测并安装 uv（Python 包管理器）
# ✓ 安装 Python 3.11（通过 uv）
# ✓ 安装 Node.js v22
# ✓ 安装 ripgrep
# ✓ 安装 ffmpeg
# ✓ 克隆 Hermes Agent 仓库
# ✓ 创建虚拟环境
# ✓ 安装所有 Python 依赖
# ✓ 设置全局 hermes 命令
# ✓ 安装桌面应用

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

# 步骤 3：验证安装
hermes --version

# 步骤 4：启动桌面版
hermes desktop

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

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

6.1 Linux / macOS / WSL2 命令行安装

打开终端，执行以下一行命令：

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、网关、TUI 和工具都原生运行。安装程序会自动处理所有依赖项，包括一个便携式 Git Bash（MinGit，约 45MB），无需管理员权限。

打开 PowerShell，执行：

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）
• 仓库克隆、虚拟环境、全局命令设置

安装完成后，在新的 PowerShell 窗口中运行：

hermes

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

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

注意：只有基于浏览器的仪表板聊天面板需要 WSL2（它使用 POSIX PTY），经典 CLI 和网关都在 Windows 上原生运行。

七、首次配置与启动

安装完成后，需要进行基本配置才能开始使用。

7.1 快速配置（推荐）

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

hermes setup --portal

这个命令会：

1. 通过 OAuth 登录 Nous Portal
2. 设置 Nous 为默认提供者
3. 开启 Tool Gateway（网页搜索、图像生成、TTS、云浏览器）
4. 配置完成，立即可用！

7.2 手动配置模型

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

# 选择 LLM 提供商和模型
hermes model

# 也可以手动设置特定的 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

# 运行完整配置向导（一次性配置所有内容）
hermes setup

八、Nous Portal 一站式配置

Nous Portal 是 Hermes 官方的订阅服务，一个订阅涵盖所有功能：

• 300+ 模型 — 使用 /model <name> 随时切换
• Tool Gateway（工具网关） — 网页搜索（Firecrawl）、图像生成（FAL）、语音合成（OpenAI）、云浏览器（Browser Use），全部通过一个订阅路由

订阅层级：

设置步骤：

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

# 方式二：随时查看 Portal 信息
hermes portal info

# 访问 Portal 管理页面
# https://portal.nousresearch.com/manage-subscription

你仍然可以为每个工具使用自己的 API Key——网关是按后端的，不是全有或全无的。

九、安装后验证与常见操作

安装完成后，请执行以下验证步骤：

# 1. 验证 hermes 命令可用
hermes --version

# 2. 运行诊断（会告诉你缺少什么以及如何修复）
hermes doctor

# 3. 检查配置
hermes config check

# 4. 启动对话
hermes

# 5. 启动桌面版（如果安装了桌面版）
hermes desktop

# 6. 启动消息网关（用于 Telegram、Discord 等）
hermes gateway setup   # 首次配置
hermes gateway start   # 启动网关

常用命令速查表：

十、安装布局详解

了解 Hermes 安装了什么文件到哪里，管理和排错很有帮助。

Windows 原生安装

%LOCALAPPDATA%\hermes\              # 主数据目录
├── hermes-agent\                   # 代码仓库
├── git\                            # 便携式 Git Bash（MinGit）
├── config.yaml                     # 配置文件
├── sessions\                       # 会话数据
├── skills\                         # 技能文件
├── memory\                         # 记忆数据
└── ...

%LOCALAPPDATA%\hermes\hermes-agent\ # 或通过 PATH 可访问
hermes                              # 全局命令（在 PowerShell/CMD 中可用）

Linux / macOS 安装布局

从命令行启动桌面版

如果你先安装了命令行版本，后来想使用桌面版，无需重新下载安装包：

hermes desktop

这个命令会自动下载并启动 Hermes Desktop 桌面应用。

常见问题排查（FAQ）

hermes: command not found

原因： Shell 还没有加载新的 PATH 配置。

解决方案：

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

# Windows 用户：关闭并重新打开 PowerShell

API Key 未设置

原因： 还没有配置 LLM 提供商。

解决方案：

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

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

更新后配置丢失

原因： 配置格式可能发生了变化。

解决方案：

hermes config check     # 检查当前配置
hermes config migrate   # 迁移配置到新格式

Windows 安装时被杀毒软件拦截

解决方案：

1. 暂时关闭杀毒软件的实时保护
2. 将 Hermes-Setup.exe 添加到排除列表
3. 重新运行安装程序

macOS 提示"应用已损坏，无法打开"

解决方案：

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

# 方法二：在系统设置中允许
# 系统设置 → 隐私与安全性 → 安全性 → 点击"仍然允许"

想跳过浏览器自动化安装

如果你运行在无头服务器上，不需要浏览器自动化功能：

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

如何获取更多帮助

# 运行内置诊断工具
hermes doctor

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

# 社区支持
# Discord: https://discord.gg/NousResearch
# GitHub Issues: https://github.com/NousResearch/hermes-agent/issues

进阶使用建议

1. 配置消息平台

Hermes 支持通过消息平台与你对话，配置步骤：

# 配置消息网关（交互式设置）
hermes gateway setup

# 选择你要连接的平台：
# - Telegram
# - Discord
# - Slack
# - WhatsApp
# - Signal
# - Email
# - 微信企业版 / 飞书 / QQ Bot
# - ...更多平台

# 启动网关
hermes gateway start

2. 创建技能（Skills）

Hermes 会自动在复杂任务后生成技能，你也可以手动创建：

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

# 浏览技能
hermes /skills

# 访问技能中心
# https://agentskills.io

3. 配置定时任务

# 在 Hermes 对话中使用自然语言创建定时任务
# 例如："每天早上 8 点给我发送技术简报到 Telegram"

4. 使用 SOUL.md 定制人格

# 创建全局 SOUL.md 文件来定义 Hermes 的默认人格
# 位置：~/.hermes/SOUL.md

5. MCP 集成

# 连接外部 MCP 服务器以扩展工具能力
# 详见：https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp

6. 从 OpenClaw 迁移

如果你之前使用 OpenClaw：

# 交互式迁移
hermes claw migrate

# 预览迁移内容
hermes claw migrate --dry-run

# 仅迁移用户数据（不包含密钥）
hermes claw migrate --preset user-data

# 覆盖已有冲突
hermes claw migrate --overwrite

部署整体步骤

Hermes Agent 桌面版的安装部署非常简单，核心流程可以概括为三步走：

第一步：下载安装 → 第二步：hermes setup --portal → 第三步：开始对话！

实际安装部署与网络相关，网络延迟情况下，需多次尝试下载安装。

Hermes Agent 是目前最强大的开源 AI 智能体之一，具有以下独特优势：

• ✅ 完全开源 — MIT 协议，代码透明可审计
• ✅ 自学习闭环 — 越用越聪明，自动创建和改进技能
• ✅ 全平台覆盖 — 20+ 消息平台，一个网关搞定
• ✅ 模型自由切换 — 300+ 模型，无锁定
• ✅ 企业级安全 — 命令审批、授权、容器隔离
• ✅ 灵活部署 — 本地、Docker、SSH、Serverless

以上就是Hermes Agent桌面版安装部署完全指南(2026年最新)的详细内容，更多关于Hermes Agent桌面版安装部署的资料请关注脚本之家其它相关文章！

最新评论