github agentscope-ai/AgentTeams v1.2.4
on GitHub

3 hours ago

AgentTeams 1.2.4 Release Notes

AgentTeams 1.2.4 重点完善团队协作的任务状态、运行时管理和权限控制，升级 QwenPaw 运行时，并修复本地部署、升级及 Worker 启动中的多项问题。

新增与增强

更清晰的任务进度与执行记录

  • TeamHarness 新增任务状态转换机制，记录状态历史、事件和进度，便于追踪任务执行过程。
  • 持久化任务续执行状态，保留跨轮次执行所需的信息；任务提交时由代码发送完成通知，减少对模型主动汇报的依赖。
  • 新增 Mermaid 工作流渲染和任务级检查 API，支持查看任务规格、状态转换及执行信息。
  • Worker 心跳上报运行时任务状态，项目列表增加更新时间。

相关变更：#1233、#1183、#1206、#1230、#1247。

更完整的 QwenPaw 运行时管理

  • Manager 与 Worker 升级至 QwenPaw 2.2.1，并向 Worker 传递模型能力配置。
  • 新增子 Agent 独立模型配置，支持团队默认值和运行时热更新；配置修改受管理员权限控制。
  • 新增 Worker 会话列表、详情和运行状态的只读代理接口，便于管理端查看会话执行情况。
  • 扩展运行时配置、循环状态、频道配置与冲突检查、内置工具设置、技能运行状态及预加载策略等管理接口。

相关变更：#1294、#1295、#1219、#1255、#1252。

团队权限与审计

  • 完善 L2 权限能力模型，支持团队范围内的 Worker 技能更新和工具审批操作。
  • 将 L2 用户与 Team Leader 的 Worker 修改范围限制在非敏感字段；关闭审批需要额外的审批策略权限。
  • 支持为 Human 分配指定 Worker 的只读访问权限。
  • 新增 Human 更新接口及只读审计查询接口，记录 Human 访问范围的创建、修改和删除。

相关变更：#1237、#1274、#1273、#1277、#1278、#1270。

技能与资源目录

  • 新增团队技能目录、权限控制下的技能上传及分配时物化能力。
  • 技能目录支持插件自带技能，补充模型和部署级 MCP Server 的只读目录接口。
  • 新增团队范围内的知识库文件管理接口，为管理端集成提供基础能力。

相关变更：#1238、#1267、#1211、#1242、#1250、#1208。

消息协作与实验性运行时

  • 新增群聊按发送者隔离会话的配置能力，并在发送前检查回复是否已因新消息而过时。
  • 新增实验性 DeepSeek Harness Worker 运行时，接入 Matrix 消息及 TeamHarness 协作体系；配套独立镜像版本为 v0.1.0。

相关变更：#1235、#1249、#1204。

Dashboard v1.2.4.9

  • 默认 Dashboard 更新至 v1.2.4.9，提供知识库与 Worker 记忆浏览、关联图谱、项目看板及干预操作。
  • 增强集中化技能管理、Nacos 同步、AI 网关模型和路由配置。
  • 改进聊天线程、消息编辑、已读回执和流式展示；加强服务端权限校验、审计及敏感信息过滤。

相关变更：#1298。

修复与稳定性

  • 修复 CoPaw 状态文件上传失败后未重试的问题，保留未成功同步文件以供下一轮重试（#1300）。

  • 修复创建 Worker 时模型缺失或为空未使用部署默认模型的问题，并修复 QwenPaw 工作区代理路径，恢复知识库文件读取（#1296）。

  • 修复 QwenPaw Driver 重载覆盖并发策略更新的问题；修正 TeamHarness 已接受任务的验收判断，增加实际产物内容检查（#1299）。

  • 安装器自动选择稳定版本时检查所需镜像及当前架构；仅在明确缺失且验证通过时整套回退 v1.2.3。网络/鉴权错误及升级流程不自动降级，显式版本行为不变（#1297）。

  • 修复 OpenClaw 构建期间 pnpm 可执行文件类型不匹配的问题，将 pnpm 固定到对应版本。

  • 修复嵌入式镜像遗漏 Worker 技能及停止状态显示不正确的问题。

  • 修复升级时未从已有环境配置读回数据卷的问题。

  • 修复 Kubernetes 环境下 CoPaw / QwenPaw 静态 MinIO 凭证初始化问题。

  • 延长 Worker MCP 工具启动等待窗口，并补充上游 5xx 错误信息，改善启动稳定性和故障定位。

  • QwenPaw 启动时禁用示例 Agent 失败不再阻断启动。

  • 修复 NFS 工作目录下复制文件时保留所有权导致的失败，以及嵌入式 AI Gateway 地址被覆盖的问题。

  • 修复团队 Human 在 Manager / 项目房间中的访问白名单、入房权限及 checkpoint 范围校验问题。

  • 项目仍有未终结任务时拒绝完成项目，避免项目被提前标记为完成。

  • 自动分配的 Worker Console 端口绑定到本机回环地址；MCP 网关凭证仅附加到受信任的网关主机。

  • 调整镜像并行构建与发布门禁，发布前检查所需镜像完整性。

