Hermes Desktop 桌面版快速上手指南

[kop wang]

@laobenxiong API_SERVER_KEY=hermes-remote-8642
这只是Hermes Agent对于API server key的配置，没有实际意义，可以随便起名字。

[laobenxiong]

@kop-wang 帖子中说要起这个服务, 即8642端口要起来. 可是在desktop 的配置中只 用了 9119. 所以我的问题是, 起这个 8642 是怎么起作用的.

[applejuice]

有对比WEBUI 吗？
我现在用webui 用得很开心
我看到这个的界面好像比webui更简单

重点是webui 还可以手机电脑同步
配合fold7 根本就是我想要的办公效果

[kop wang]

@laobenxiong 我重新检查了一下，好像没有关于8642端口的内容。AI确实会回复类似8642端口，8642对应的是Hermes 的 API服务端口，比如类似http://xxx:8642/v1/model，会列出你Hermes Agent的接入模型。但是我测试，desktop侧其实并不需要真正连接这个API，他主要走的其实是dashboard服务，也就是9119的接口流程。

具体8642在desktop侧起什么作用，因为要抢时间，所以没仔细研读hermes源码，如果有发现我会再修订主帖。

[kop wang]

@applejuice 还没有，主要是没用过第三方的webui，hermes之前也是有网页端的，对应功能是dashboard，但是那个更偏向于管理后台，所以美观度和友好度不如第三方webui，有空我会对比下看看。

[laobenxiong]

@kop-wang 好的, 多谢!

[laobenxiong]

@kop-wang 我试了一下, 好像确实是不需要起 8642 这个端口, 就可以连上. 所以, 目前理解, desktop app 使用的是 dashboard 自己使用的 tui-gateway, 而不是那个 api-server (msg-gateway的一部分).

[terry]

@laobenxiong 以后翻译成汉语，不要发这么大一段AI内容。

[laobenxiong]

喊 deepseek-v4-pro 给 hermes 画了一个图, 和它来来回回讨论/修改了半天, 也不知对错:

[Tide]

windows10pro，安装倒是挺快的。但死活设置不了中文，对话框下面显示本地模型正确，对话内容却发送不出去。AI换了一个又一个，没一个AI能解决。。。脑壳疼呀。等我换台电脑再试下。。。

skin: default
language: zh-CN
tui_status_indicator: kaomoji
user_message_preview:
first_lines: 2
last_lines: 2

[kop wang]

@Tide 对话发不出去应该是 tui服务没能正常启动，试试hermes --tui是否能正常运行

[百川吞山海]

桌面版hermes我打了个一排字（调用deepseek 里面是有钱的），总是会少最后面几个字，是的网原因还是硬件（除了4060ti，其余都是洋垃圾），还是软件。有谁出现过这种情况不。

[5ccccc]

@百川吞山海 我也发现有这问题

[laobenxiong]

@5ccccc 打开 cmd 敲 hermes update 先升一下级试试? 我早上升级到了 (+32) 目前好像没碰到这个问题.

[5ccccc]

@laobenxiong 更新到最新了，但是有时候还是会出现这个问题

[linghu007]

AI让我别换。哈哈
Hermes ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
看完了，总结一下关键信息：

Hermes Desktop 是什么
- 独立桌面 App，自带 GUI，不依赖命令行
- 内置了一个本地 TUI gateway（端口 9119），直接连到本地 Hermes 环境
- 卖点：免配置 Messaging Gateway、语音对聊、视觉化 Profile/Agent 人格、视觉化定时任务

几个需要注意的问题（文章里提到的）
- 部分自定义配置（WSL2 里手动改过的）在桌面版里会显示灰色/空白，且改了就回不去了
- Windows 10 上存在中文输入发不出去的问题（跟 TUI 服务有关）
- 打字偶尔会丢末尾几个字（升级有用但不能完全解决）
- 如果配置了错误的 remote URL 会卡在 connecting，需等待 30 秒修复界面

核心矛盾
桌面版走的是自己的 TUI gateway（9119），跟你 WSL2 里配的 systemd gateway 是两套体系。要换过去意味着：
- cronjob 需要迁移到桌面版新的 cron 系统
- Telegram Bot 等 messaging 配置需要重新接
- 各种脚本（监控/信号/推送）不一定能直接用

结论： 这篇文没改变我的判断。如果你现在跑得稳，没必要换——换过去工作量不小，而且还有 bug。如果想尝鲜体验 GUI，可以在另一台机器上装，WSL2 继续当主力跑。

[kop wang]

@linghu007 这里面有很典型的幻觉，比如他没分清desktop和hermes服务之间的关系。如果你是在你目前的本机安装的hermes，那desktop的“安装”是无感的，你hermes update之后，自然可以使用desktop。

[linghu007]

@kop-wang 主要我之前迁移过一次从WIN11迁移到WLS2，确实麻烦。而且很多配置在WLS2中是单独设置的，如果迁移到WIN11，使用桌面版确实可能要调试一番。所以它也是比较了解我的系统状况，给的建议我也要参考。

[kop wang]

@laobenxiong

@5ccccc

确实，我已经双边都升到最新了，但依然还是会出现缺字的情况，我已经大概排查了，是desktop输入框对于需要输入法的语言的输入判断问题。

目前最新的版本，如果你一口气输入中文，回车发送是无效的，他会认为你没有输入任何文字。必须输入一个空格或者什么才能生效。

目前github上已经有对应问题的帖子了：https://github.com/NousResearch/hermes-agent/issues/37483

对应的修复代码也已经被PR，目前还未全数通过，静等就好。

[5ccccc]

@kop-wang 现在这bug也太多了，我每次刚更完，又有更新，感觉我可以先用第三方的GUI了