HaloWebUI ：基于Open WebUI 深度定制的自托管AI平台

木木 • 12小时前 • OpenAI • 3 views

文章目录

AI智能摘要

HaloWebUI 是对 Open WebUI 的深度定制型自托管平台，核心在于原生集成 Anthropic Claude、Google Gemini 与 xAI Grok，并内置 HaloClaw 消息网关，实现一站式管理多模型与中文友好界面。部署通过官方提供的 docker 或 docker-compose 镜像完成：main 镜像预装 uv/uvx、node/npx 与 git，便于直接运行常见 stdio MCP 预设；slim 镜像去除这些运行时以减小体积。

— 此摘要由AI分析文章内容生成，仅供参考。

项目地址：ztx888/HaloWebUI: 基于官方OpenWebUI，汉化界面提高中文使用体验

项目简介

基于 Open WebUI 深度定制，原生集成 Anthropic Claude / Google Gemini / xAI Grok，
内置 HaloClaw 消息网关，一站式管理你的所有大模型。

界面预览

安装部署

1.docker run

docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name halowebui \
  --restart always \
  ghcr.io/ztx888/halowebui:main

2.docker-compose

services:
  halowebui:
    image: ghcr.io/ztx888/halowebui:main
    container_name: halowebui
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data
    extra_hosts:
      - "host.docker.internal:host-gateway"
    restart: always

volumes:
  open-webui:

docker compose up -d

MCP stdio说明

官方 main 镜像是默认推荐版，内置了 uv/uvx、node/npx 与 git，可直接体验当前内置的常见 stdio MCP 预设，也兼容一部分通过 uvx --from git+... 安装的 MCP。
官方 slim 镜像是极简版，不内置 uv/uvx、node/npx、git 等 stdio MCP 常用运行时，适合更在意镜像体积和依赖面的部署场景。
stdio MCP 命令运行在 HaloWebUI 服务端容器内，不是在浏览器或你的本机 shell 里执行。
某些自定义 stdio MCP 会通过 Git 源安装（例如 uvx --from git+https://...）；这类配置除了 uv/uvx 之外还依赖 git。
MCP 配置保存后不会自动验证，需要进入对应配置并手动点击 验证连接 / 重新验证。
docker exec 进入容器后能运行某个命令，不代表临时 shell 路径一定适合长期配置为 MCP command；请优先使用镜像内稳定安装路径或服务主进程可见的常规 PATH，避免依赖 fnm_multishells/... 这类临时路径。
stdio MCP 本身不会长期常驻占用额外内存；额外内存主要来自实际启动的 MCP 子进程，空闲后会按系统配置自动回收。