Wegent

🚀 一个开源的 AI 原生操作系统，用于定义、组织和管理智能体团队

英文 | 简体中文

🏗️ 架构概览

graph TB
    subgraph Access["Entry Layer"]
        direction TB
        Web["🌐 Web"]
        IM["💬 IM Tools"]
        API["🔌 API"]
    end

    subgraph Features["Feature Layer"]
        direction TB
        Chat["💬 Chat"]
        Code["💻 Coding"]
        Feed["📡 Feed"]
        Knowledge["📚 Knowledge"]
    end

    subgraph Agents["Agent Layer"]
        direction TB
        ChatShell["🗣️ Wegent Chat"]
        ClaudeCode["🧠 Claude Code"]
        Agno["🤝 Agno"]
        Dify["✨ Dify"]
    end

    subgraph Execution["Execution Environment"]
        direction TB
        Docker["🐳 Agent Sandbox"]
        Cloud["☁️ Cloud Device"]
        Local["💻 Local Device"]
    end

    Access --> Features
    Features --> Agents
    Agents --> Execution

✨ 核心功能

💬 聊天智能体

• 多模型支持：兼容 Claude、OpenAI、Gemini、DeepSeek、GLM 等主流模型
• 对话历史：创建新对话、多轮对话、保存和分享聊天记录
• 群聊：AI 群聊，AI 根据对话上下文响应并支持 @提及
• 附件解析：在单聊/群聊中发送 txt、pdf、ppt、doc、图片等文件格式
• 追问模式：AI 提出澄清性问题以帮助完善您的需求
• 纠错模式：多个 AI 模型自动检测并纠正回复错误
• 长期记忆：支持 mem0 (对话持久化存储) 集成以实现对话记忆持久化
• 沙箱执行：通过沙箱执行命令或修改文件，兼容 E2B (协议)
• 扩展：自定义提示词、MCP (模型上下文协议) 工具和 Skills (技能)（包含绘图技能）

💻 代码智能体

基于云端的 Claude Code 执行引擎：

• 多模型配置：配置各种兼容 Claude 的模型
• 并发执行：在云端同时运行多个编码任务
• 需求澄清：AI 分析代码并提出问题以生成规范文档
• Git 集成：与 GitHub/GitLab/Gitea/Gerrit 集成以克隆、修改和创建拉取请求 (PR)
• MCP/Skills 支持：为智能体配置 MCP 工具和 Skills
• 多轮对话：通过后续问题继续对话

📡 AI 信息流

基于云的 AI 任务触发系统：

• 完整能力访问：任务可使用聊天模式和代码模式的所有能力
• 定时/事件触发：设置 cron 调度或基于事件的 AI 任务执行
• 信息流展示：将 AI 生成的内容作为信息流显示
• 事件过滤：过滤条件如“仅在我明天会下雨时通知我”

📚 AI 知识库

基于云的 AI 文档仓库：

• 文档管理：上传和管理 txt/doc/ppt/xls 等文档格式
• 网页导入：导入网页和钉钉多维表格
• NotebookLM 模式：直接在笔记本中选择文档进行问答
• 在线编辑：在笔记本模式下直接编辑文本文件
• 聊天集成：在单聊/群聊中引用知识库以供 AI 响应

🖥️ AI 设备

在您的本地机器上运行 AI 任务并拥有完全控制权：

• 本地执行器：在自己的设备上安装并运行 Wegent 执行器
• 多设备管理：注册和管理多个本地设备
• 默认设备：设置首选设备以快速执行任务
• 安全连接：通过经过身份验证的 WebSocket (网络套接字) 连接到 Wegent 后端

💬 IM 集成

将 AI 智能体集成到您喜欢的 IM 工具中：

• 钉钉机器人：将智能体部署为钉钉机器人以进行团队协作
• Telegram 机器人：将智能体连接到 Telegram 进行个人或群聊

🔧 自定义

以上所有功能均可完全自定义：

• 自定义智能体：在 Web UI 中创建自定义智能体，配置提示词、MCP、Skills 和多智能体协作
• 智能体创建向导：4 步创建：描述需求 → AI 提问 → 实时微调 → 一键创建
• 组织管理：创建和加入群组，在群组内共享智能体、模型和 Skills

🔧 扩展性

• 智能体创建向导：4 步创建：描述需求 → AI 提问 → 实时微调 → 一键创建
• 协作模式：4 种开箱即用的多智能体协作模式（顺序/并行/路由/循环）
• 技能支持：动态加载技能包以提高 Token (消耗量) 效率
• MCP 工具：模型上下文协议，用于调用外部工具和服务
• 执行引擎：ClaudeCode / Agno 沙箱隔离，Dify API 代理，聊天直连模式
• YAML 配置：Kubernetes 风格的 CRD (自定义资源定义)，用于定义 Ghost / Bot / Team / Skill
• API：OpenAI 兼容接口，便于与其他系统集成

