给Hermes配置OpenWebUI聊天窗口

在Hermes中使用过飞书、微信以及终端，结果都不是很满意，比如飞书的卡片权限问题、微信没有电脑端、终端会话有点乱的说。后面发现，可以使用Open WebUI连接，就像一个普通AI聊天窗口一样。

操作部署

1. Hermes启用API服务器

在 /.hermes/.env 中添加环境变脸

API_SERVER_ENABLED=true
API_SERVER_KEY=随便写，后面给OpenWebUI用
API_SERVER_HOST=0.0.0.0
API_SERVER_PORT=8642

变量	默认值	说明
API_SERVER_ENABLED	false	启用 API 服务器
API_SERVER_PORT	8642	HTTP 服务器端口
API_SERVER_HOST	127.0.0.1	绑定地址
API_SERVER_KEY	(必填)	认证用的 Bearer Token。需与 OPENAI_API_KEY 匹配

2. 启动Hermes Agent网关

hermes gateway restart

看到端口被监听就可以了

3. Docker中启用Open WebUI

docker run -d \
  --name open-webui \
  --restart unless-stopped \
  -p 3000:8080 \
  -e OPENAI_API_BASE_URL=http://Hermes服务器IP:8642/v1 \
  -e OPENAI_API_KEY=这里是前面API_SERVER_KEY值 \
  -v /home/open-webui:/app/backend/data \
  ghcr.io/open-webui/open-webui:v0.8.12

用1Panel安装的话需要在UI中配置OPENAI_API相关配置

4. 打开UI

访问http://open-webui的IP:3000，创建管理员账户（第一个用户将成为管理员）。

这里要添加OPENAI_API相关配置。

1. 点击你的 个人头像 → ​管理员面板
2. 进入 ​设置 → ​外部链接
3. 在OpenAI接口下，点右边锯齿设置
4. 修改OpenAI的接口，输入：
   • URL：http://HermesIP:8642/v1 这里配置Hermes中设置的IP和端口，还要添加v1
   • API Key：这个就是上面自己设置的API_SERVER_KEY值​

5. 测试

回到聊天页面，可以和Hermes聊天了，这里的模型为hermes-agent