在 Windows 上安装 Hermes Agent (含 WebUI、踩坑与修复)

这篇内容真正有价值的,不是“把环境装起来”本身,而是把 Hermes 本地长期运行环境 这件事整理成了一项别人也能复盘、也能迁移的能力。

我更愿意把这篇帖子看成一张“本地运行能力卡”,而不是一次性的装机记录。因为真正值得借鉴的,不是哪条命令,而是你怎么把 Windows、WSL2、Ubuntu、Hermes Agent 和 Open WebUI 组织成一套能长期工作的本地系统。

01. 先看一张信息卡

项目 信息
Skill 名称 Herme本地长期运行环境搭建能力 - Hermes agent
适用对象 想在 Windows 上长期稳定使用 Hermes Agent、本地 API、Open WebUI 的用户
核心目标 把一次性装环境,变成可长期维护、可复盘、可迁移的本地工作台
关键组件 WSL2、Ubuntu、Hermes Agent、Open WebUI、systemd
官方网站 Hermes AgentOpen WebUI
文档参考 WSL 官方文档Ubuntu on WSLOpen WebUI Docs
一句话理解 这不是单纯把 AI 跑起来,而是把它变成一项能长期复用的本地能力。

02. 它真正解决的,不是“能不能装上”

说白了,很多本地 AI 环境一开始都能跑。

真正的问题通常出现在后面:

  • 系统盘越用越满
  • 服务靠手动启动,不稳定
  • WebUI 能打开,但和 API 连不通
  • 配置迁移看起来成功,细节却丢了
  • 数据库迁移做了一半,环境进入半可用状态

所以这篇东西真正解决的,不是“装一个软件”,而是 怎么把本地 AI 工作环境搭成长期能用、出问题也能修的系统

这也是为什么它更像一个 skill。

因为别人看完以后,不只是知道“你装成了”,而是能理解:以后自己也可以按这个思路搭一套。

03. 这项能力真正由哪些机制组成

它的核心并不神秘,本质上就是把几个关键环节组织对。

第一层:把目录和资源规划好

WSL 和 swap 不提前规划,后面最容易拖垮的就是系统盘。

所以把发行版、虚拟磁盘、swap 这类长期增长的东西尽量放到 D:,本质上是在给后面的持续使用留空间。

第二层:把 Hermes 从“命令”变成“服务”

如果 Hermes 只是偶尔手动跑一下,它就是一个工具。

但一旦你要长期接 API、连 WebUI、做自动化,它更适合被 systemd 托管。这样它才像一个可靠服务,而不是一次性脚本。

第三层:把已有配置迁移过来,而不是重造一遍

如果本机已经有 ClawX / OpenClaw 的模型配置,最省事的方式不是全部重配,而是迁移。

但迁移最值得提醒的一点是:

  • 自动化能迁结构
  • 不一定能迁完整语义

providerbase_url、默认模型、自定义 provider 这种地方,最后还是要人工复核。

第四层:把 WebUI 联通问题想成网络边界问题

这篇里最典型的一个坑就是:

宿主机能访问,不代表 Docker 容器也能访问。

如果 API 只监听 127.0.0.1,那很多时候只是宿主机自己能连,容器并不能通过 host.docker.internal 正常打到 Hermes。

这个坑看着小,但特别耗排障时间。

04. 最值得记住的亮点是什么

我觉得这篇最值得借鉴的,不是某个命令,而是它把“本地环境搭建”讲成了“长期运行能力建设”。

这两者差别很大。

前者更像一次性施工,后者更像给自己搭基础设施。

它最有记忆点的几个地方其实是:

  • 提前把磁盘与资源规划清楚
  • systemd 让 Hermes 进入稳定运行状态
  • 复用旧配置,但不迷信自动迁移
  • 把 WebUI 联通问题看成监听地址和容器边界问题
  • 出问题先备份,再修状态,而不是直接删库重来

尤其是 Open WebUI 数据库迁移这一段,很有代表性。

很多环境不是“全坏了”,而是进入了最麻烦的半成功状态:

  • 表像是建了
  • revision 又没对齐
  • 容器能起但不健康
  • 一删数据又怕把已有内容一起带走

这种经验特别值钱,因为它告诉别人:

长期环境最怕的不是报错,而是半可用。

05. 这项能力的代价和限制也要看清

当然,这类 skill 也不是没有门槛。

它的代价主要在这里:

  • 你要同时理解 Windows、WSL、Ubuntu、Docker、WebUI 这几层关系
  • 自动化迁移只能省一部分事,关键配置仍然要人工复核
  • 一旦服务化运行,后期维护和回滚意识就比首次安装更重要
  • 数据库、端口、监听地址这类细节,一旦没理顺,后面排障成本会明显上升

换句话说,这不是“最省事”的方案。

但如果你是准备长期用 Hermes、本地跑 API、还要接 UI 和自动化,这反而是更省总时间的方案。

06. 最后一句话

真正有价值的本地 AI 环境,不是第一次装得快,而是三个月后它还在稳定工作。