小白教程！手把手教你打造AI专属平台：Hermes + Open WebUI 实现打开网页对话

上周末写了一篇《小白教程：手把手教你Docker部署Hermes+接入个人微信（ClawBot）成为你的私人助手》看回复有几位朋友已经安装成功了，看论坛很多人都在问怎么才能像OpenClaw（龙虾）一样通过网页就可以和AI对话，因为Hermes 确实只能通过终端交互，虽然近期也推出了实验性的 hermes dashboard 管理面板，但它主要用来查看状态和配置，并不是一个功能完整的聊天界面。目前看来最主流、体验最好的方案就是 Hermes + Open WebUI 来实现。

一、如何给Hermes穿上合适的新衣服
1、检查并完善Hermes的Compose配置（给Hermes量量尺寸）

• 看配置中是否有下方代码，打开【Docker】-【项目】-【hermes-agent】-【Compose配置】查看。
  

1. API_SERVER_ENABLED=true
   
2. API_SERVER_KEY=MyUgNasKey123! # 设置连接密码（自己编一个，建议8位以上，后面要用）
   
3. API_SERVER_HOST=0.0.0.0 # 监听所有网络接口，允许 WebUI 连接
   
4. API_SERVER_PORT=8642 # 端口号（默认8642，不用改）

复制代码

• 如果没有就添加上，复制上方代码并粘贴（注意粘贴时一定注意对齐，不然会报错）在如图所示位置。然后点击【重新部署】-【确定部署】-【完成】
  

2、部署Open WebUI （给Hermes买件合适的衣服）

• 打开【Docker】-【项目】-【创建】
• 在项目名称一栏可以填写 open-webui。存放路径可以为空，系统会自动在 docker 目录下生成与项目同名的文件夹，用于集中存放配置文件与数据。将下方代码复制粘贴到Compose 配置区域，最后点立即部署，等待部署完毕（可能由于网络和文件大小影响，等待时间较长，请耐心等待），最后点击完成即可。
  

1. services:
   
2.   open-webui:
   
3.     image: ghcr.io/open-webui/open-webui:main
   
4.     container_name: open-webui
   
5.     restart: unless-stopped
   
6.     ports:
   
7.       - "3000:8080"   # 访问端口：http://NAS_IP:3000
   
8.     environment:
   
9.       # 使用 host.docker.internal 指向 NAS 宿主机
   
10.       - OPENAI_API_BASE_URL=http://host.docker.internal:8642/v1
    
11.       # 🔑 必须与第一步设置的 API_SERVER_KEY 完全一致！
    
12.       - OPENAI_API_KEY=MyUgNasKey123!
    
13.     extra_hosts:
    
14.       # 绿联 Linux 环境必需，用于容器访问宿主机服务
    
15.       - "host.docker.internal:host-gateway"
    
16.     volumes:
    
17.       - ./data:/app/backend/data  # 持久化数据

复制代码

3、打开Open WebUI 登录（给Hermes穿上新衣照照镜子）

• 在浏览器输入下方规则的地址，打开页面，输入用户名，邮箱，密码注册并登录。登录成功就可以对话了。（NAS_IP可以在【控制面板-网络设置-网络连接】中查看）
  

1. 登录地址：http://NAS_IP:3000

复制代码

常见问题：
1、输入地址无法打开页面
不要着急，大概率可能是服务正在配置或启动中，请稍等一会在尝试看看，如果还是不行可以尝试重启服务（打开【Docker】-【容器】-找到Open WebUI，点右边的三个点，点重启），重启后稍等一会再试试。

希望在配置过程中，大家都一切顺利，如遇到任何问题，大家可以留言讨论一起想办法。

看来，我也要部署Hermes 了

playok 发表于 2026-4-21 18:28
看来，我也要部署Hermes 了

大佬求救：我只更改了API_SERVER_KEY，为什么链接不上

fwHJWA 发表于 2026-4-23 03:37
大佬求救：我只更改了API_SERVER_KEY，为什么链接不上

看看日志，原因很多，需要一点点慢慢分析。

fwHJWA 发表于 2026-4-23 03:37
大佬求救：我只更改了API_SERVER_KEY，为什么链接不上

解决了，是正在配置

fwHJWA 发表于 2026-4-23 07:28
解决了，是正在配置

好的！

这个要怎么修改

RfxglC 发表于 2026-4-28 08:46
这个要怎么修改

刚刚配置完吧，重启一下Open WebUI，等半个小时左右再试试，反正启动时间挺长