相关变更：#1290、#1291、#1281、#1257、#1280、#1259、#1271、#1287、#1272、#1196。

使用说明

  • Agent 启动后、Matrix 初始同步完成前发送的消息可能被跳过，请等待就绪后再分配任务。

  • DeepSeek Harness 双架构镜像已交付，但本次未完成真实 DeepSeek 模型的端到端验证。

  • DeepSeek Harness 为实验性 Worker 运行时，使用独立镜像版本，当前不支持 Matrix 端到端加密房间。

  • 新增管理 API 不代表所有 Dashboard 页面已完成适配；Dashboard 独立发布，应按部署组合进行验证。

  • 任务续执行状态持久化不等同于完整的自动故障恢复，不承诺任务在所有异常下自动恢复执行。

完整变更范围：v1.2.3…v1.2.4。

What's Changed

  • fix(copaw): pin mcp below 2.0.0 in copaw-worker by @LUOSENGWA in #1215
  • feat: add experimental DeepSeek Harness worker runtime by @jesseedcp in #1204
  • fix(controller): checkpoint proxy scoped check compared member name as team name by @LUOSENGWA in #1214
  • docs: add v1.2.3 news entries by @shiyiyue1102 in #1227
  • feat(controller): allow L2 humans to update worker skills within their teams by @LUOSENGWA in #1212
  • feat(controller): mermaid workflow rendering + task-level inspection API by @LUOSENGWA in #1230
  • fix(controller): allow clearing Manager model provider by @shiyiyue1102 in #1232
  • feat(controller): add human update endpoint (PUT /api/v1/humans/{name}) by @LUOSENGWA in #1209
  • fix(controller): preserve embedded AI gateway URL by @shenjiecode in #1188
  • fix(copaw): configure static MinIO alias in Kubernetes by @shiyiyue1102 in #1228
  • feat(controller): add team-scoped worker knowledge base file endpoints (+ checkpoint scoped-access fix) by @LUOSENGWA in #1208
  • fix(release): wait for versioned images by @shiyiyue1102 in #1196
  • feat(controller): add team-scoped worker tool approval endpoints for L2 humans by @LUOSENGWA in #1216
  • fix(manager): avoid cp -a preserve ownership failure on NFS workspaces by @LUOSENGWA in #1163
  • fix(controller): grant Matrix power levels to human members on room join by @LUOSENGWA in #1210
  • feat(teamharness): persist durable task continuation state by @jesseedcp in #1183
  • feat(controller): add read-only skill catalog endpoint for workbench by @LUOSENGWA in #1211
  • feat(taskflow): emit code-level completion notification on task submission by @LUOSENGWA in #1206
  • feat(manager): upgrade Manager runtime to QwenPaw 2.2 by @LUOSENGWA in #1175
  • feat(qwenpaw): upgrade QwenPaw Worker runtime to 2.2.1 by @LUOSENGWA in #1174
  • fix(qwenpaw): propagate model capabilities to QwenPaw worker by @LUOSENGWA in #1158
  • feat(controller): add team-scoped QwenPaw worker runtime-config proxy + loop-change notification by @LUOSENGWA in #1231
  • fix(controller): forward the loops/status session selectors by @LUOSENGWA in #1253
  • feat(controller): proxy per-worker skill runtime state and preload policy by @LUOSENGWA in #1252
  • feat(matrix): group sender session isolation via share_session_in_group by @LUOSENGWA in #1235
  • feat(controller): capability foundation for the L2 permission model (#1220) by @LUOSENGWA in #1237
  • feat(controller): add worker channel configuration proxy endpoints by @LUOSENGWA in #1219
  • fix(controller): include team humans in the Manager channel allowlist by @LUOSENGWA in #1243
  • docs: add Higress gateway external API reference by @LUOSENGWA in #1125
  • feat(controller): GET /api/v1/mcp-servers — deployment-level MCP catalog by @LUOSENGWA in #1250
  • feat(controller): add read-only model list endpoint (GET /api/v1/models) by @LUOSENGWA in #1242
  • feat(controller): expose runtime task status from worker heartbeats by @LUOSENGWA in #1247
  • feat(controller): proxy worker built-in tool settings endpoints by @LUOSENGWA in #1255
  • feat(matrix-channel): send alignment gate for stale replies by @LUOSENGWA in #1249
  • fix(project-management): add granted humans to the project room allowlists by @LUOSENGWA in #1266
  • feat(teamharness): task state transition engine (table + history + events + progress) by @LUOSENGWA in #1233
  • feat(controller): add team-skill catalog, gated upload, and materialize-at-assign by @LUOSENGWA in #1238
  • feat(controller): proxy the worker channel conflict-check endpoint by @LUOSENGWA in #1269
  • feat(controller): add plugin-bundled skills as third catalog source by @LUOSENGWA in #1267
  • feat(controller): add read-only audit events query endpoint (GET /api/v1/audit) by @LUOSENGWA in #1270
  • test(worker): pin the native Matrix roster ACL (coordinator humans + worker detach) by @LUOSENGWA in #1268
  • feat(controller): gate approval_level=OFF behind the approval_policy capability by @LUOSENGWA in #1273
  • ci: slim integration matrix and retire standalone CoPaw regression by @shiyiyue1102 in #1282
  • feat(controller): attach MCP gateway credential only to trusted gateway hosts by @LUOSENGWA in #1272
  • feat(controller): scope worker writes to non-sensitive fields for L2 humans and team leaders by @LUOSENGWA in #1274
  • fix(backend): bind automatic worker console ports to loopback (HostIP) by @Shuuyou in #1287
  • feat(controller): split the worker channel write surface and make the MinIO read-back async by @LUOSENGWA in #1276
  • fix(copaw): refuse complete_project while project tasks are not terminal by @dchaudhari7177 in #1271
  • fix(ci): retire the stale copaw runtime mapping assertion (#1282 follow-up) by @LUOSENGWA in #1288
  • feat(server): expose updated_at in project list summaries by @LUOSENGWA in #1289
  • fix(worker): widen MCP tools startup window and surface 5xx error bodies by @LUOSENGWA in #1280
  • feat(controller): audit human scope changes on create/update/delete by @LUOSENGWA in #1278
  • chore: replace internal identity fixtures with neutral test names by @LUOSENGWA in #1279
  • fix(qwenpaw): initialize static MinIO credentials in Kubernetes by @shiyiyue1102 in #1257
  • fix(installer): read data volume back from env on upgrade by @LUOSENGWA in #1281
  • feat(controller): grant worker-scoped humans read-only access to their assigned workers by @LUOSENGWA in #1277
  • fix(embedded): package worker skills and correct stopped worker status by @shiyiyue1102 in #1291
  • fix(build): pin pnpm to the OpenClaw package manager version by @shiyiyue1102 in #1290
  • feat(controller): subagent model routing — declare, team default, hot-apply, L1-only API by @LUOSENGWA in #1294
  • feat(controller): read-only worker chats proxy for session visibility by @LUOSENGWA in #1295
  • fix(qwenpaw): make demo-agent disable non-fatal during startup by @ChestonGu in #1259
  • fix(controller): probe the worker backend before ensure-ready reports Ready by @dchaudhari7177 in #1275
  • fix(controller): default worker models and correct workspace API paths by @shiyiyue1102 in #1296
  • fix(installer): check required platform images before automatic version selection by @shiyiyue1102 in #1297
  • fix(qwenpaw): preserve policy during reload and correct TeamHarness acceptance by @shiyiyue1102 in #1299
  • chore(install): bump default dashboard version to v1.2.4.9 by @nillikechatchat in #1298
  • fix(copaw): retry runtime files after failed persistence by @shiyiyue1102 in #1300

New Contributors

Full Changelog: v1.2.3...v1.2.4

Docker Images

Multi-architecture images (amd64 + arm64): 

# Embedded all-in-one (infra + controller; pulled by the installer)
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/agentteams/agentteams-embedded:v1.2.4

# Manager (lightweight; spawned by the embedded controller)
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/agentteams/agentteams-manager:v1.2.4

# Worker
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/agentteams/agentteams-worker:v1.2.4

# QwenPaw Worker
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/agentteams/agentteams-qwenpaw-worker:v1.2.4

# DeepSeek Harness Worker (experimental)
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/agentteams/agentteams-deepseek-harness-worker:v0.1.0

# Controller (used standalone in k8s; bundled inside agentteams-embedded for docker installs)
docker pull higress-registry.cn-hangzhou.cr.aliyuncs.com/agentteams/agentteams-controller:v1.2.4

Quick Start

Latest stable (v1.2.4)

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/agentscope-ai/AgentTeams/v1.2.4/install/agentteams-install.sh)

Windows (PowerShell 7+)

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/v1.2.4/install/agentteams-install.ps1')

Documentation

For more details, see the installation guide.

Check out latest releases or
releases around agentscope-ai/AgentTeams v1.2.4

Don't miss a new AgentTeams release

NewReleases is sending notifications on new releases.

Get notifications