wanwu 是智能体领域的开源项目,由 UnicomAI 开发,2025 年首次发布。
在全站 13,014 个收录项目中,它的 GitHub 星标数(2,477)位列前 30%,在智能体分类的 2,499 个项目里位列前 15%。
项目目前处于活跃维护状态,最近一次代码更新于 2026-09-21。Apache-2.0 许可证,可自由使用和部署,无付费版本。
它主要面向的使用场景是:企业内部快速构建客服、知识问答等智能体应用。同类可对比的替代方案包括 Dify、FastGPT、Coze。
1复制环境变量文件
在项目根目录复制示例环境变量文件,后续所有配置都在 .env 中修改。
cp .env.example .env2修改 .env 关键变量
按系统架构设置 WANWU_ARCH(amd64 或 arm64);非本机部署时把 WANWU_EXTERNAL_IP 由 localhost 改为服务器外网 IP,并填写自定义复杂随机串作为 WANWU_BFF_JWT_SIGNING_K
3复制本体环境变量
复制本体智能体(Ontology Agent)的环境变量文件,供启动命令一同加载。
cp .env.ontology.example .env.ontology4生成 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.js5创建 Docker 网络
创建 wanwu 专用 Docker 运行网络,供各服务容器相互通信。
docker network create wanwu-net6启动全部服务
首次运行会自动从 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 -d7登录系统
服务启动后浏览器访问 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 中自定义,生产环境务必全部更换默认密码。
Dify、FastGPT、Coze
wanwu 是智能体领域的开源项目,由 UnicomAI 开发,2025 年首次发布。
在全站 13,014 个收录项目中,它的 GitHub 星标数(2,477)位列前 30%,在智能体分类的 2,499 个项目里位列前 15%。
项目目前处于活跃维护状态,最近一次代码更新于 2026-09-21。Apache-2.0 许可证,可自由使用和部署,无付费版本。
它主要面向的使用场景是:企业内部快速构建客服、知识问答等智能体应用。同类可对比的替代方案包括 Dify、FastGPT、Coze。
xinchao-dynamic-mind
开源
给 AI 装上疲惫和欲望,让交互更真实
独立、可自托管的 AI 动态心智状态引擎:驱动力、念头池、疲惫、睡眠与意图。
deepseek-harness
开源
把 AI 能力拆成乐高积木,拼出你的专属智能体。
DeepSeek Harness: Everything is a Plugin.
AutoGPT
开源
开箱即用的 AI 员工,交代任务就自己干完
AutoGPT is the vision of accessible AI for everyone, to use and to build on. Our mis···
EvoAgentX
开源
让 AI 智能体自己迭代变强,越用越聪明
EvoAgentX: Building a Self-Evolving Ecosystem of AI Agents