MateClaw 2.2.0 稳定版已于 2026 年 8 月 29 日发布。本次版本将员工身份与执行引擎解耦，引入 Native / DeepSeek Harness 双运行时、可跨请求与后端重启恢复的 Persistent Goal，以及双向 A2A 能力；同时继续加固 2.1.0 引入的 Team Run、交付物完成门与工作空间边界。

MateClaw 是一个基于 Spring Boot 的开源 AI Agent 平台，提供数字员工、Agent Teams、Goal、LLM Wiki、记忆、Tool / Skill / MCP / ACP、工作流、触发器、多渠道接入、权限审批和审计能力。项目采用 Apache License 2.0，支持自托管。

从 2.1 到 2.2

• v2.1.0 于 2026 年 8 月 15 日发布，主要完成：

• 统一 Team Run：一个 runId 关联目标、任务 DAG、成员执行、最终汇总与交付物，Chat / Agents / Teams 消费同一份服务端投影；

• Skill 自进化闭环：routine mining、reflection、受约束自动绑定、curator、snapshot 与 restore point；

• 可回放推理轨迹：实时提取 ``、按执行顺序持久化、真实耗时显示和 trajectory 导出；

• 主动渠道投递：员工可向已建立的渠道会话主动推送，Cron 保存明确的投递渠道和目标；

• 执行可靠性：单模型上下文窗口、渐进式工具桥、行动完成门、浏览器与流式链路加固。

• v2.2.0 在此基础上继续重构运行层，主线可概括为：Runtime 可替换、Goal 可恢复、Agent 可互联。

1. Agent Runtime Contract

2.2.0 新增 AgentRuntimeProvider 扩展层。Runtime 负责启动员工执行并输出统一事件流；MateClaw 继续负责员工身份、会话和消息持久化、工作空间解析、工具清单、Tool Guard、审批、流式投影与生命周期语义。

Provider 通过 registry 选择，session 在启动前验证配置、能力和工作空间边界。未知或不可用的 Runtime 会在启动前明确失败。

• 当前提供两条路径：

2. DeepSeek Harness 受管理接入

DSH 在 MateClaw 中是员工级 Runtime，不是 MCP 工具或模型 Provider。系统通过认证 JSON-RPC 子进程管理 dsh-jsonrpc-agent，把 thinking、text、tool 与 lifecycle 事件映射为现有聊天流。

• 本版包含：

• process / session 隔离、取消和完整 stream 生命周期；

• 认证 bridge protocol 与事件映射；

• 宿主工具描述投影，工具调用回到 MateClaw 并经过工作空间策略和 Tool Guard；

• DeepSeek 凭证安全注入；

• 管理页安装、配置、校验、连接测试和启停；

• 子进程受控环境变量隔离。

DSH 为可选 Runtime，未安装时不影响 Native 员工。

3. Persistent Goal 跨请求与重启恢复

新目标默认启用 persistentExecution。长任务被拆成有界 segment，segment 结束不代表目标结束，supervisor 会根据数据库中的持久状态安排后续执行。

• 新增能力包括：

• continuation queue、冷却、重试和过期 lease 回收；

• goal attempt、单目标运行协调和启动恢复；

• 会话级持久输入队列；

• Provider 临时故障退避和实例级节流；

• Stop、缺少输入、审批拒绝、预算耗尽等显式暂停；

• 基于 checklist 和非空证据的完成门。

当前实现面向单后端实例的 Native Runtime。系统可恢复执行状态，但对外部 API、Shell 等工具副作用不保证 exactly-once，生产任务仍需使用幂等键、产物检查或人工确认。

4. A2A 入站与出站

• 2.2.0 支持 A2A 双向互联：

• 入站：message/send、message/stream、tasks/get、tasks/cancel；

• SSE：任务状态、artifact 与 heartbeat；

• 出站：call_a2a_agent 发现 Agent Card、发送任务并轮询或解析 SSE；

• 安全：Bearer 认证、最小匿名 Agent Card、请求幂等快照、终态 TTL 与容量上限；

• 出站边界：默认拒绝重定向与私网地址，限制超时和响应体大小。

A2A 默认关闭，对外开放前需要配置 public base URL、认证与出站网络策略。

5. Team Run 与工作空间边界加固

• checkpoint loop 和任务板恢复改为幂等；

• 必需交付物全部登记完成后才允许任务与整轮运行完成；

• Lead 附件传给 worker，worker 生成文件自动登记为交付物；

• 澄清式回复不再误判为最终成果；

• 失败重试保留必要上下文；

• Live 管理视图、共享会话、生成文件、文件写入与 Wiki 故障记录补齐工作空间归属校验；

• 长篇回答、审批、停止、恢复和 returnDirect 链路进一步加固。

6. 其他更新

• 可选 OfficeCLI 引擎支持 .docx、.xlsx、.pptx 的 inspect、validate、batch edit、merge 与 preview；

• ACP 自定义端点支持 prompt timeout；

• 插件工具显示在员工工具选择器；

• 微信渠道增加执行轨迹显示开关；

• 自定义模型 Provider 恢复、聊天状态重建与 Agents Live 加载提速。

升级说明

2.2.0 保持 2.1.0 数据兼容。Flyway 会按数据库方言应用 V185—V189，包含 OfficeCLI 注册、员工 Runtime Provider、ACP prompt timeout、Goal continuation、Goal attempt 和 conversation input queue。

• 升级时建议注意：

1. 新目标默认持久执行，生产环境建议显式设置预算、并发和 Provider failure backoff；旧目标不会自动启动。

2. DSH 和 OfficeCLI 都是可选能力，未安装不影响原有 Native Runtime 与 JVM 文档工具。

3. A2A 默认关闭，启用前应配置认证和网络边界。

4. 恢复执行不等于外部副作用 exactly-once。

快速开始

git clone https://github.com/mateaix/mateclaw.git
cd mateclaw
cp .env.example .env
docker compose up -d

浏览器访问 http://localhost:18080。默认账号 admin，默认密码 admin123，正式部署前请修改。

相关链接

• GitHub：

  https://github.com/mateaix/mateclaw

• v2.2.0 发布说明：

  https://claw.mate.vip/docs/zh/releases/2.2.0

• v2.1.0 发布说明：

  https://claw.mate.vip/docs/zh/releases/2.1.0

• 在线文档：

  https://claw.mate.vip/docs

• 在线演示：

  https://claw-demo.mate.vip

• 太一企业版：

  https://mate.vip/enterprise/

• 开源协议：Apache License 2.0

• MateClaw 2.2.0 的主题可以概括为一句话：2.1 让协作成为一份运行，2.2 让运行本身可替换、可恢复、可互联。