首页 / AI Trending / UnicomAI/wanwu

wanwu 是什么？

Wanwu（元景万悟）是中国联通开源的多租户 AI Agent 平台。它把模型管理、Agent、可视化工作流、RAG、MCP、联网搜索和 Skills 放进同一套 Docker 服务，并提供 Apache-2.0 许可。

⭐ 4,265 Stars 🍴 85 Forks Go Apache-2.0 作者: UnicomAI
来源：github.com/UnicomAI/wanwu 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

官方仓库面向企业场景，但没有公开充值、订阅额度或同厂付费托管转化入口，且搜索点击持续增长，因此保留并优先改造。

来源：github.com/UnicomAI/wanwu

核心功能

模型与 Agent 管理

统一接入专有和开源模型，创建通用 Agent、角色/决策 Agent 及 Skills；WanwuBot 和一键 Skills 要求所选模型至少 32000 上下文。

来源：github.com/UnicomAI/wanwu
工作流与 RAG

可视化工作流组合条件、API、模型、知识库、代码与 MCP 节点，知识库链路覆盖解析、向量化、检索和精排。

来源：github.com/UnicomAI/wanwu
多租户与中间件

平台通过 BFF 和多个微服务连接 MySQL、Redis、MinIO、Kafka、Elasticsearch 等组件，并提供租户级应用和数据管理。

来源：github.com/UnicomAI/wanwu
信创与开放接入

官方提供 amd64/arm64 镜像以及 TiDB、OceanBase compose 文件，可连接 MCP、Dify 外部知识库和多种模型服务。

来源：github.com/UnicomAI/wanwu

技术架构

浏览器访问 8081 上的前端与 BFF，BFF 再协调用户、模型、Agent、RAG、工作流、MCP 与文件等微服务。Docker Compose 启动数据库、缓存、对象存储、消息队列和检索组件；ontology/decision Agent 另有 callback 与 sandbox。配置分布在 .env、.env.ontology 和架构对应的镜像文件中。

来源：github.com/UnicomAI/wanwu

项目知识图谱

知识图谱：项目核心节点（中心）+ 核心功能（内环六边形）+ 关键技术依赖（外环 chip） Docker 与 ComposeDocker 与 Comp… MySQL、Redis、MinIO、Kafka、ElasticsearchMySQL、Redis、… 可选 TiDB 或 OceanBase可选 TiDB 或 Oc… Node.js（生成 ontology 前端公钥配置）Node.js（生成 o… 外部或自托管模型 模型与 Agent 管理 工作流与 RAG 多租户与中间件 信创与开放接入 wanwu 项目本体 核心功能 关键依赖

技术栈

语言Go 微服务、Web 前端与 Python/RAG 组件框架Docker Compose 多服务平台
关键依赖
Docker 与 ComposeMySQL、Redis、MinIO、Kafka、Elasticsearch可选 TiDB 或 OceanBaseNode.js（生成 ontology 前端公钥配置）外部或自托管模型
基础设施 / 部署
官方建议 8 或 16 核 CPU、32GB RAM、至少 200GB 存储，不要求 GPU；amd64 与 arm64 使用不同镜像环境文件，Web UI 默认 localhost:8081
来源：github.com/UnicomAI/wanwu

快速上手

固定 v0.6.5 后复制 .env.example 和 .env.ontology.example，设置 WANWU_ARCH、WANWU_EXTERNAL_IP 与随机 WANWU_BFF_JWT_SIGNING_KEY，替换所有中间件默认密码，并为 ontology 生成独立 RSA key。创建 wanwu-net 后按 amd64 或 arm64 选择对应镜像文件启动 Compose。首次登录立即修改 admin 的默认密码，不向公网开放 8081。
来源：github.com/UnicomAI/wanwu

使用场景

适合有多租户、私有化部署、模型统一接入、企业知识库和复杂工作流需求的团队。个人单模型问答或资源有限的主机通常不需要这套中间件规模；生产上线前还要完成身份、网络、备份、审计和模型数据合规评估。

