Hermes Desktop 桌面版完整指南

什么是 Hermes Desktop

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

• 浏览器管理后台：用 hermes dashboard 启动，默认地址 127.0.0.1:9119，可改配置、管 API Key、看会话和日志，还自带 Chat 页
• OpenAI 兼容 API，跑在 8642 端口，供程序和 Open WebUI 这类第三方聊天界面调用（它不是网页界面）
• 多平台接入：Telegram、Discord、Slack 等消息渠道
• 内置工具：网页搜索（Tavily/Exa/Firecrawl）、Shell 执行、FAL.ai 图片生成、定时任务
• 持久记忆：存在 MEMORY.md 和 USER.md，也可接外部记忆服务，重启后照样保留

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

与 CLI / 网页版的关系

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

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

三者共用同一份配置、Skills 和记忆，会话也能在不同入口之间接着用。

支持平台

• macOS 12 及以上（Apple Silicon 是官方优先支持的平台；Intel Mac 官方文档说法不一，用前先看最新说明）
• Windows 10/11（官方客户端最省事；也可用 Docker Desktop 跑后端）
• Linux：没有图形安装包，用终端命令安装后运行 hermes desktop 打开客户端

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

方案一：官方桌面客户端

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 命令行、终端界面（TUI）和浏览器后台；想要原生窗口，装完再运行 hermes desktop。这条命令适用于 Linux、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 → Gateways → Connection mode 里选（旧版客户端叫 Gateway），之后也可以改。客户端找不到可用的 Hermes Agent 时，会在启动时先问你（点过 Repair install 之后也可能再问一次）；已经配好的话，就去 Settings 里改。四种模式：

• 本地网关（Local gateway）：客户端自己在本机起一个网关，不用配置，可离线使用。这是默认项，只是想试试就选这个。（另有一项 使用默认网关（Use default gateway），作用不同 —— 它只是取消当前 profile 的单独设置、回到默认连接。）
• Hermes Cloud：登录 Nous Research 账号，直接选账号下的 Agent。
• 远程网关（Remote gateway）：连一个已经跑在别处的 Hermes，登录后使用。接管托管实例就用这个（见方案四）。
• SSH：新版客户端把 SSH 放到了同一页下方的 Registered gateways → Add，可以和本地、远程、Hermes Cloud 连接一起登记、随时切换。前提是该主机已配好密钥登录。

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

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

1. 打开控制台，在连接平台区域点 Hermes Desktop，再选要接管的机器人。（机器人卡片上的桌面按钮是另一个功能：机器人的远程桌面，不是 Hermes 客户端。）
2. 面板里有三项，各自带复制按钮：远程 URL、用户名、连接密码。
3. 在客户端进入 Settings → Gateways → Connection mode（旧版叫 Gateway），选 远程网关（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。这一条是给从终端安装、想直接用浏览器后台或消息网关、不装客户端的情况。

前置条件

• macOS、Linux 或 WSL2（原生 Windows 用上面的 PowerShell 安装命令）
• 能用的模型：某个提供商的 API Key 或订阅登录（OpenAI、Anthropic、OpenRouter、Nous Portal 等），或本地的 Ollama
• 详细前置环境配置见 Hermes 安装与配置

安装步骤

1. 用官方脚本安装 Hermes Agent：

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

2. 运行配置向导，接好模型提供商：

   hermes setup

3. 打开浏览器后台，地址是 http://127.0.0.1:9119：

   hermes dashboard

4. 要接 Telegram、Discord 等平台，用 hermes gateway 启动消息网关，或用 hermes gateway install 装成后台服务。
5. 可选：把后台标签页安装为 PWA（见下方“进阶技巧”），获得独立窗口体验。

方案三：Docker 隔离运行

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

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

   docker pull nousresearch/hermes-agent:latest

3. 先交互式跑一次配置向导，配置和 Key 会写进本机的 ~/.hermes：

   mkdir -p ~/.hermes
   docker run -it --rm -v ~/.hermes:/opt/data nousresearch/hermes-agent setup

4. 后台启动网关和浏览器后台：

   docker run -d \
     --name hermes \
     --restart unless-stopped \
     -v ~/.hermes:/opt/data \
     -p 8642:8642 -p 9119:9119 \
     -e HERMES_DASHBOARD=1 \
     nousresearch/hermes-agent gateway run

