Windows 的 Hermes Web-UI 保姆级安装避坑指南

✍ Suu🕐 2026-04-28📦 5.4 KB 🟢 已读 𝕏 文章列表

本文是一篇针对 Windows 环境下安装 Hermes Web-UI 的保姆级教程。作者针对现有教程步骤跳跃或过时的问题，详细记录了从配置 Node.js 环境、安装 Web-UI 到启动服务的全过程。文中重点分享了后台运行技巧、与 Hermes Agent 的联动注意事项，以及常见报错的排查方法（如端口占用、无反应等），旨在帮助用户在本地搭建美观好用的 AI 聊天界面。

# Windows 的Hermes Web-UI 保姆级安装避坑指南：从安装到翻车避坑，一篇够用 **作者**: Suu **日期**: 2026-04-28T04:33:27.000Z **来源**: [https://x.com/Suu766/status/2048983910076534793](https://x.com/Suu766/status/2048983910076534793) --- ![Image](/doc/1231/image/img_7ee6bd9bf2e0.jpg) # 最近发现一个好玩又好看的WEB-UI，想分享给大家，现在教大家如何安装起来昨天想把 Hermes 的 Web 界面用起来，网上翻了几篇教程，要么太老，要么步骤跳得厉害，有的windows的还安装不上我自己研究了一下，整理了这篇文章，适合在windows上想要弄一个好看又好玩的web界面的小伙伴们先来看看效果： ![图片](/doc/1231/image/img_6867dfa8a8f2.jpg) 是不是感觉特别的有意思，画面有趣还好看话不多说，教程开始： ## 一、先把 Node.js 环境装好 Web-UI 是基于 Node.js 的，所以不管怎样，得先把 Node 装到 Ubuntu 里。这个没啥技术含量，照着敲命令就行。打开Ubuntu终端，先更新一下系统包列表： ``` sudo apt update && sudo apt upgrade -y ``` 中间可能会问你要不要继续，输入 y 回车输密码的时候屏幕上没有任何显示——正常，你就放心盲打，然后回车然后装 Node.js 18.x（太新的版本我没试，这个版本稳定）： ``` curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install -y nodejs ``` 等它跑完。验证一下： ``` node -v npm -v ``` 如果出来两行数字（比如 v18.x.x 和 9.x.x），说明环境搞定了如果报“找不到命令”，那就是上一步没装成功，重新跑一下安装命令就行 ## 二、安装 Web-UI 本身环境好了之后，安装就是一句话的事： ``` npm install -g hermes-web-ui ``` 然后看它刷一堆日志，只要最后没有满屏的红色 ERROR，而是看到类似 added xxx packages 之类的提示，就说明装上了如果网络不好报错，可以换个 npm 源或者挂个代理 ## 三、启动服务，看到界面先试最基础的启动方式： ``` hermes-web-ui start ``` 终端里会输出一堆信息，看到 Server is running on http://localhost:8648 就说明跑起来了然后复制下他给的这串链接 http：//localhost：...... 注意：这个终端窗口不能关，一关服务就断了这时候打开 Windows 上的浏览器（Edge、Chrome 都行），地址栏输入： ``` http://localhost:....... ``` 回车，就能看到一个挺清爽的界面想关掉服务的话，在那个终端窗口按 Ctrl + C，多按两下，它就退了 ## 四、一个偷懒的小技巧：后台运行每次都要留一个黑窗口在任务栏上，挺碍眼你可以这样启动： ``` hermes-web-ui start & ``` 末尾加个 &，它就会跑到后台去这样你关掉终端甚至锁屏，服务还在那里安安静静跑着，下次开浏览器直接能用，跟装了个正经软件一样但有个小问题：用这种方式启动后，以后想关掉怎么办？Ctrl+C 不管用了直接用这个命令暴力清理： ``` pkill -f hermes-web-ui ``` 一下就把后台的 Web-UI 进程干掉了，干净利落 ## 五、日常使用的一些小经验（重要） 1. 记得先启动 Hermes Agent 你需要知道一个事实： Hermes Agent 才是真正干活的大脑，Web-UI 只是一件漂亮衣服衣服穿得再好看，大脑没醒着也没用所以每次打开 Web-UI 准备聊天之前，一定得确保 Agent 在另一个终端窗口里跑着。不然你发消息，它理都不理你，页面就是个空壳 2. 电脑重启之后怎么办 Windows 重启不会自动把 Ubuntu 里的服务拉起来。重启之后你需要手动做两件事： - 开一个终端，启动 Hermes Agent（按你之前习惯的方式） - 再开一个终端，输入 hermes-web-ui start & 然后去浏览器刷新页面，就能继续用了，刚开始觉得麻烦，习惯几次就好了 3. 遇到过的几个小毛病 - 页面打得开，但发消息没反应：十有八九是忘了先启动 Agent，去另一个终端看看大脑在不在线 - 启动时提示 8648 端口已被占用：说明上次的后台服务没关干净，用 pkill -f hermes-web-ui 扫一遍就行 - Web-UI 显示 Agent 干了某件事，但实际上没干：这是 Agent 底层模型自己犯糊涂，跟 UI 没关系，你就当它是个偶尔健忘的朋友，多问几次确认结果就好 ## 最后搞定了这些之后，我感觉用起来确实舒服——历史记录能翻，技能能管，界面也比纯命令行友好太多了，而且还好看跟本地 AI 聊天的体验直接上了一层这篇就是我自己从零跑通的过程，希望能帮你少踩几个坑，如果你有什么问题，也可以在我评论区直接问我，我都会尽量回复的~ 关注我，后续我也会继续分享一些实用的小技巧和干货知识~ ## 相关链接 - [Suu](https://x.com/Suu766) - [@Suu766](https://x.com/Suu766) - [3.7K](https://x.com/Suu766/status/2048983910076534793/analytics) - [Upgrade to Premium](https://x.com/i/premium_sign_up) - [12:33 PM · Apr 28, 2026](https://x.com/Suu766/status/2048983910076534793) - [3,711 Views](https://x.com/Suu766/status/2048983910076534793/analytics) - [View quotes](https://x.com/Suu766/status/2048983910076534793/quotes) --- *导出时间: 2026/4/28 15:26:27*

🔗 相关文档