
wanwu
企业级多租户AI智能体平台,可视化编排工作流与RAG应用
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2386
使用教程
环境要求
- 推荐配置:CPU 8 核或 16 核,内存 32GB,存储 200GB 以上(无需 GPU)
- 已安装 Docker 与 Docker Compose,能访问 Docker Hub
- 若使用 WanwuBot(通用智能体)或单命令创建 Skills,导入模型上下文长度需 ≥32000
- 可选:生成自定义 RSA 前端公钥配置时需要 Node 环境
安装与启动步骤
-
1复制环境变量文件
在项目根目录复制示例环境变量文件,后续所有配置都在 .env 中修改。
cp .env.example .env -
2修改 .env 关键变量
按系统架构设置 WANWU_ARCH(amd64 或 arm64);非本机部署时把 WANWU_EXTERNAL_IP 由 localhost 改为服务器外网 IP,并填写自定义复杂随机串作为 WANWU_BFF_JWT_SIGNING_K
-
3复制本体环境变量
复制本体智能体(Ontology Agent)的环境变量文件,供启动命令一同加载。
cp .env.ontology.example .env.ontology -
4生成 RSA 密钥(可选)
生产环境如需独立密钥可执行以下两步;跳过则使用镜像内置默认密钥,需 Node 环境。
./configs/microservice/ontology/vega-server/generate-keys.sh configs/microservice/ontology/vega-server node configs/microservice/ontology/vega-server/generate-public-key-js.js -
5创建 Docker 网络
创建 wanwu 专用 Docker 运行网络,供各服务容器相互通信。
docker network create wanwu-net -
6启动全部服务
首次运行会自动从 Docker Hub 拉取镜像,耗时较长。amd64 系统用 .env.image.amd64,arm64 系统改用 .env.image.arm64。
docker compose --env-file .env --env-file .env.ontology --env-file .env.image.amd64 up -d -
7登录系统
服务启动后浏览器访问 http://localhost:8081,使用默认账号 admin / Wanwu123456 登录。
-
8停止服务(需要时)
需要关闭平台时,用对应架构的镜像变量文件执行 down 命令,amd64/arm64 择一。
docker compose --env-file .env --env-file .env.ontology --env-file .env.image.amd64 down
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
WANWU_ARCH | 是 | 指定系统处理器架构,决定加载哪套镜像 | amd64 |
WANWU_EXTERNAL_IP | 是 | 平台访问地址;浏览器访问非本机服务器时须改为其外网 IP | 192.168.xx.xx |
WANWU_BFF_JWT_SIGNING_KEY | 是 | 生成 JWT 令牌所用的自定义复杂随机字符串 | aB3xK9mQ7pL2sV6z |
WANWU_BFF_LOGIN_RSA_PATH | 否 | 自定义前后端登录密码 RSA 加密的密钥对路径 | /your/path/rsa |
如何确认成功
浏览器打开 http://localhost:8081,用默认账号 admin、密码 Wanwu123456 能成功登录即部署成功。
常见问题
Q:拉取中间件或其他 Docker 镜像失败怎么办?
A:README 提供了网盘镜像备份,按备份包内 README 说明下载并导入镜像后重新启动即可。
Q:部署在服务器上,浏览器打不开页面?
A:需把 .env 中 WANWU_EXTERNAL_IP 从 localhost 改成服务器的外网 IP(如 192.168.xx.xx),再重启服务。
Q:工作流模块的代码在哪里?
A:v0.1.8 及更早版本在 wanwu-agentscope 仓库,v0.2.0 及以后在 wanwu-workflow 仓库的 wanwu-backend 目录。
Q:导入模型时提示不满足要求?
A:使用 WanwuBot(通用智能体)或用单命令创建 Skills 时,所选模型导入时的上下文长度必须不小于 32000。
Q:如何修改默认账号密码和中间件密码?
A:MySQL、Redis、MinIO、Kafka、Elasticsearch 等中间件密码均可在 .env 中自定义,生产环境务必全部更换默认密码。
注意事项
- 首次启动会自动从 Docker Hub 拉取镜像,请预留足够时间和磁盘空间
- 默认管理员账号 admin / Wanwu123456,仅用于首次登录,生产环境请立即修改
- 前后端用户密码采用 RSA 非对称加密传输,密钥对首次启动自动生成,也可通过配置项自定义
- 如自行生成 RSA 密钥,需先安装 Node 环境以生成前端公钥配置
核心亮点
- 提供可视化编排界面,降低智能体、工作流和RAG应用的开发门槛
- 支持多租户架构,适合企业内部或对外提供AI服务
- 集成模型管理功能,便于统一管理多种AI模型
不足之处
- 文档/社区待观察
- 项目较新,生态和第三方集成尚不成熟
适用场景
- 企业内部快速构建客服、知识问答等智能体应用
- 为行业客户提供多租户AI应用开发与托管平台
- 基于平台二次开发,定制专属的AI工作流和RAG解决方案
替代项目
Dify、FastGPT、Coze
同类项目推荐
agent-c
开源
用 C 语言打造超轻量 AI 智能体,资源受限也能跑
Ultra-lightweight AI Agent
lazycodex
开源
给 Codex 装上记忆和规划,复杂代码库也能一次搞定。
The one and only agent harness for complex codebases. Project memory, planning, exec···
dexter-jp
开源
输入日本股票代码,自动生成深度研究报告
日本株の自律型リサーチAIエージェント|AI agent for deep financial research on Japane···
ii-agent
开源
快速搭建并部署你的 AI 智能体,从原型到生产一步到位。
II-Agent: a new open-source framework to build and deploy intelligent agents
agmsg
开源
让不同AI编程代理在终端里组队聊天协作
Cross-vendor messaging for CLI AI coding agents — let Claude Code, Codex, Gemini & ···
instar
开源
让 Claude Code 持久运行,定时任务+记忆+Telegram 远程操控
Persistent Claude Code agents with scheduling, sessions, memory, and Telegram.
Custom-MCP-Server
开源
让 AI 代理轻松抓取社媒资料和搜索网页,开箱即用
MCP server for scraping LinkedIn, Facebook, Instagram profiles and Google search.
ATLAS_OS
开源
一条提示词,自动完成从规格到发布的整个开发流程
Hook-driven multi-agent CLI — one prompt to specs, code, tests, and a shipped relea···
oh-my-opencode-slim
开源
多模型自动分工,复杂任务又快又省
Lean, fine tuned Opencode multi agent suite · Mix any models · Auto delegate tasks