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 图片生成、定时任务
• 向量嵌入会话记忆，重启后自动恢复上下文

简单说：Hermes 的“桌面版”体验，就是把网关标签页固定在浏览器里，或者用 PWA 安装成独立窗口。下面三条路覆盖了主流场景。

与 CLI / 网页版的关系

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

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

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

支持平台

• macOS（Intel 和 Apple Silicon 均支持）
• Windows 10/11（推荐通过 Docker Desktop 运行，依赖最少）
• Linux（Ubuntu 22.04+、Debian 12+、Arch 等主流发行版）

三个平台的安装步骤略有差异，下面分方案介绍。

方案一：本地直装（最简单）

最快的方式：直接在机器上安装 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 没有发布 Electron、Tauri 或原生桌面安装包。Hermes 是 Python 服务端框架，官方体验入口就是 localhost:8642 网关 UI。把它装成 PWA 或用系统托盘工具包装，实际使用和原生应用差别不大。

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

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

Windows 上怎么装最省事？

推荐 Docker Desktop 方案（方案二）—— Docker 自动处理 Linux 依赖，不需要手动配置 Python 环境。也可以通过 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
• 托管价格