Hermes Desktop 桌面版完整指南

什么是 Hermes Desktop

Hermes Agent（Nous Research 出品）是一个多平台 AI Agent 框架，启动后在后台作为服务运行，对外暴露：

• 网关 Web UI，默认在 localhost:8642 —— 这就是你的“桌面窗口”
• OpenAI 兼容 API，同样跑在 8642 端口，供程序调用
• 多平台接入：Telegram、Discord、Slack 等消息渠道
• 内置工具：网页搜索（Tavily/Exa/Firecrawl）、Shell 执行、FAL.ai 图片生成、定时任务
• 向量嵌入会话记忆，重启后自动恢复上下文

官方客户端就是把这套服务包成了原生应用。但服务本身仍要有个地方跑 —— 可以是客户端在你本机自带的，也可以是 Docker 里的，或者云端托管的。下面四条路覆盖了主流场景。

与 CLI / 网页版的关系

Hermes 有三种常见使用形态，桌面客户端只是其中一种入口：

• CLI：通过 hermes 命令行直接对话，适合开发者脚本场景
• 桌面客户端 / 网关 Web UI：原生窗口或浏览器里的完整 Chat 界面，支持多会话、工具面板、设置页
• 渠道接入（Telegram / Discord 等）：把 Hermes 挂到消息平台，无需打开浏览器

三者共用同一个 Hermes 进程和同一份会话记忆 —— 在网关 UI 里聊的内容，Telegram 侧也能继续，反之亦然。

支持平台

• macOS（Intel 和 Apple Silicon 均支持）
• Windows 10/11（官方客户端最省事；也可用 Docker Desktop 跑后端）
• 注意：Linux 只有命令行安装，没有官方图形客户端
• Linux（Ubuntu 22.04+、Debian 12+、Arch 等主流发行版）

下面先讲官方客户端怎么装（方案一），再讲它能连的三种后端（方案二到方案四）。只想快速试用的话，装好客户端、用它自带的默认网关就够了。

方案一：官方桌面客户端

Nous Research 在 hermes-agent.nousresearch.com 提供官方客户端。它是真正的原生应用，不是网页套壳。带图形安装包的只有两个平台：

• macOS 12 及以上：下载 .dmg 安装包
• Windows 10/11：下载 .exe 安装包

这两个平台的安装包会连命令行的 hermes 一起装好，不用另外再装一次 CLI。客户端里就是 Hermes 本身：聊天、Profiles 多 Agent 隔离、Kanban 任务看板、Skills 技能系统、MCP 服务器接入、持久记忆、定时任务。

Linux 是例外，官方没有出图形安装包。下面这条终端命令，官方文档写明是“不含 Hermes Desktop 的命令行安装” —— 装完你得到的是 hermes 命令行和网关 Web UI，不是那个原生窗口。这条命令同时也适用于 macOS、WSL2 和 Android 的 Termux：

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