来源：github.com/UnicomAI/wanwu

优势与局限

优势

  • 模型、Agent、工作流、RAG 和 MCP 集中管理
  • Apache-2.0 许可便于二次开发
  • amd64、arm64、TiDB 与 OceanBase 都有官方入口

局限

  • Compose 依赖多个中间件，官方建议至少 32GB 内存和 200GB 存储
  • 初始 admin 密码与可选内置 RSA key 不能留在生产环境
  • v0.6.5 修复过 callback 未鉴权导致的 RCE、任意文件读取、SSRF 和用户名枚举，旧版本不应继续部署
  • 模型费用、数据出境和内容保留取决于所接 provider
  • 升级时覆盖 .env 会丢失现有配置，必须先备份并逐项迁移
来源：github.com/UnicomAI/wanwu/releases/tag/v0.6.5

最新版本

截至 2026-09-23，最新 release 是 v0.6.5，发布于 2026-09-18。该版新增腾讯文本生成与向量模型、知识库解析模板、decision Agent，并修复 callback 鉴权、RCE、文件读取、未授权接口、用户名枚举和 SSRF 问题。

来源：github.com/UnicomAI/wanwu/releases/tag/v0.6.5

实测与证据

status: docs-only  |  checked_at: 2026-09-23  |  environment: 核对官方 README、Docker Compose 入口、环境变量说明、LICENSE 与 GitHub Releases  |  limitations: 未拉取镜像，未启动任何中间件、微服务、sandbox 或浏览器界面，未使用默认账号登录，也未配置模型、MCP 或企业数据  |  observed_output: 最新 release 为 v0.6.5，发布于 2026-09-18；官方建议 8/16 核、32GB RAM、200GB 存储，默认 Web UI 为 localhost:8081；release 明列多项安全修复

来源：github.com/UnicomAI/wanwu/releases/tag/v0.6.5

同类项目对比

Dify 同样提供 Agent、工作流、RAG、模型接入和自托管，官方仓库更偏通用 LLM 应用开发平台；Wanwu 额外强调多租户、国内信创数据库、ontology/decision Agent 和联通模型生态。跨地区社区与插件选择可先评估 Dify；需要国产软硬件适配和 Wanwu 现有微服务时再选 Wanwu。

来源：github.com/langgenius/dify

总结评价

教程重点是固定 v0.6.5、替换默认凭据、生成独立 key、核对架构镜像和排查多服务健康状态。

来源：github.com/UnicomAI/wanwu

常见问题

Wanwu v0.6.5 为什么不应沿用旧版部署？

v0.6.5 的官方发布记录修复了 callback 未鉴权导致的远程命令执行、任意文件读取、未授权接口、用户名枚举和 SSRF。已有环境应先备份数据与配置，再按发布说明升级并复测。

Wanwu 首次启动后最先要改什么？

先把默认 admin 密码 Wanwu123456 改掉，再检查 JWT signing key、中间件密码和 ontology RSA key。确认 8081 只对管理网络开放后，才添加模型和业务数据。

Wanwu 页面打不开时先查哪些地方？

先确认 WANWU_ARCH 与镜像文件匹配，wanwu-net 已创建，WANWU_EXTERNAL_IP 符合浏览器访问地址，再用 docker compose ps 和 logs 找出未健康的中间件或服务。镜像拉取失败可查看官方备份说明。

WanwuBot 为什么导入模型后不能正常工作？

官方要求 WanwuBot 和一键创建 Skills 所用模型的上下文长度至少为 32000。还应检查模型协议、Base URL、凭据、网络可达性和实际 provider 限额。

Wanwu 和 Dify 怎样选？

Dify 更适合通用 LLM 应用、社区插件和跨地区部署；Wanwu 更强调多租户、信创数据库、ontology/decision Agent 和中国联通生态。选择前应比较现有基础设施、模型来源和运维能力。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新，请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料：README、GitHub API、依赖文件