Hermes Agent 桌面版安装部署完全指南一步步安装自进化Agent智能体作者Gavin大咖助教团队日期2026年6月5日版本Hermes Agent v0.15.2适用系统Windows 、macOS 、Linux任意发行版目录一、什么是 Hermes Agent二、Hermes Desktop 桌面版核心功能三、安装前准备3.1 Windows 系统准备3.2 macOS 系统准备3.3 Linux 系统准备四、下载 Hermes Desktop 桌面版五、安装过程详解5.1 Windows 安装详细图文步骤5.2 macOS 安装5.3 Linux 安装六、命令行方式安装CLI 模式6.1 Linux / macOS / WSL2 命令行安装6.2 Windows PowerShell 原生命令行安装七、首次配置与启动7.1 快速配置推荐7.2 手动配置模型7.3 配置工具集八、Nous Portal 一站式配置九、安装后验证与常见操作十、安装布局详解从命令行启动桌面版常见问题排查FAQ进阶使用建议一、什么是 Hermes AgentHermes Agent是由Nous Research开发的开源自主 AI 智能体MIT 协议。它不是绑定在集成编辑器上的编码助手也不是围绕单一 API 的聊天机器人封装——它是一个越用越强大的自主智能体拥有独一无二的闭环学习系统特性说明自主技能创建在复杂任务后自动生成可复用的 Skills技能技能自我改进使用过程中持续优化已有技能持久化记忆跨会话记住你的项目、偏好和解决方案用户画像建模通过 Honcho 方言式推理逐步构建对你的深度理解20 平台接入Telegram、Discord、Slack、WhatsApp、Signal、邮件、微信企业版、飞书、QQ Bot 等一个网关全覆盖6 种终端后端本地、Docker、SSH、Daytona、Singularity、Modal300 模型支持Nous Portal、OpenRouter、OpenAI、Anthropic、Google任你选择官方资源 官网https://hermes-agent.nousresearch.com/desktop 文档https://hermes-agent.nousresearch.com/docs/ GitHubhttps://github.com/NousResearch/hermes-agent Discordhttps://discord.gg/NousResearch Portalhttps://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推荐使用管理员权限确认系统版本# 检查 Windows 版本[System.Environment]::OSVersion.Version# 检查是否有 Git可选安装器会自动处理git--version提示Hermes 的 Windows 安装器非常智能——它会自动处理所有依赖项Python 3.11、Node.js v22、ripgrep、ffmpeg甚至包含一个便携式 Git BashMinGit约 45MB无需管理员权限完全独立于系统已安装的 Git。如果你已经安装了 Git安装器会检测到并使用它。3.2 macOS 系统准备系统要求macOS 12Monterey或更高版本至少 2GB 可用磁盘空间稳定的网络连接预先检查打开终端Terminal确认系统版本和 Git# 检查 macOS 版本sw_vers# 检查 Git安装 Hermes 的唯一前置要求git--version提示如果 macOS 上没有 Git请先安装 Xcode Command Line Toolsxcode-select--install3.3 Linux 系统准备系统要求任意 Linux 发行版Ubuntu、Debian、Fedora、Arch、openSUSE 等至少 2GB 可用磁盘空间稳定的网络连接唯一前置要求Git预先检查# 检查 Git 是否已安装git--version# 如果没有 Git安装它Ubuntu/Debiansudoaptupdatesudoaptinstall-ygit# Fedorasudodnfinstall-ygit# Archsudopacman-Sgit四、下载 Hermes Desktop 桌面版官方下载地址访问 Hermes Desktop 官方页面获取最新版安装包https://hermes-agent.nousresearch.com/desktop平台下载链接文件Windows 10/11下载 Windows 版Hermes-Setup.exemacOS 12下载 macOS 版Hermes-Setup.dmgLinux终端安装见下方通过脚本安装⚠️注意请只从官方渠道下载。不要从第三方网站下载安装包以确保安全。五、安装过程详解5.1 Windows 安装详细图文步骤步骤 1下载安装程序打开浏览器访问 https://hermes-agent.nousresearch.com/desktop点击“Windows Download”按钮下载Hermes-Setup.exe文件大小约 100-200MB请耐心等待下载完成步骤 2运行安装程序双击下载的Hermes-Setup.exe如果 Windows 弹出Windows 已保护你的电脑的提示点击“更多信息”然后点击“仍要运行”如果出现用户账户控制UAC提示点击“是”步骤 3跟随安装向导选择安装路径默认路径即可推荐保持默认等待安装器自动下载和配置所有依赖项uv快速 Python 包管理器Python 3.11通过 uv 安装无需 sudoNode.js v22用于浏览器自动化和 WhatsApp 网桥ripgrep快速文件搜索ffmpeg音频格式转换用于 TTSMinGit便携式 Git Bash约 45MB等待仓库克隆和虚拟环境创建完成步骤 4安装完成安装完成后桌面会出现 Hermes Agent 图标开始菜单中也会出现 Hermes Agent 快捷方式命令行中hermes命令已全局可用安装器会自动处理一切依赖项安装、仓库克隆、虚拟环境创建、全局hermes命令设置和 LLM 提供者配置。安装完成后即可直接使用。如遇报错需下载安装WebView2安装包webview2下载https://developer.microsoft.com/en-us/microsoft-edge/webview2?formMA13LH#downloadhermes下载https://hermes-agent.nousresearch.com/desktop#downloads1、直接生成启动批处理放在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.exe2、先给文件夹放开权限管理员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下载安装程序打开浏览器访问 https://hermes-agent.nousresearch.com/desktop点击“Mac OS Download”按钮下载Hermes-Setup.dmg步骤 2打开 DMG 镜像双击下载的Hermes-Setup.dmg如果 macOS 提示无法验证开发者打开系统设置 → 隐私与安全性找到被阻止的 Hermes 应用点击“仍然允许”或者在 DMG 窗口中右键点击 Hermes 应用选择“打开”步骤 3安装应用将 Hermes 图标拖拽到 Applications 文件夹打开 Applications 文件夹双击 Hermes 启动步骤 4首次启动首次启动时Hermes 会自动配置所需的依赖项等待初始化完成后即可使用5.3 Linux 安装Linux 系统通过终端命令安装桌面版curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh --include-desktop|bash--include-desktop参数会同时安装命令行工具和桌面应用程序。详细的终端安装过程如下# 步骤 1下载并运行安装脚本包含桌面版curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh --include-desktop|bash# 安装脚本会自动执行以下操作# ✓ 检测并安装 uvPython 包管理器# ✓ 安装 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-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bash安装完成后# 重新加载 shell 配置source~/.bashrc# bash 用户# 或source~/.zshrc# zsh 用户# 启动 HermeshermesAndroid / Termux 用户Termux 上的安装路径经过专门测试请参考 Termux 安装指南。6.2 Windows PowerShell 原生命令行安装重要说明Windows 原生版本完全支持 Hermes——CLI、网关、TUI 和工具都原生运行。安装程序会自动处理所有依赖项包括一个便携式 Git BashMinGit约 45MB无需管理员权限。打开PowerShell执行iex(irmhttps://hermes-agent.nousresearch.com/install.ps1)安装器会自动处理✅ uv快速 Python 包管理器✅ Python 3.11✅ Node.js v22✅ ripgrep✅ ffmpeg✅便携式 Git BashMinGit解压到%LOCALAPPDATA%\hermes\git✅ 仓库克隆、虚拟环境、全局命令设置安装完成后在新的 PowerShell 窗口中运行hermesWSL2 用户如果你想在 WSL2 中使用也可以使用 Linux 的安装命令curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bash注意只有基于浏览器的仪表板聊天面板需要 WSL2它使用 POSIX PTY经典 CLI 和网关都在 Windows 上原生运行。七、首次配置与启动安装完成后需要进行基本配置才能开始使用。7.1 快速配置推荐最快捷的方式——使用 Nous Portal 一键配置hermes setup--portal这个命令会通过 OAuth 登录 Nous Portal设置 Nous 为默认提供者开启 Tool Gateway网页搜索、图像生成、TTS、云浏览器配置完成立即可用7.2 手动配置模型如果你想使用自己的 API Key 或其他模型提供商# 选择 LLM 提供商和模型hermes model# 也可以手动设置特定的 API Keyhermes configsetOPENAI_API_KEY sk-your-key-here hermes configsetANTHROPIC_API_KEY sk-ant-your-key-here hermes configsetOPENROUTER_API_KEY sk-or-your-key-here支持的提供商提供商说明Nous Portal300 模型内置 Tool GatewayOpenRouter200 模型OpenAIGPT-4o、GPT-4 等AnthropicClaude 系列GoogleGemini 系列NovitaAIAI 原生云NVIDIA NIMNemotronz.ai / GLM智谱Kimi / Moonshot月之暗面MiniMaxMiniMax自建端点任何 OpenAI 兼容的 API切换模型非常简单无需代码更改hermes model# 交互式选择模型# 或直接指定# 在聊天中使用 /model provider:model7.3 配置工具集# 配置启用哪些工具hermes tools# 运行完整配置向导一次性配置所有内容hermes setup八、Nous Portal 一站式配置Nous Portal是 Hermes 官方的订阅服务一个订阅涵盖所有功能300 模型— 使用/model name随时切换Tool Gateway工具网关— 网页搜索Firecrawl、图像生成FAL、语音合成OpenAI、云浏览器Browser Use全部通过一个订阅路由订阅层级层级说明Free免费使用基础功能Plus包含每月额度Super更多额度和高级功能Ultra最高级别完整功能设置步骤# 方式一安装后直接使用 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启动桌面版hermes desktop选择模型hermes model配置工具hermes tools设置配置项hermes config set KEY VALUE完整配置向导hermes setup配置消息平台hermes gateway setup启动消息网关hermes gateway start更新到最新版hermes update诊断问题hermes doctor检查配置hermes config check配置迁移hermes config migrate十、安装布局详解了解 Hermes 安装了什么文件到哪里管理和排错很有帮助。Windows 原生安装%LOCALAPPDATA%\hermes\ # 主数据目录 ├── hermes-agent\ # 代码仓库 ├── git\ # 便携式 Git BashMinGit ├── config.yaml # 配置文件 ├── sessions\ # 会话数据 ├── skills\ # 技能文件 ├── memory\ # 记忆数据 └── ... %LOCALAPPDATA%\hermes\hermes-agent\ # 或通过 PATH 可访问 hermes # 全局命令在 PowerShell/CMD 中可用Linux / macOS 安装布局组件普通用户安装Root 模式安装代码位置~/.hermes/hermes-agent//usr/local/lib/hermes-agent/hermes 命令~/.local/bin/hermes符号链接/usr/local/bin/hermes数据目录~/.hermes//root/.hermes/或$HERMES_HOME从命令行启动桌面版如果你先安装了命令行版本后来想使用桌面版无需重新下载安装包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 configsetOPENROUTER_API_KEY your_key_here❓ 更新后配置丢失原因配置格式可能发生了变化。解决方案hermes config check# 检查当前配置hermes config migrate# 迁移配置到新格式❓ Windows 安装时被杀毒软件拦截解决方案暂时关闭杀毒软件的实时保护将Hermes-Setup.exe添加到排除列表重新运行安装程序❓ macOS 提示应用已损坏无法打开解决方案# 方法一移除隔离属性xattr-cr/Applications/Hermes.app# 方法二在系统设置中允许# 系统设置 → 隐私与安全性 → 安全性 → 点击仍然允许❓ 安装速度很慢原因需要下载多个依赖项。解决方案确保网络连接稳定如果在国内可能需要配置代理耐心等待首次安装需要下载 Python、Node.js 等依赖❓ 想跳过浏览器自动化安装如果你运行在无头服务器上不需要浏览器自动化功能curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bash-s-- --skip-browser❓ 如何获取更多帮助# 运行内置诊断工具hermes doctor# 查看帮助hermes--helphermescommand--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 start2. 创建技能SkillsHermes 会自动在复杂任务后生成技能你也可以手动创建# 技能存储位置 ~/.hermes/skills/ # Linux/macOS %LOCALAPPDATA%\hermes\skills\ # Windows # 浏览技能 hermes /skills # 访问技能中心 # https://agentskills.io3. 配置定时任务# 在 Hermes 对话中使用自然语言创建定时任务# 例如每天早上 8 点给我发送技术简报到 Telegram4. 使用 SOUL.md 定制人格# 创建全局 SOUL.md 文件来定义 Hermes 的默认人格# 位置~/.hermes/SOUL.md5. MCP 集成# 连接外部 MCP 服务器以扩展工具能力# 详见https://hermes-agent.nousresearch.com/docs/user-guide/features/mcp6. 从 OpenClaw 迁移如果你之前使用 OpenClaw# 交互式迁移hermes claw migrate# 预览迁移内容hermes claw migrate --dry-run# 仅迁移用户数据不包含密钥hermes claw migrate--presetuser-data# 覆盖已有冲突hermes claw migrate--overwrite部署整体步骤Hermes Agent 桌面版的安装部署非常简单核心流程可以概括为三步走第一步下载安装 → 第二步hermes setup --portal → 第三步开始对话步骤操作耗时下载安装下载桌面安装包并运行3-5 分钟⚙️配置hermes setup --portal1-2 分钟开始使用hermes或打开桌面版立即实际安装部署与网络相关网络延迟情况下需多次尝试下载安装。Hermes Agent 是目前最强大的开源 AI 智能体之一具有以下独特优势✅完全开源— MIT 协议代码透明可审计✅自学习闭环— 越用越聪明自动创建和改进技能✅全平台覆盖— 20 消息平台一个网关搞定✅模型自由切换— 300 模型无锁定✅企业级安全— 命令审批、授权、容器隔离✅灵活部署— 本地、Docker、SSH、Serverless参考链接资源链接 Hermes Desktop 官网https://hermes-agent.nousresearch.com/desktop 完整文档https://hermes-agent.nousresearch.com/docs/ 安装指南https://hermes-agent.nousresearch.com/docs/getting-started/installation 快速入门https://hermes-agent.nousresearch.com/docs/getting-started/quickstart GitHub 仓库https://github.com/NousResearch/hermes-agent Nous Portalhttps://portal.nousresearch.com Discord 社区https://discord.gg/NousResearch Skills Hubhttps://agentskills.io 问题反馈https://github.com/NousResearch/hermes-agent/issuesGavin大咖助教团队| 中国通信工业协会 | 企业级大模型 Agent 智能体关键技术及项目实战课程运行截图