5. 容器里的后台绑定 0.0.0.0，所以必须设登录：在 ~/.hermes/.env 里加上 HERMES_DASHBOARD_BASIC_AUTH_USERNAME、HERMES_DASHBOARD_BASIC_AUTH_PASSWORD 和 HERMES_DASHBOARD_BASIC_AUTH_SECRET，再打开 http://localhost:9119。8642 是 OpenAI 兼容 API，不是网页界面。数据存在本机 ~/.hermes，容器重启不会丢。在 Docker Desktop 上用全新的 ~/.hermes 没问题；如果要挂载本机原生安装留下的旧 ~/.hermes，启动后在容器里跑一次 docker exec hermes hermes doctor，会话数据库可能需要按官方 Docker 文档做一次转换。
6. Docker Desktop 设置里开启“登录时启动”，登录电脑、Docker Desktop 起来之后容器会自动恢复。

方案四：OpenClaw Launch 托管部署

想让 Hermes 随时在线 —— 不依赖自己的电脑开着 —— 托管方案是最省心的选择。你的 Agent 跑在云服务器上，通过 HTTPS 和你的账号登录访问，不是 localhost，任何设备都能用。

1. 访问 openclawlaunch.com/zh 注册或登录账号。
2. 在配置器里选择 Hermes Agent 作为 Agent 类型。
3. 选好模型提供商和渠道集成（Telegram、Discord 等），点击“部署”。
4. 部署完成后，机器人出现在控制台。用快速聊天直接对话，或点打开仪表板进入它的 Hermes 后台，电脑、手机、平板都能用。
5. 想要原生窗口，按上面“用客户端接管 OpenClaw Launch 上的托管机器人”的步骤连接客户端。

桌面版 vs 托管版对比

功能亮点

无论哪种部署方式，桌面客户端和浏览器后台都提供：

• 多会话管理：会话列表随时切换
• 会话记录：历史会话可搜索、可接着聊
• 持久记忆：MEMORY.md / USER.md，跨会话保留
• 模型切换：对话中途可换底层模型，不丢会话
• 渠道状态：在后台的 Channels 页看 Telegram/Discord 等平台的连接状态
• Skills 管理：查看已安装的 Skills，按需开关

进阶技巧

安装为 PWA（推荐）

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

• Chrome：打开 127.0.0.1:9119（本机的 hermes dashboard），在菜单里选“投放、保存和分享 → 将页面作为应用安装”。应用出现在系统启动台。
• Edge：菜单 → 应用 → 将此站点安装为应用。
• Safari（macOS Sonoma+）：文件 → 添加到程序坞，打开时作为独立应用显示在 Dock。

系统托盘集成

macOS 可用 Mango 或 WebCatalog 把后台地址包装成菜单栏应用，一键调出。Windows 可用 Nativefier 生成轻量 Electron 包装。

开机自启配置

• macOS：消息网关用 hermes gateway install 注册 launchd 服务；浏览器后台可在 ~/Library/LaunchAgents/ 新建 plist，登录时执行 hermes dashboard --no-open（或 docker start hermes）。
• Windows：桌面客户端自己管后端。命令行安装的话，把 hermes dashboard --no-open 的快捷方式放进启动文件夹（Win+R → shell:startup）。
• Linux：hermes gateway install 会建好消息网关的用户服务；浏览器后台另建 systemd 用户服务（~/.config/systemd/user/hermes-dashboard.service）执行 hermes dashboard --no-open，设 WantedBy=default.target。

快捷键打开后台

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

常见问题

Hermes 有官方桌面客户端吗？

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

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

可以，但要先配一下。浏览器后台默认只绑定 127.0.0.1:9119，手机访问不到；要么用 Tailscale 等隧道连进来，要么把它绑定到局域网或 Tailscale 地址并设好用户名密码（绑定到非本机地址时必须设登录）。详见 网关 Web UI 使用。不想折腾、要在任意网络随时访问，用 OpenClaw Launch 托管版，通过 HTTPS 和账号登录访问。

Windows 上怎么装最省事？

现在最省事的是方案一：直接下载官方 .exe 安装包，装完连命令行的 hermes 一起有了。想把后端和系统环境隔离，再考虑 Docker Desktop（方案三）。不想要客户端的话，也可以用方案一里的 PowerShell 命令行安装。详细步骤见 Hermes Windows 安装指南。

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

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

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

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

相关链接

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