Skip to content

v1.2.0-beta.1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 17 Jul 15:06
v1.2.0-beta.1
78d0ced
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Highlights

Breaking Changes / Migration Notes

  • AgentTeams naming becomes the public contract: Runtime environment variables, container images, Matrix domains and aliases, Helm defaults, storage paths, Kubernetes resources, and documentation now use AgentTeams naming. Kubernetes APIs move to agentteams.io/v1beta1; deployments upgrading from HiClaw manifests must install the new CRDs and update resource manifests.

  • Team membership is decoupled from inline Workers: Team resources now reference standalone Worker CRs through spec.workerMembers. Existing Team definitions that rely on the previous inline membership shape must be migrated.

  • Fresh-install resource defaults change: New Helm installations use the agentteams- resource prefix, agentteams-storage bucket, and agentteams/ storage root. Selected runtime environment variables and legacy Matrix alias registration retain HiClaw compatibility for migration, but operators should review existing storage and resource names before upgrading.

  • QwenPaw remains a beta runtime: The QwenPaw package, image, Matrix integration, and WorkerFlow / TeamHarness adapters are included for evaluation. v1.2.0-beta.1 keeps the established runtime defaults rather than switching deployments to QwenPaw automatically.

What's New

  • AgentTeams product and runtime contracts: The project completes the public rename from HiClaw to AgentTeams across images, install flows, controller contracts, Helm, runtime environment variables, Matrix configuration, shared storage, scripts, and user-facing documentation.

  • Expanded Worker runtime portfolio: OpenHuman's native-Matrix runtime implementation is included as a source preview, without a published OpenHuman image in this beta. The new QwenPaw package adds runtime configuration updates, MinIO synchronization, heartbeat reporting, Matrix channel integration, container packaging, and focused integration coverage.

  • Plugin platform, TeamHarness, and WorkerFlow: A plugin packaging CLI and schemas are introduced together with TeamHarness collaboration tools, QwenPaw task-trace correlation, WorkerFlow integration, MCP services, prompts, skills, and runtime adapters.

  • Remote and sandbox backend groundwork: Controller-side implementation and tests for Remote and OpenKruise Sandbox / SandboxClaim backends are included as groundwork for later releases. The v1.2.0-beta.1 open-source Helm and CRD surface continues to expose only Local / Edge deployment with the pod backend.

  • Richer Kubernetes resource contracts: Manager, Worker, Team Leader, and Team Worker resources support per-agent resource requests and limits. Team membership moves to standalone Worker references, with conflict detection and coordination-context injection.

  • Matrix AppService and Human SSO: The controller can register as a Matrix Application Service, provision passwordless Matrix identities, process AppService transactions, and resolve SSO-backed Human identities for Team administration and membership.

  • Model routing and LLM preflight: Resources can select a Higress model provider through spec.modelProvider. Helm adds an LLM preflight hook and the hiclaw llm-preflight command to validate the API key, base URL, and model before controller startup.

  • Controller observability and diagnostics: AgentTeams controller metrics, optional Helm ServiceMonitor support, pod container failure reporting, richer status APIs, and expanded integration diagnostics improve production and CI troubleshooting.

