开源 企业版 高校版 私有云 模力方舟 AI 队友
Nuwax - 通用智能体操作系统,打造你私有的垂类通用智能体。新一代AI应用设计、开发、实践平台,无需代码,轻松创建,适合各类人群,支持多种端发布及API,提供完善的工作流、插件以及应用开发能力,RAG知识库与数据表存储能力,MCP接入以及开放能力。
精选
自定义精选项目
最多可选取 6 个公开仓库
还能勾选 0 个
组织介绍

Nuwax

Nuwax AI - Easily build and deploy your private Agentic AI solutions.

官方网站:https://agent.nuwax.com

中文文档|English Doc | Contributing | Documentation

安装部署

借助于官方提供的 nuwax-cli 命令工具,来快速本地部署服务。

快速开始

环境准备

系统要求
  • 系统要求: Ubuntu22.04LTS 或以上版本(其他 linux 版本未充分测试),macOS 10.15+,Windows 10/11(后续支持)
  • 配置要求: 4 核 8G 或以上
  • 环境要求: docker、docker-compose V2 环境 docker 安装指南
支持的平台
  • Linux: x86_64, ARM64
    • Ubuntu 22.04 LTS(推荐)
    • 当前用户需要有 Docker 权限,验证方式docker ps,查看是否有权限问题, 碰到权限问题,可以使用 sudo 权限运行。
    • 推荐使用阿里云镜像加速
  • macOS: Intel, Apple Silicon (M1/M2), Universal
    • macOS 10.15 (Catalina) 及以上版本
    • 推荐使用 OrbStack(个人免费,性能更佳)
    • 确保 OrbStack 或 Docker Desktop 已启动
    • 首次运行可能需要允许未知开发者:系统偏好设置 → 安全性与隐私

本地部署服务指南

有 2 个部署服务:

  • 主体工程服务(必选)
  • 智能体电脑(沙箱)部署指南(可选)。

在主体本地服务中,配置一个或多个智能体电脑部署的部署地址等,就可以使用智能体电脑(沙箱)。因 "智能体电脑(沙箱)"有个人电脑(沙箱)可用,所需资源更多,因此支持分开部署多个服务器上。

部署主体服务

智能体电脑(沙箱)部署指南

可以在多个不同的服务器部署智能体电脑服务,通过配置实现分布式智能体沙箱能力。

环境要求:每台服务器需要安装 Docker 和 Docker Compose 环境,参考 安装文档

常用管理命令

服务管理

  • 启动服务:./nuwax-cli docker-service start
  • 停止服务:./nuwax-cli docker-service stop
  • 重启服务:./nuwax-cli docker-service restart
  • 检查状态:./nuwax-cli docker-service status

备份管理

备份服务需要停止 Docker 应用服务器,建议业务低谷时操作

  • 一键备份(推荐):
    • 手动执行备份:./nuwax-cli auto-backup run
    • 列出所有备份:./nuwax-cli list-backups
    • 从备份恢复:./nuwax-cli rollback [BACKUP_ID]

升级管理

应用服务升级,使用命令./nuwax-cli auto-upgrade-deploy run 会自动检测下载新版本,自动部署。

完整升级流程:

# 检查运维客户端是否有新版本并更新
./nuwax-cli check-update install
# 更新应用服务
./nuwax-cli auto-upgrade-deploy run

Docker 环境安装

重要说明: Docker 和 Docker Compose 是运行本服务的核心依赖,必须正确安装。

如果你的系统中还没有安装 Docker 环境,请参考详细的 Docker 环境安装指南 。

该安装指南包含以下平台的详细安装步骤:

  • Ubuntu 24.04.3 LTS(推荐 Linux 发行版)
  • macOS(支持 OrbStack 和 Docker Desktop)
  • 镜像加速配置(中国大陆用户专用)

推荐方案:一键安装配置 Docker 脚本

社区一键安装配置 Docker 脚本

该脚本支持 13 种 Linux 发行版,包括国产操作系统(openEuler、Anolis OS、OpenCloudOS、Alinux、Kylin Linux),一键安装 docker、docker-compose 并自动配置轩辕镜像加速源。

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

脚本特性与优势

✅ 支持 13 种主流发行版:openEuler (欧拉)、OpenCloudOS、Anolis OS (龙蜥)、Alinux (阿里云)、Kylin Linux (银河麒麟)、Fedora、Rocky Linux、AlmaLinux、Ubuntu、Debian、CentOS、RHEL、Oracle Linux

✅ 国产操作系统完整支持:深度适配国产操作系统(openEuler、Anolis OS、OpenCloudOS、Alinux、Kylin Linux),支持版本自动识别和最优配置

✅ 多镜像源智能切换:内置阿里云、腾讯云、华为云、中科大、清华等 6+ 国内镜像源,自动检测并选择最快源

✅ 老版本系统特殊处理:支持 Ubuntu 16.04、Debian 9/10 等已过期系统,自动配置兼容的安装方案

✅ 双重安装保障:包管理器安装失败时自动切换到二进制安装,确保安装成功率

✅ macOS/Windows 友好提示:自动检测 macOS 和 Windows 系统,提供适合的 Docker Desktop 安装指引

快速验证 Docker 安装:

# 检查 Docker 版本
docker --version

# 检查 Docker Compose 版本
docker compose version

# 运行测试容器
docker run hello-world

如果上述命令都能正常运行,说明你的 Docker 环境已准备就绪,可以继续部署 Nuwax 服务。

架构图

┌────────────────────────────────────────────────────────────────────────────┐
│ 前端层 (Frontend Layer) │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌─────────────────────────┐ │
│ │ PC端 │ │ H5 │ │ 小程序 │ │ IM (飞书/钉钉/企微) │ │
│ └──────────┘ └──────────┘ └──────────┘ └─────────────────────────┘ │
└────────────────────────────────────────────────────────────────────────────┘
 │
 ▼
