Hermes Agent 桌面版安装部署完全指南：一步步安装自进化Agent智能体

一、什么是 Hermes Agent？

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

官方资源：

• ???? 官网：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 的原生桌面应用程序，提供图形化界面，让你无需命令行即可使用完整的 Agent 功能：

???? #1 Connect — 全平台连接

Telegram、Discord、Slack、WhatsApp、Signal、邮件、CLI——以及持续增加的平台。一个智能体，一份记忆，覆盖所有渠道。

???? #2 Remember — 持久记忆

它会学习你的项目、自动生成技能，并且永远不会忘记它解决过的问题。

? #3 Schedule — 自动化调度

用自然语言设置定时任务——报告、备份、简报——通过网关无人值守运行。

???? #4 Delegate — 任务委托

生成拥有独立对话、终端和 Python RPC 脚本的隔离子智能体，实现零上下文成本的流水线。

???? #5 Search — 浏览网页

网页搜索、浏览器自动化、视觉理解、图像生成、语音合成、多模型推理。

???? #6 Experiment — 隔离沙箱

五种后端——本地、Docker、SSH、Singularity、Modal——配合容器加固和命名空间隔离。

三、安装前准备

3.1 Windows 系统准备

系统要求：

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

预先检查：

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

???? 提示： 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 上没有 Git，请先安装 Xcode Command Line Tools：

3.3 Linux 系统准备

系统要求：

• 任意 Linux 发行版（Ubuntu、Debian、Fedora、Arch、openSUSE 等）
• 至少 2GB 可用磁盘空间
• 稳定的网络连接
• 唯一前置要求： 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 提供者配置。安装完成后即可直接使用。

如遇报错，需下载安装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，内容：

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

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 系统通过终端命令安装桌面版：

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

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

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

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

6.1 Linux / macOS / WSL2 命令行安装

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

安装完成后：

6.2 Windows PowerShell 原生命令行安装

重要说明： Windows 原生版本完全支持 Hermes——CLI、网关、TUI 和工具都原生运行。安装程序会自动处理所有依赖项，包括一个便携式 Git Bash（MinGit，约 45MB），无需管理员权限。

打开 PowerShell，执行：

安装器会自动处理：

• ? uv（快速 Python 包管理器）
• ? Python 3.11
• ? Node.js v22
• ? ripgrep
• ? ffmpeg
• ? 便携式 Git Bash（MinGit，解压到 %LOCALAPPDATA%\hermes\git）
• ? 仓库克隆、虚拟环境、全局命令设置

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

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

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

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

七、首次配置与启动

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

7.1 快速配置（推荐）

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

这个命令会：

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

7.2 手动配置模型

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

支持的提供商：

切换模型非常简单，无需代码更改：

7.3 配置工具集

八、Nous Portal 一站式配置

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

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

订阅层级：

设置步骤：

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

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

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

常用命令速查表：

十、安装布局详解

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

Windows 原生安装

Linux / macOS 安装布局

从命令行启动桌面版

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

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

常见问题排查（FAQ）

?hermes: command not found

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

解决方案：

? API Key 未设置

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

解决方案：

? 更新后配置丢失

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

解决方案：

? Windows 安装时被杀毒软件拦截

解决方案：

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

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

解决方案：

? 安装速度很慢

原因： 需要下载多个依赖项。

解决方案：

• 确保网络连接稳定
• 如果在国内，可能需要配置代理
• 耐心等待，首次安装需要下载 Python、Node.js 等依赖

? 想跳过浏览器自动化安装

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

? 如何获取更多帮助

进阶使用建议

1. 配置消息平台

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

2. 创建技能（Skills）

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

3. 配置定时任务

4. 使用 SOUL.md 定制人格

5. MCP 集成

6. 从 OpenClaw 迁移

如果你之前使用 OpenClaw：

部署整体步骤

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

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

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

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

参考链接