Bug Fixes

  • Worker lifecycle correctness: New Workers are no longer misclassified as spec changes; default runtimes are passed to Manager; Team Worker name conflicts are rejected; leader coordination context survives inline AGENTS.md; disabled Manager reconciliation is skipped.

  • Gateway and provider authorization: AI route authorization is serialized, provider-specific authorization remains controller-owned, unsupported gateway port exposure is skipped, and APIG endpoints can be overridden.

  • Open-source deployment boundary: Open-source Worker CRDs are restricted to Local / Edge deployment and the pod backend, and obsolete OSS target-cluster routing is removed. Remote and Sandbox code paths are not exposed as supported v1.2.0-beta.1 deployment options.

  • CoPaw reliability: Runtime path defaults, AgentTeams environment variables, Matrix routing, task assignment name matching, heartbeat defaults, and missing-MinIO-object handling are corrected. Team Leader internal notification preambles are suppressed in Leader DM, while DAG coordination tests retain their Team Room routing assertion with a longer startup-jitter window. (00e67ac)

  • Install and local runtime robustness: Admin usernames are normalized, mounted sockets follow the selected runtime, Podman systemd autostart is supported, Docker Workers receive the host gateway mapping, and manual Worker installation joins the correct network.

  • Helm and CRD compatibility: Unsupported CRD propertyNames fields are removed, AppService environment wiring uses AgentTeams names, and fresh-install storage/resource defaults are aligned with AgentTeams.

  • Pre-release automation: Release workflows accept SemVer pre-release tags, mark GitHub beta releases as prereleases, prevent beta/RC tags from updating stable latest images, publish AgentTeams-owned images under the agentteams registry namespace, skip automatic CoPaw PyPI publishing for prereleases, pin CoPaw 1.0.2 for reproducible beta images, require explicit beta opt-in while keeping Quick Start on the latest stable release, defer automatic QwenPaw image publishing, and retain a legacy local OpenClaw base tag while CI migrates to the AgentTeams image name.

  • AgentTeams rename follow-ups: README legacy-name text is corrected to “formerly HiClaw”; Matrix AppService accepts new #agentteams-* aliases while retaining legacy aliases; OpenHuman consumes canonical AGENTTEAMS_* variables with HiClaw fallbacks.

破坏性变更 / 升级说明

  • AgentTeams 命名成为新的公开契约: 运行时环境变量、容器镜像、Matrix 域名与 alias、Helm 默认值、存储路径、Kubernetes 资源和文档统一使用 AgentTeams 命名。Kubernetes API 迁移到 agentteams.io/v1beta1，从 HiClaw 清单升级时需要安装新 CRD 并更新资源定义。

  • Team 成员与内联 Worker 解耦: Team 通过 spec.workerMembers 引用独立 Worker CR。仍使用旧内联成员结构的 Team 需要迁移。

  • 全新安装的资源默认值变化: Helm 新安装默认使用 agentteams- 资源前缀、agentteams-storage bucket 和 agentteams/ 存储根路径。部分运行时环境变量和旧 Matrix alias 仍保留 HiClaw 兼容，但升级前需要确认现有资源名和存储路径。

  • QwenPaw 仍处于 beta 阶段: 本版本包含 QwenPaw 包、镜像、Matrix 集成以及 WorkerFlow / TeamHarness 适配器，供预览验证；v1.2.0-beta.1 不会自动把现有部署默认运行时切换到 QwenPaw。

新增功能

  • AgentTeams 产品与运行时契约: 完成从 HiClaw 到 AgentTeams 的公开改名，覆盖镜像、安装流程、控制器契约、Helm、运行时环境变量、Matrix 配置、共享存储、脚本和用户文档。

  • 扩展 Worker 运行时: OpenHuman 原生 Matrix 运行时实现作为源码预览包含在本版本中，但本次 beta 不发布 OpenHuman 镜像；新增 QwenPaw 包，支持运行时配置更新、MinIO 同步、心跳上报、Matrix Channel、容器镜像及专项集成测试。

  • 插件平台、TeamHarness 与 WorkerFlow: 新增插件打包 CLI 和 Schema，以及 TeamHarness 协作工具、QwenPaw 任务 Trace 关联、WorkerFlow 集成、MCP 服务、提示词、Skills 和运行时适配器。

  • Remote 与 Sandbox 后端能力储备: 本版本包含 Remote 和 OpenKruise Sandbox / SandboxClaim 的控制器实现与测试，作为后续版本的能力储备；v1.2.0-beta.1 开源 Helm 与 CRD 仍只开放 Local / Edge 部署和 pod 后端。

  • 更完整的 Kubernetes 资源契约: Manager、Worker、Team Leader 和 Team Worker 支持单 Agent 资源规格；Team 成员改为引用独立 Worker CR，并增加冲突检查和协作上下文注入。

  • Matrix AppService 与 Human SSO: 控制器支持注册 Matrix Application Service、无密码创建 Matrix 身份、处理 AppService Transaction，并使用 SSO Human 身份解析 Team 管理员和成员。

  • 模型路由与 LLM 预检: 资源可通过 spec.modelProvider 选择 Higress 模型提供方；Helm 新增 LLM preflight hook 和 hiclaw llm-preflight 命令，在控制器启动前验证 API Key、Base URL 和模型。

  • 控制器可观测性与诊断: 新增 AgentTeams 控制器指标、可选 ServiceMonitor、Pod 容器失败状态、增强的状态 API 和集成测试诊断。

