Open WebUI 与hermes agent集成

Open WebUI（126k★）是目前最受欢迎的自托管 AI 聊天界面。通过 Hermes Agent 内置的 API 服务器，你可以使用 Open WebUI 作为你 Agent 的精美网页前端——支持对话管理、用户账户以及现代化的聊天界面

Open WebUI 与 Hermes Agent 的 API 服务器连接方式，就像连接 OpenAI 一样。你的 Agent术语解释Agent具备自主性、能调用工具以完成目标的 AI 程序。Agent 是一种基于大语言模型的智能程序，能够感知环境、做出决策、调用工具执行操作，并自主推进任务——它不仅能读写文件、执行命令，还能操作浏览器、调用 API，与数字世界进行多轮交互。 会使用其完整的工具集（终端、文件操作、网络搜索、记忆、技能等）处理请求，并返回最终响应。

Open WebUI 以服务器到服务器的方式与 Hermes术语解释Hermes Agent开源 AI 智能体框架与产品的正式名称。Hermes Agent 是项目和产品的正式名称。文档、GitHub 仓库、安装命令、社区讨论和搜索结果都统一使用这一写法。 通信，因此你无需为该集成配置 API_SERVER_CORS_ORIGINS

本例子演示如何将hermes agent与webui对接

1、启用hermes agent和API接口，可以参考连接：hermes agent gateway api

2、启用webui ,直接使用下面命令即可，如下：

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=http://host.docker.internal:8642/v1 \
  -e OPENAI_API_KEY=your-secret-key \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

host.docker.internal 作用：

• Mac / Windows 的 Docker Desktop：系统原生内置这个域名，容器内解析 host.docker.internal，自动解析到宿主机 IP，可以直接访问宿主机服务

• Linux 原生 Docker：默认没有这个域名！不会自动识别，所以必须手动添加参数：

--add-host=host.docker.internal:host-gateway

--add-host 等价于给容器的 /etc/hosts 增加一条静态域名解析：

host.docker.internal   172.16.0.1

host‑gateway 是 docker 内置特殊值，自动指向宿主机的网桥网关 IP，一般就是 172.16.0.1，也就是你的服务器本体，容器内访问 host.docker.internal:8642 → 流量就转发到你的 Linux 宿主机

3、通过ip:3000访问，如下：

附加

如果使用docker-compose，如下：

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data
    environment:
      - OPENAI_API_BASE_URL=http://host.docker.internal:8642/v1
      - OPENAI_API_KEY=your-secret-key
    extra_hosts:
      - "host.docker.internal:host-gateway"
    restart: always

volumes:
  open-webui:

执行如下即可：

docker compose up -d