Hermes Desktop 保姆级安装指南 —— 桌面端、CLI、远程连接,一篇讲完

Hermes Desktop 保姆级安装指南 —— 桌面端、CLI、远程连接，一篇讲完

Hermes 之前只有终端界面（CLI/TUI），好用的功能都在里面——流式输出、工具调用、File Browser、Voice、Cron、Skills、多 Profile——但你要用 Python/Node 装依赖、配 API Key、记一串命令。很多人在"装完"和"能跑"之间卡住了。

Desktop 版就是来解决这个的：原生界面，装好打开就能聊。而且它和 CLI 共用同一套配置、同一套 session、同一套技能——不是一个阉割版。

安装方式：两种入口

方式一：下载 Desktop 安装器（macOS/Windows，推荐）

从 hermes-agent.nousresearch.com/desktop^[1] 下载安装器，双击运行。安装器自动搞定 Python、Node.js、ffmpeg、ripgrep 等全部依赖，开箱即用。

装完后打开桌面应用，跟着 onboarding 流程走一遍：配 provider、选模型、说第一句话。

如果先装了 CLI 版本，后续想试试桌面端，直接运行：

hermes desktop

它会复用你已有的配置、API key、会话和技能。CLI 和 Desktop 的数据互通——你在桌面端开始的会话，可以在终端里继续；反过来也一样。

方式二：CLI 安装 + 启动桌面

如果你已经在用 hermes 命令行，不需要重新下载安装器。一条命令就能打开桌面：

hermes desktop

默认会自动安装依赖并构建桌面端。首次启动会花一两分钟构建 Electron 应用，之后秒开。

常用启动参数：

桌面端里有什么

Chat — 主界面

流式输出，工具调用过程实时显示。支持拖拽文件到聊天区域上传。右侧预览栏可以边聊边看网页渲染、文件内容、工具输出。

会话历史与 CLI/TUI 完全同步——终端里开的 session，在桌面端可以继续聊。

File Browser

不需要离开应用就能浏览和预览工作目录的文件。用 hermes desktop --cwd <path> 或者设 HERMES_DESKTOP_CWD 环境变量来指定初始目录。

Voice

对着 Hermes 说话，它用语音回你。macOS 上系统会弹一次麦克风权限请求。

Settings & Onboarding

在界面里管理 provider、模型、工具、凭据——不再需要手写 YAML。首次启动的 onboarding 几分钟内走到第一句话。

管理面板

桌面端还集成了整套 Hermes 管理功能：

• • Skills — 浏览、安装、管理技能
• • Cron — 查看和管理定时任务
• • Profiles — 切换不同配置/技能/会话的独立环境
• • Messaging — 配置 Telegram、Discord 等消息通道
• • Agents / Command Center — 多 agent 编排

远程连接：把 Desktop 连到远程服务器

默认 Desktop 启动本地后端。你也可以把它指向另一台机器上运行的 hermes dashboard——比如家里的 NAS 或者一台 Mini PC。

后端（远程机器上）

# 1. 设置登录凭据cat >> ~/.hermes/.env <<'EOF'HERMES_DASHBOARD_BASIC_AUTH_USERNAME=adminHERMES_DASHBOARD_BASIC_AUTH_PASSWORD=your-password-hereHERMES_DASHBOARD_BASIC_AUTH_SECRET=$(openssl rand -base64 32)EOFchmod 600 ~/.hermes/.env# 2. 启动 Dashboard（监听非本地地址自动开启认证）hermes dashboard --no-open --host 0.0.0.0 --port 9119

保持这个 hermes dashboard 进程持续运行（用 systemd、tmux 或你的进程管理器）。

桌面端连接

Settings → Gateway → Remote gateway：

1. 1. Remote URL 填 http://<远程IP>:9119
2. 2. 点击 Sign in，输入刚才设的用户名密码
3. 3. 保存并重连——会话立即切换到远程后端

也可以设环境变量 HERMES_DESKTOP_REMOTE_URL，启动时自动连远程。

⚠️ 用户名/密码方式适合局域网或 VPN 内使用。要暴露到公网，建议用 OAuth（Nous Portal）认证。

远程连接故障排查

升级

Desktop 应用后台自动检查更新，有新版时一键升级。

手动升级也兼容：

# 如果在 CLI 安装的环境里hermes update

日志与重置

启动日志在 ~/.hermes/logs/desktop.log：

hermes logs gui -f      # 实时查看日志（类似 tail -f）

常用重置命令：

# 重置首次启动标记rm"$HOME/.hermes/hermes-agent/.hermes-bootstrap-complete"# 重建 Python 虚拟环境rm -rf "$HOME/.hermes/hermes-agent/venv"# 重置 macOS 麦克风权限tccutil reset Microphone com.nousresearch.hermes

支持平台

macOS（Apple Silicon + Intel）、Windows、Linux。macOS/Windows 建议用 Desktop 安装器，Linux 目前优先走 CLI 安装后 hermes desktop。

如果你还没试过 Hermes Desktop，这是最好的时机——不用再输出还是终端，桌面端是完整的产品界面。

📢 关注我，获取最新开源更新日志和开发者工具动态。

#HermesAgent #HermesDesktop #AI终端 #安装指南 #开源

引用链接

[1] hermes-agent.nousresearch.com/desktop: https://hermes-agent.nousresearch.com/desktop