Bug 修复

  • Worker 生命周期正确性: 新建 Worker 不再被误判为 spec 变更；默认运行时会传给 Manager；拒绝 Team Worker 重名；内联 AGENTS.md 不再覆盖 Leader 协作上下文；禁用 Manager 时跳过 Reconcile。

  • 网关与模型提供方鉴权: AI Route 鉴权改为串行执行；provider 专属鉴权保持由控制器 Reconcile 管理；跳过不支持的网关端口暴露；支持覆盖 APIG Endpoint。

  • 开源部署边界: 开源 Worker CRD 限定为 Local / Edge 部署和 pod 后端，并移除无效的 OSS 目标集群路由；Remote 与 Sandbox 代码路径不作为 v1.2.0-beta.1 的公开支持能力。

  • CoPaw 稳定性: 修复运行时路径默认值、AgentTeams 环境变量、Matrix 路由、任务分配名称匹配、心跳默认值和缺失 MinIO 对象处理；拦截 Team Leader 在 Leader DM 中泄漏的内部通知意图，并在保持 Team Room 路由断言不变的前提下延长 DAG 协作测试的启动抖动窗口。(00e67ac)

  • 安装与本地运行稳健性: 管理员用户名统一小写；挂载 Socket 跟随所选容器运行时；支持 Podman systemd 自启动；Docker Worker 注入 host gateway；手动安装 Worker 时加入正确网络。

  • Helm 与 CRD 兼容性: 移除不受支持的 CRD propertyNames；AppService 环境变量切换到 AgentTeams；全新安装的存储和资源默认值完成 AgentTeams 对齐。

  • 预发布自动化: Release 工作流支持 SemVer 预发布 Tag，将 GitHub beta Release 标记为 prerelease，确保 beta / RC Tag 不更新稳定版镜像的 latest，将 AgentTeams 自有镜像发布到 agentteams 镜像命名空间，预发布版本跳过 CoPaw PyPI 自动发布，固定 CoPaw 1.0.2 以保证 beta 镜像可复现，保持 Quick Start 默认安装最新稳定版、beta 仅允许显式选择，暂缓自动发布 QwenPaw 镜像，并在 CI 迁移到 AgentTeams 镜像名期间保留 OpenClaw 基础镜像的旧本地标签。

  • AgentTeams 改名收尾: README 中旧名称修正为“原 HiClaw”；Matrix AppService 同时注册新的 #agentteams-* 和旧 alias；OpenHuman 优先消费 AGENTTEAMS_* 并保留 HiClaw fallback。

