入门10 分钟阅读

Hermes Agent 桌面客户端安装与首次使用指南

CATAITO Team2026-08-07

你的操作系统:

学习目标

学完本教程，你将能够：

在你的操作系统上下载并安装 Hermes Agent 桌面客户端
登录并开始你的第一次聊天会话
熟悉桌面客户端的界面
使用核心功能：聊天、仓库发现、技能和设置
排查常见问题

所需时间： 10–15 分钟

难度： 初级

本篇覆盖哪个版本？ 本教程覆盖 Hermes Agent 桌面客户端——适用于 macOS、Windows 和 Linux 的原生图形界面应用。它使用与 Hermes Agent CLI 相同的智能体核心、配置、会话、技能和记忆。如果你想在终端中工作，请看《Hermes Agent CLI 入门指南》。

开始之前

要求	说明
操作系统	macOS、Windows 10/11 或 Linux
账号	Nous Portal 账号，或支持的提供商的 API key
Hermes Agent CLI	桌面客户端共享相同的智能体核心——通过 CLI 或桌面安装器安装
网络	稳定的互联网连接

什么是 Hermes Agent 桌面客户端？

Hermes Agent 桌面客户端是基于 Hermes Agent 构建的原生桌面应用，与 CLI 和消息网关运行的是同一个智能体。它不是独立产品——你在 CLI 中配置的一切（配置、API key、会话、技能、记忆）在桌面客户端中都可用，你在桌面客户端中做的任何事也会同步到 CLI。它支持 macOS、Windows 和 Linux。

下载与安装

Hermes Agent 桌面客户端支持 macOS、Windows 和 Linux。有两种安装方式。

选项 A：桌面安装器（推荐）

从官网下载安装器并运行。这会同时安装桌面客户端和 CLI。

Windows： 点击 Download for Windows，运行安装程序，按屏幕提示操作。从开始菜单启动 Hermes Agent。
macOS： 点击 Download for macOS，打开 .dmg 文件，把 Hermes Agent 拖入 Applications 文件夹，然后启动。
Linux： 下载 AppImage，添加执行权限（chmod +x），然后运行。或者使用下方选项 B。

选项 B：CLI 安装 + 桌面命令

如果你已经安装了 Hermes Agent CLI，直接运行：

bash

hermes desktop

这会用你现有的配置、API key、会话和技能启动桌面客户端。无需单独安装。

验证安装

桌面客户端打开后，你应该会看到带左侧边栏的 Hermes Agent 聊天界面。如果提示登录，请按下面的步骤操作。

首次启动与设置

第 1 步：登录

首次打开桌面客户端时，你可能需要登录到你的提供商：

1如果你已经在 CLI 中配置了提供商，桌面客户端会自动使用相同的配置。
2如果没有，点击左侧边栏的设置，进入提供商部分。
3点击设置提供商并按照提示操作。最快的方式是 Nous Portal——一次 OAuth 登录即可使用 300+ 模型和工具网关（网页搜索、图像生成、TTS、云浏览器）。

第 2 步：熟悉界面

桌面客户端是聊天优先的窗口，带左侧边栏：

聊天 —— 应用的核心。输入消息、接收流式回复，实时查看智能体的工具活动。
左侧边栏 —— 在会话、项目、技能、MCP 服务器、插件和设置之间导航。
状态栏（底部）—— 显示 YOLO 开关、上下文使用量指示器和可自定义项目。右键可自定义显示内容。
预览栏（右侧）—— 在你继续聊天时，并排渲染网页、文件和处理结果。

你还可以按 Cmd/Ctrl + K 打开命令面板，快速访问任意功能。

第 3 步：开始你的第一次聊天

1确保左侧边栏中选中了一个会话。
2在底部输入框中输入消息并按回车：

text

你好！你能做什么？

1Hermes Agent 会流式回复它的能力概述，并实时显示工具活动。
2试试把一个文件拖进聊天区域，把它附加到下一条消息中。

第 4 步：尝试核心功能

新建会话： 点击边栏中会话旁的 + 按钮，开启并行对话。
仓库发现： 桌面客户端会扫描你的主目录中的 Git 仓库，并在项目侧边栏中列出，方便快速访问。
技能： 从技能侧边栏浏览和安装技能。
MCP 服务器： 从 MCP 侧边栏配置 MCP 服务器。
插件： 安装桌面 UI 插件，添加自定义面板和命令。
主题： 用皮肤和主题自定义应用外观。

故障排查

问题	解决方法
桌面客户端无法打开	确认系统满足要求。在 Linux 上，确保 AppImage 有执行权限（`chmod +x`）。
"未配置提供商"	进入设置 → 提供商配置提供商。最快方式是在 CLI 中运行 `hermes setup --portal`。
CLI 中的会话不显示	桌面客户端共享同一个会话存储。如果会话缺失，重启桌面客户端。
桌面客户端卡顿	关闭其他应用，检查网络连接。
登录失败	确认你可以在 hermes-agent.nousresearch.com 登录；必要时重置密码。

如何更新

桌面客户端随 CLI 一起更新。在终端中运行：