CherryStudio 和 OpenWebUI,很多人应该都已经折腾过了。它们算是曾经 AI 热潮里最常被提到的两个工具:一个偏桌面客户端,打开就能聊;一个偏 Web 服务,部署起来之后多端都能用。
AI 工具越来越多,模型越来越多,配置、对话、知识库、用量统计也越来越分散。所以本次想分享一个更能整合多方优点的方案:HaloWebUI。

项目介绍
完整项目名:ztx888/HaloWebUI,可于GitHub搜索。
HaloWebUI 是一个集成了 CherryStudio 和 OpenWebUI 两者优势的项目。它基于官方 Open WebUI 深度定制,化界面提高中文使用体验,增加了模型计费和用量统计,原生集成Claude/Gemini/Grok,内置 HaloClaw 消息网关,一站式管理你的所有大模型。
部署流程
以威联通NAS为例,通过Docker Compose的方式进行部署。
部署代码如下:
services:
halowebui:
image: ghcr.io/ztx888/halowebui:main
container_name: halowebui
restart: unless-stopped
ports:
- "3911:8080"
extra_hosts:
- "host.docker.internal:host-gateway"
environment:
- WEBUI_SECRET_KEY=please_change_this_to_a_long_random_string
- OPENAI_API_BASE_URL=https://api.openai.com/v1 # 兼容地址也可
# - OPENAI_API_KEY=sk-xxxxxxxx
# - ANTHROPIC_API_KEY=xxxxxxxx
# - GEMINI_API_KEY=xxxxxxxx
# - OLLAMA_BASE_URL=http://host.docker.internal:11434
volumes:
- /share/Container/halowebui/data:/app/backend/data # 必须挂载
打开威联通的Container Station创建新的应用程序。

使用一览
部署完毕后,浏览器输入NAS_IP:3911即可访问项目界面。点击底部的「开始使用」。

注册的第一个账户,默认为管理员账户。如果你只打算自用,邮箱随便填写一个符合格式的即可。

弹出功能更新日志。关于一些功能需求、Bug反馈和优化建议,大家可以提Issues。

初始界面如下,是不是感觉很熟悉?

右上角点击头像,进入设置。

来到「接口配置」,在部署时如果没有添加,那么手动添加即可。

输入API地址和密钥并进行测试。

你所用供应商的所有可用模型都会自动刷新,选择要使用的即可。

测试了多个,国产、非国产,官方、三方供应商,都没问题。

其他的一些内容就不去细调了,毕竟本项目是个深度优化集成类型,大家过去如果用过CherryStudio 和 OpenWebUI,HaloWebUI 这边也是信手拈来。

回到对话界面,左上角选择已经导入的模型,助手可以自定义也可不选,对话使用即可。

对话后,后台也可以很清晰的看到数据统计。

最后
HaloWebUI 不是简单再做一个 AI 客户端,而是试图把 CherryStudio 的轻便顺手和 OpenWebUI 的 Web 化部署能力结合起来,再针对中文用户常见的多模型接入、计费统计和统一管理做深度优化。能不能真正成为更适合国内用户的 AI WebUI,还得看实际体验,但这个方向确实很对味。
有需求的朋友可以部署使用。
感谢观看,本文完。
评论区