Change list by feature / 按功能点整理（15 项）

  • AgentTeams rename and contract alignment / AgentTeams 改名与契约统一: Align images, environment variables, Helm defaults, Matrix aliases, storage paths, Kubernetes resources, scripts, and documentation, while retaining selected migration fallbacks. (a7b707e, e4f4ce6, ef8ec66)
  • Kubernetes API and Team model / Kubernetes API 与 Team 模型: Move APIs to agentteams.io/v1beta1, decouple Team membership from inline Workers, and reference standalone Worker CRs. (862d59e)
  • OpenHuman runtime preview / OpenHuman 运行时预览: Add the native-Matrix OpenHuman Worker source, configuration, and agent template as a preview; no OpenHuman release image is published in this beta. (d2e30c2)
  • QwenPaw runtime / QwenPaw 运行时: Add the QwenPaw package baseline, runtime configuration, storage synchronization, heartbeat, Matrix channel, tests, and Worker image. (8ddb0ef, 5c555c6)
  • Plugin platform / 插件平台: Introduce AgentTeams plugin schemas, packaging, validation, and CLI workflows. (906c0f2, 7af0304)
  • TeamHarness and WorkerFlow / TeamHarness 与 WorkerFlow: Add TeamHarness collaboration tools, QwenPaw task-trace correlation, WorkerFlow adapters, MCP services, prompts, skills, and runtime integration. (04d1d46, de206ab, be7596d)
  • Matrix AppService and Human SSO / Matrix AppService 与 Human SSO: Support passwordless Matrix identity provisioning, AppService transactions, AgentTeams aliases, and SSO-backed Human identity resolution. (0d1e603, 4f62efb, 9ab93fb)
  • Remote backend groundwork / Remote 后端能力储备: Add controller-side remote deployment implementation and tests while keeping the open-source CRD limited to Local / Edge; Remote is not a supported beta1 option. (98b3d9e, af3fd2a, 6f0c7da)
  • Sandbox backend groundwork / Sandbox 后端能力储备: Add internal OpenKruise Sandbox / SandboxClaim implementation and tests while keeping the open-source CRD on the pod backend; Sandbox is not a supported beta1 option. (c39d1b4, 0b562ff)
  • Resource and lifecycle correctness / 资源规格与生命周期正确性: Add per-agent resource requests and limits; fix new-Worker classification, default-runtime propagation, Worker name conflicts, coordination context, and disabled Manager reconciliation. (d2e9e7b, b13f1d9, fbad70f, fb294d7)
  • Model routing and LLM preflight / 模型路由与 LLM 预检: Add spec.modelProvider, preserve controller-owned provider authorization, and validate API key, base URL, and model before startup. (746de8c, b4f00df, 34425c8)
  • Observability and diagnostics / 可观测性与诊断: Add controller metrics, optional ServiceMonitor support, pod container failure reporting, richer status data, and integration diagnostics. (6b03ab0, 295e157)
  • CoPaw and task-flow reliability / CoPaw 与任务流稳定性: Correct runtime paths, AgentTeams environment variables, Matrix routing, task assignment matching, heartbeat defaults, internal Team Leader DM preamble suppression, and missing-object handling. (70ee282, 2202c8c, 03c180f, 1f5e688, 00e67ac)
  • Install, container, and gateway robustness / 安装、容器与网关稳健性: Normalize users, select the correct socket and network, support Podman autostart, configure Docker host gateway access, serialize route authorization, and handle gateway endpoint differences. (6797b76, 28c34f2, de07995, 428d3a1)
  • Helm, CRD, documentation, tests, and CI / Helm、CRD、文档、测试与 CI: Remove unsupported CRD fields, align fresh-install defaults, expand deployment and FAQ guidance, strengthen runtime lifecycle coverage, isolate rename contract checks, and make beta release/tag handling safe in CI. (9552700, 06d75c6, c200631, 1007e6f)

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.0-beta.1

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

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

# 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.0-beta.1

Quick Start

Latest stable (v1.1.2)

macOS / Linux

bash <(curl -fsSL https://raw.githubusercontent.com/agentscope-ai/AgentTeams/v1.1.2/install/hiclaw-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.1.2/install/hiclaw-install.ps1')

Beta preview (v1.2.0-beta.1, explicit opt-in)

macOS / Linux

AGENTTEAMS_VERSION=v1.2.0-beta.1 bash <(curl -fsSL https://raw.githubusercontent.com/agentscope-ai/AgentTeams/v1.2.0-beta.1/install/hiclaw-install.sh)

Windows (PowerShell 7+)

$env:AGENTTEAMS_VERSION='v1.2.0-beta.1'; 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.0-beta.1/install/hiclaw-install.ps1')

Documentation

For more details, see the installation guide.

What's Changed

New Contributors

Full Changelog: v1.1.2...v1.2.0-beta.1

Contributors

xuechaos, flystar32, and 9 other contributors
Assets 4
Loading