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方式

如果使用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

配置open-webui对接hermes agent中的模型

hermes agent中已经配置了模型，现在想通过open-webui来实现跟hermes agent中的模型对话，指挥hermes agent干活，配置步骤如下：

1、点击open-webui左下角的头像，打开后点击设置，如图：

2、在外部连接页面，点击添加连接，如图：

我的open-webui是部署在docker容器中，因此地址就写http://host.docker.internal:8642/v1，密钥就是开启hermes agent的HTTP API的时候在.env中配置的API_SERVER_KEY的值，下面的模型ID直接些hermes-agent就行，可点击测试按钮测试，如图：

3、测试下聊天，如图：

注：要为每个用户运行独立的 Hermes 实例——每个实例拥有独立的配置、记忆和技能——请使用 配置文件(就是hermes agent的profile)。每个配置文件会在不同端口上运行自己的 API 服务器，并自动将配置文件名称作为模型名称在 Open WebUI 中显示

相关文章