┌────────────────────────────────────────────────────────────────────────────┐
│ 接入层 (Access Layer) │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────────────────┐ │
│ │ REST API │ │ 长连接 │ │ WebSocket │ │
│ └──────────────┘ └──────────────┘ └──────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────────────┘
 │
 ▼
┌────────────────────────────────────────────────────────────────────────────┐
│ 应用层 (Application Layer) │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ 组件库 (Component Library) │ │
│ │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │ │
│ │ │ 模型 │ │知识库 │ │数据表 │ │ 插件 │ │工作流 │ │ MCP │ │ 技能 │ │ │
│ │ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ 管理端 (Management Portal) │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────┐ │ │
│ │ │ 用户管理 │ │ 审核管理 │ │公共模型 │ │ 内容管理 │ │任务管理│ │ │
│ │ ├──────────┤ ├──────────┤ ├──────────┤ ├──────────┤ ├──────┤ │ │
│ │ │ 日志查询 │ │ 菜单权限 │ │ 系统配置 │ │ │ │ │ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────┘ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ 产品应用 (Product Applications) │ │
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────────────┐ │ │
│ │ │ 网页应用 │ │ 问答型智能体 │ │ 通用型智能体 │ │ │
│ │ └──────────────┘ └──────────────┘ └──────────────────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────────────┘
 │
 ▼
┌────────────────────────────────────────────────────────────────────────────┐
│ 基础设施层 (Infrastructure Layer) │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ 下层组件 (Lower-level Components) │ │
│ │ │ │
│ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────────┐ │ │
│ │ │ 云端沙箱 │ │ nuwaclaw │ │ 通用智能体引擎 │ │ │
│ │ │ │ │ 个人电脑 │ │ │ │
│ │ │ │ │ 客户端 │ │ ┌───────────────────────┐ │ │
│ │ │ │ │ (mac/win/ │ │ │ MCP 集成 │ │ │
│ │ │ │ │ docker) │ │ ├───────────────────────┤ │ │
│ │ │ │ │ │ │ │ 文件管理 │ │ │
│ │ │ │ │ │ │ │ SKILL 管理 │ │ │
│ │ │ │ │ │ │ │ ACP 适配层 │ │ │
│ │ │ │ │ │ │ │ ┌─────────────────┐ │ │ │
│ │ │ │ │ │ │ │ │ 支持 Agent: │ │ │ │
│ │ │ │ │ │ │ │ │ claudecode │ │ │ │
│ │ │ │ │ │ │ │ │ opencode │ │ │ │
│ │ │ │ │ │ │ │ │ codex │ │ │ │
│ │ │ │ │ │ │ │ │ openclaw │ │ │ │
│ │ │ │ │ │ │ │ │ kimicli │ │ │ │
│ │ │ │ │ │ │ │ └─────────────────┘ │ │ │
│ │ │ │ │ │ │ ├───────────────────────┤ │ │
│ │ │ │ │ │ │ │ 浏览器操作 │ │ │
│ │ │ │ │ │ │ │ GUI 操作 │ │ │
│ │ │ │ │ │ │ │ 网络通道 │ │ │
│ │ │ │ │ │ │ │ 基础运行环境集成 │ │ │
│ │ │ │ │ │ │ └───────────────────────┘ │ │
│ │ └─────────────┘ └─────────────┘ └─────────────────────────────┘ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ 核心基础设施 (Core Infrastructure) │ │
│ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────┐ │ │
│ │ │ Database │ │ Cache │ │ Vector │ │ Search │ │ Model │ │ │
│ │ │ MySQL │ │ Redis │ │ Milvus │ │ Elastic │ │ Proxy│ │ │
│ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────┘ │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────────────────────┘

项目仓库纵览

Nuwax AI 智能体平台由多个相互关联的仓库组成:

前端与移动端

仓库名称 描述 地址
nuwax 前端 Web https://github.com/nuwax-ai/nuwax-mobile
noVNC 基于网页的 VNC 客户端 后端与应用层
仓库名称 描述 地址
nuwax-backend 应用层(后端) 智能体引擎与客户端
仓库名称 描述 地址
nuwaclaw 智能体电脑客户端(mac/win/docker) https://github.com/nuwax-ai/nuwaxcode
claude-code-acp-ts 基于 Zed 的 Claude Code ACP 基础设施与服务
仓库名称 描述 地址
rcoder 沙箱与容器调度(含通用智能体引擎) https://github.com/nuwax-ai/mcp-proxy
nuwax-file-server 文件服务(沙箱和 nuwaclaw 使用,含 skill 同步) 网页应用开发
仓库名称 描述 地址
xagi-frontend-templates 网页应用开发模版 https://github.com/nuwax-ai/vite-plugin-design-mode
dev-inject 网页应用智能脚本注入 插件与脚本执行
仓库名称 描述 地址
run_code_rmcp 插件脚本执行(TS/JS/Python) 网络与工具
仓库名称 描述 地址
lanproxy-go-client 网络穿透客户端(nuwaclaw 使用) Agent Platform Frontend

中文文档 |English Doc

贡献指南
  1. Fork 项目
  2. 创建功能分支
  3. 提交代码变更
  4. 创建 Pull Request

社区与支持

欢迎加入女娲智能体平台社区,获取技术支持和最新动态!

官方地址

社区支持渠道

渠道 说明
GitHub Issues
抖音/视频号 关注获取最新视频内容

📱 微信群、公众号、抖音/视频号二维码 请访问 许可证

Apache 2.0 许可证 - 详见 LICENSE。

成就
409
Star
76
Fork
成员(2)
小飞

AltStyle によって変換されたページ (->オリジナル) /