🚀 快速开始

一键启动：

curl -fsSL https://raw.githubusercontent.com/wecode-ai/Wegent/main/install.sh | bash

然后在浏览器中打开 http://localhost:3000。

其他部署选项

# 标准模式（多容器，含 MySQL）
curl -fsSL https://raw.githubusercontent.com/wecode-ai/Wegent/main/install.sh | bash -s -- --standard

# 开发模式（源码构建，支持热重载）
git clone https://github.com/wecode-ai/Wegent.git && cd Wegent && ./start.sh

# 独立模式（单容器）
docker logs -f wegent-standalone      # 查看日志
docker stop wegent-standalone         # 停止
docker start wegent-standalone        # 启动
docker restart wegent-standalone      # 重启

# 标准模式（多容器）
docker compose logs -f   # 查看日志
docker compose down      # 停止
docker compose up -d     # 启动

# 开发模式
./start.sh --status      # 检查状态
./start.sh --stop        # 停止
./start.sh --restart     # 重启

📖 详见 独立模式文档。

📦 内置智能体 (Agents)

🤝 贡献

我们欢迎贡献！详情请参阅我们的 贡献指南。

📞 支持

• 🐛 问题反馈：GitHub Issues
• 💬 Discord：加入我们的社区

👥 贡献者

感谢以下开发者为改进本项目所做出的贡献和努力。💪

Axb	Feifei	MicroLee	YaFei Liu	FicoHu	Yanhe	Johnny0120	Yi Xiang
Joyway78	Parabala	Icycrystal4	Moqimoqidea	Xuemin	Fengkuizhi	Kerwin Bryant	Just Quan
Junbaor	Fingki	Li Daiyan	Sense_wang	Jolestar	Erdawang	Jake Zhang	Jasper Zhong
Ray	RichardoMu	_	Andrewzq777	Graindt	Qingcheng	Salt-hai	wxcfox

由 WeCode-AI 团队用心制作 ❤️

Wegent 快速上手指南

🚀 Wegent 是一个开源的 AI 原生操作系统，用于定义、组织和运行智能体团队。

🛠️ 环境准备

• 操作系统: Linux / macOS / Windows (建议 WSL2)
• 核心依赖: Docker & Docker Compose
• 网络环境: 需能访问 GitHub 仓库及外部 AI 模型 API 服务

📦 安装步骤

1. 一键部署 (Standalone 模式)

默认模式，单容器运行，内置 SQLite，适合快速体验和大多数用户。

curl -fsSL https://raw.githubusercontent.com/wecode-ai/Wegent/main/install.sh | bash

2. 其他部署选项

• 标准模式 (Standard)：多容器架构，使用 MySQL，适合生产环境。

  curl -fsSL https://raw.githubusercontent.com/wecode-ai/Wegent/main/install.sh | bash -s -- --standard
  

• 开发模式 (Development)：从源码启动，支持热重载。

  git clone https://github.com/wecode-ai/Wegent.git && cd Wegent && ./start.sh
  

3. 常用管理命令

# Standalone 模式
docker logs -f wegent-standalone      # 查看日志
docker stop wegent-standalone         # 停止
docker start wegent-standalone        # 启动
docker restart wegent-standalone      # 重启

# 标准模式 (Docker Compose)
docker compose logs -f                # 查看日志
docker compose down                   # 停止
docker compose up -d                  # 启动

💻 基本使用

1. 启动服务：安装完成后，在浏览器访问 http://localhost:3000。
2. 体验内置智能体：系统预置了多个团队智能体，开箱即用：
   • chat-team: 通用 AI 助手 + Mermaid 图表生成
   • translator: 多语言翻译
   • dev-team: Git 工作流自动化 (分支 → 代码 → 提交 → PR)
   • wiki-team: 代码库 Wiki 文档生成
3. 核心功能：
   • Chat Agent: 支持多模型对话、文件解析、群聊及沙箱执行。
   • Code Agent: 云端代码执行引擎，支持 Git 集成与需求澄清。
   • AI Feed: 基于 Cron 或事件触发的 AI 任务流。
   • IM 集成: 支持接入钉钉机器人或 Telegram Bot。
4. 自定义扩展：通过 Web UI 可创建自定义 Agent，配置 Prompt、MCP Tools 及 Skills，支持多智能体协作模式。

更多详细文档请查阅 Wegent 官方文档