AgentTeams

把 AI 智能体拉进群聊干活，人类随时围观插话

开源 freemium 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 5731

维护状态活跃

是否开源是

定价模式 freemium

项目预览

项目数据

分类智能体

开发团队agentscope-ai

所属国家

官网地址https://www.aliyun.com/product/agentteams

GitHubhttps://github.com/agentscope-ai/AgentTeams

定价模式freemium

价格说明开源免费，阿里云托管服务按量付费，定价信息待确认

访问状态

是否开源是

开源协议Apache-2.0

主要语言Go

技术栈/模型agent-teams,openclaw

GitHub 星标★ 5731

30天Star增速

HF 下载量

上线时间2026-02-21 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-12

浏览次数0

项目介绍

AgentTeams 是一个用 Go 编写的开源协作式多智能体操作系统，核心思路是把每个 AI 智能体放进 Matrix 聊天室里，让它们像团队成员一样在群聊中分工、讨论和推进任务。它要解决的问题是：当前多智能体框架大多是黑盒流水线，人类很难看清智能体之间在做什么、也无法在关键节点介入。AgentTeams 借助 Matrix 协议把任务协调过程完全透明化，所有消息、决策和交接都留在房间记录里，人类可以随时旁观、插话、纠正或批准，实现 human-in-the-loop 的协作模式。它提供智能体注册与角色分配、房间级任务编排、跨智能体消息传递、人工审批节点等能力，适合需要可审计、可干预的多智能体工作流。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：Docker 5 步

环境要求

Docker Desktop（Windows/macOS）或 Docker Engine（Linux）
最低资源：2 核 CPU + 4 GB 内存；运行多个 Worker 建议 4 核 + 8 GB
Windows 建议使用 PowerShell 7+
如需 Kubernetes 部署：Kubernetes 1.24+、Helm 3.7+，并具备默认 StorageClass

安装与启动步骤

1准备 Docker 环境

先确认本机已安装并启动 Docker Desktop 或 Docker Engine，并预留至少 2 核 4 GB 资源。
2macOS/Linux 一键安装

在终端执行官方安装脚本，脚本会下载并启动 Manager、Workers 等容器，需保持网络畅通。
```
bash <(curl -sSL https://raw.githubusercontent.com/agentscope-ai/AgentTeams/main/install/agentteams-install.sh)
```

3Windows 一键安装

在 PowerShell 7+ 中执行脚本下载并直接运行，Set-ExecutionPolicy Bypass 仅对当前进程生效，不影响系统策略。

Set-ExecutionPolicy Bypass -Scope Process -Force; $wc=New-Object Net.WebClient; $wc.Encoding=[Text.Encoding]::UTF8; iex $wc.DownloadString('https://raw.githubusercontent.com/agentscope-ai/AgentTeams/main/install/agentteams-install.ps1')

4跟随安装向导配置

依次选择 LLM 提供商（支持 OpenAI 兼容 API）、填入 API key、选择网络模式（仅本地或外部访问），然后等待安装完成。

5Kubernetes 部署（可选）

共享或生产环境可用 Helm 安装，默认包含 Higress AI 网关、Tuwunel(Matrix)、MinIO 与控制器，无需外部依赖。

helm repo add higress.io https://higress.io/helm-charts
helm repo update
helm install agentteams higress.io/agentteams -n agentteams-system --create-namespace --render-subchart-notes --set credentials.llmApiKey=sk-xxxxxxxx --set credentials.adminPassword=YourAdminPass123 --set gateway.publicURL=http://localhost:18080

关键配置

配置项	必填	说明	示例
`credentials.llmApiKey`	是	LLM 提供商的 API Key，Helm 部署必填	`sk-xxxxxxxx`
`gateway.publicURL`	是	用户访问 Element Web 的公开地址，端口转发用 localhost 地址	`http://localhost:18080`
`credentials.adminPassword`	否	Matrix 管理员密码，留空则自动生成并需从 Secret 读取	`YourAdminPass123`
`credentials.llmProvider`	否	LLM 提供商名称，默认 openai-compat	`qwen`
`credentials.defaultModel`	否	默认模型，默认值为 gpt-5.4	`qwen3.5-plus`
`credentials.llmBaseUrl`	否	OpenAI 兼容的 base URL，官方 OpenAI 可留空	`https://api.deepseek.com/v1`

如何确认成功

向导执行完成且无报错即安装成功；可通过 Docker 确认 Manager、Workers、docker-proxy 容器已创建，K8s 部署查看 agentteams-system 命名空间下的 Pod。

常见问题

Q：机器资源不够会怎样？

A：最低需要 2 核 CPU + 4 GB 内存；如果要跑多个 Worker，建议 4 核 + 8 GB，否则容器可能启动失败或运行缓慢。

Q：能接非 OpenAI 的模型吗？

A：可以。安装向导支持选择 OpenAI 兼容 API 的提供商；Helm 部署时通过 credentials.llmBaseUrl 与 credentials.defaultModel 指定自定义地址和模型。

Q：Windows 上脚本无法执行怎么办？

A：建议使用 PowerShell 7+，并按文档用 Set-ExecutionPolicy Bypass -Scope Process -Force 仅在当前进程绕过执行策略后再运行安装脚本。

Q：如何卸载 AgentTeams？

A：macOS/Linux 执行安装脚本并追加 uninstall 参数；Windows 用相同脚本内容以 uninstall 参数运行，会删除所有容器、卷、网络、env 文件与 workspace。

Q：Helm 安装时 LLM 预检失败怎么办？

A：预检会先发起一次 /chat/completions 请求校验 Key、地址与模型；受限或离线集群可加 --set preflight.llm.enabled=false 跳过。

注意事项

卸载会清空 Docker volume、网络、env 文件与 workspace 目录，操作前请确认数据已备份。
在中国大陆以外部署时，可将镜像仓库切换到就近区域（如北美 higress-registry.us-west-1.cr.aliyuncs.com）以加快拉取。
Helm 安装默认执行 LLM 预检，invalid key、地址不可达、模型不支持等都会直接让安装失败。
选择 CoPaw Manager 时需同时设置 manager.runtime=qwenpaw 与对应的 agentteams-manager-qwenpaw 镜像。

核心亮点

基于 Matrix 开放协议，任务全过程可追溯、可审计，人类能在任意环节介入
用聊天室做任务协调，智能体分工和交接直观可见，比黑盒流水线更易调试
Go 编写，部署为单个二进制，资源占用低，适合自托管

不足之处

依赖 Matrix 服务端，首次部署需要额外搭建 homeserver，上手门槛偏高
项目较新，生态集成和文档完善度仍在早期阶段

适用场景

多智能体协作完成软件开发任务，人类在关键节点审批代码
企业内需要留痕和人工复核的自动化流程编排
研究者观察和调试多智能体之间的对话与决策过程

替代项目

AutoGen、CrewAI

上一篇：mcp_agent_mail

下一篇：DataAgent