Windows 上对应的纯命令行安装是在 PowerShell 里跑 iex (irm https://hermes-agent.nousresearch.com/install.ps1)。

四种连接模式怎么选

后端在 Settings → Gateway → Connection mode 里选，之后也可以改。客户端找不到可用的 Hermes Agent 时，会在启动时先问你（点过 Repair install 之后也可能再问一次）；已经配好的话，就去 Settings 里改。四种模式：

• 本地网关（Local gateway）：客户端自己在本机起一个网关，不用配置，可离线使用。这是默认项，只是想试试就选这个。（另有一项 使用默认网关（Use default gateway），作用不同 —— 它只是取消当前 profile 的单独设置、回到默认连接。）
• Hermes Cloud：登录 Nous Research 账号，直接选账号下的 Agent。
• 远程网关（Remote gateway）：连一个已经跑在别处的 Hermes，走 HTTPS。接管托管实例就用这个（见方案四）。
• 通过 SSH 连接（Connect via SSH）：客户端通过 SSH 在远程主机上拉起 Hermes 再隧道回本地，不对公网暴露端口。前提是该主机已配好密钥登录。

用客户端接管 OpenClaw Launch 上的托管机器人

如果 Agent 跑在 OpenClaw Launch 上，桌面客户端可以直接接管它 —— 界面是原生的，机器人本身在云端，合上电脑照样在线。

1. 打开控制台，在对应机器人上点 Hermes Desktop。
2. 面板里有三项，各自带复制按钮：远程 URL、用户名、连接密码。
3. 在客户端进入 Settings → Gateway → Connection mode，选 远程网关（Remote gateway），把远程 URL 粘进地址栏，保存。如果客户端启动时直接让你选（全新安装，或点过 Repair install 之后），那就选 Connect to existing Hermes，把同一个 URL 填进去。
4. 地址能通之后，客户端会让你登录（Sign in），填面板里那组用户名和连接密码，最后点 Save and reconnect。

界面语言不同，菜单文字也不同

Hermes Desktop 自带多语言界面（在 Settings 里的 Language 可以切换）。上面这些步骤写的是英文界面的文字；如果你的客户端是中文界面，对应的位置是这几项：

繁体界面里有几项官方还没翻译，会直接显示英文（Connection mode 和 Hermes Cloud 那一段就是），所以同一个页面上中英文混排是正常的，不是装错了。

方案二：本地直装

最快的方式：直接在机器上安装 Hermes，浏览器打开网关，固定标签页或装成 PWA。完全离线可用（模型 API 调用和外部工具除外）。

前置条件

• Python 3.10+（带 pip）
• 至少一个模型提供商的 API Key（OpenAI、Anthropic、OpenRouter，或兼容 OpenAI 接口的本地 Ollama）
• 详细前置环境配置见 Hermes 安装与配置

安装步骤

1. 通过 pip 安装 Hermes Agent：

   pip install hermes-agent

2. 启动网关：

   hermes start

3. 浏览器打开 http://localhost:8642，网关 UI 即刻加载。
4. 首次启动会进入配置向导，连接模型提供商并完成 Agent 基础配置。
5. 可选：把这个标签页安装为 PWA（见下方“进阶技巧”），获得独立窗口体验。

方案三：Docker 隔离运行

用 Docker 跑 Hermes 是最干净的本地方案：和系统 Python 完全隔离，更新方便，通过环境变量配置。只要 Docker Desktop 在跑，容器就持续运行。Windows 上如果只是想用起来，方案一的官方安装包更省事；想让后端和系统环境彻底隔离，再走这条路。

1. 安装并启动 Docker Desktop。
2. 拉取 Hermes Agent 镜像：

   docker pull ghcr.io/nousresearch/hermes-agent:latest

3. 用持久化数据卷运行容器：

   docker run -d \
     --name hermes \
     --restart unless-stopped \
     -p 8642:8642 \
     -v hermes-data:/home/node/.hermes \
     -e OPENAI_API_KEY=sk-... \
     ghcr.io/nousresearch/hermes-agent:latest

4. 浏览器打开 http://localhost:8642。hermes-data 卷会在容器重启和机器重启后保留所有数据。
5. Docker Desktop 设置里开启“开机启动”，容器随系统自动拉起。

方案四：OpenClaw Launch 托管部署

想让 Hermes 随时在线 —— 不依赖自己的电脑开着 —— 托管方案是最省心的选择。你的 Agent 跑在云服务器上，网关 URL 是永久的 HTTPS 地址，不是 localhost，任何设备都能访问。

1. 访问 openclawlaunch.com/zh 注册或登录账号。
2. 在配置器里选择 Hermes Agent 作为 Agent 类型。
3. 选好模型提供商和渠道集成（Telegram、Discord 等），点击“部署”。
4. 约 30 秒后，实例页面显示实时网关 URL，电脑、手机、平板都能直接打开。
5. 把网关 URL 收藏或装成 PWA，同时覆盖桌面和移动端。

桌面版 vs 托管版对比

功能亮点

无论哪种部署方式，Hermes 桌面版网关 UI 都提供：

• 多会话管理：左侧边栏列出所有对话，随时切换
• 工具面板：网页搜索、代码执行、图片生成等工具一键开关
• 会话记忆：向量嵌入持久化，下次打开自动恢复上下文
• 模型切换：对话中途可换底层模型，不丢会话
• 渠道状态：在 Settings 里看 Telegram/Discord 等平台的连接状态
• Skills 管理：查看已安装的 Skills，按需开关

进阶技巧

安装为 PWA（推荐）

Chrome 和 Edge 都支持把任意网页装成独立桌面应用。安装后，网关在独立窗口打开，没有标签栏和地址栏，和原生桌面应用几乎无区别。

• Chrome：打开 localhost:8642（或托管 URL），点击地址栏右侧安装图标 → 安装。应用出现在系统启动台。
• Edge：菜单 → 应用 → 将此站点安装为应用。
• Safari（macOS Sonoma+）：文件 → 添加到程序坞，打开时作为独立应用显示在 Dock。

系统托盘集成

macOS 可用 Mango 或 WebCatalog 把网关 URL 包装成菜单栏应用，一键调出。Windows 可用 Nativefier 生成轻量 Electron 包装。

开机自启配置

• macOS：在 ~/Library/LaunchAgents/ 新建 plist，让系统登录时自动执行 hermes start 或 docker start hermes。
• Windows：把 hermes start 的快捷方式放进启动文件夹（Win+R → shell:startup）。
• Linux：创建 systemd 用户服务（~/.config/systemd/user/hermes.service），设 WantedBy=default.target。

快捷键打开网关

• macOS：用 Raycast 或 Alfred 的“打开 URL”动作绑定热键打开 http://localhost:8642。
• Windows：AutoHotkey 一行：^!h::Run, http://localhost:8642（Ctrl+Alt+H）。
• Linux：在桌面环境设置里把 xdg-open http://localhost:8642 绑定到快捷键。

常见问题

Hermes 有官方桌面客户端吗？

有。Nous Research 已经发布官方桌面客户端，macOS 12+ 和 Windows 10/11 有图形安装包，在 hermes-agent.nousresearch.com 下载；Linux 没有图形安装包，只能命令行安装。本文早前写的是“没有官方客户端”，那是旧版本的情况，现已不适用。下面讲的 PWA、托盘包装等做法仍然有用 —— 尤其是手机、平板上访问同一个 Agent，这是桌面客户端覆盖不到的。

能在手机上访问本地 Hermes 吗？

可以，前提是手机和电脑在同一局域网。先找到电脑的局域网 IP（macOS/Linux 用 ifconfig，Windows 用 ipconfig），然后在手机浏览器打开 http://<局域网IP>:8642。如果需要在任意网络随时访问，用 OpenClaw Launch 托管版，有固定的公网 HTTPS 地址。

Windows 上怎么装最省事？

现在最省事的是方案一：直接下载官方 .exe 安装包，装完连命令行的 hermes 一起有了。想把后端和系统环境隔离，再考虑 Docker Desktop（方案三）。也可以通过 Microsoft Store 或 python.org 装 Python 3.10+ 后 pip install hermes-agent。详细步骤见 Hermes Windows 安装指南。

容器重启或机器重启后数据会丢吗？

不会。Docker 方案挂了命名卷（-v hermes-data:/home/node/.hermes），docker rm 和机器重启都不影响卷里的数据。原生安装（方案二）的会话记忆和配置存在用户主目录，同样自动持久化。

自己装和 OpenClaw Launch 托管有什么区别？

自己装的 Hermes 跑在你自己的机器上，免费，数据就存在那台机器上。它只在那台机器开着的时候可用 —— 笔记本合上就下线，一直开着的服务器则不会。OpenClaw Launch 帮你在云服务器上运行 Hermes —— 随时在线、任意设备访问、无需自己管 Python 或 Docker 环境。功能和网关 UI 完全一样，区别只在基础设施由谁来管。

相关链接

• Hermes Agent 中文介绍
• 安装与配置
• Windows 安装指南
• 网关 Web UI 使用
• 什么是 Hermes Agent
• 托管价格