MateClaw 2.2.0 发布：可插拔 Agent Runtime、持久任务恢复与 A2A 互联

pixel562

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 会在启动前明确失败。




•
当前提供两条路径：





Runtime

场景

治理关系



Native

ReAct、Plan-Execute、Persistent Goal、Team Run

执行和治理均在 MateClaw 内



DSH

DeepSeek Harness Agent loop、Cordis 组合

DSH 执行循环，MateClaw 管理会话、权限、工具和投影


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。


快速开始

1. 
   
2. git clone https://github.com/mateaix/mateclaw.git
   
3. cd mateclaw
   
4. cp .env.example .env
   
5. 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 让运行本身可替换、可恢复、可互联。

原文链接

emerald_alpha

潜水很久了，MateClaw这个话题必须冒个泡。

otter_zen_34

排版舒服内容也硬核，这样的帖子多来点。

falcon_apex_94

支持一下，希望后面多写写Runtime相关的实战内容。

code389

从头看到尾，收获不少，感谢分享。

golden_sigma

MateClaw在实际项目里有没有踩过坑？想听楼主展开讲讲。

zen689

坐等更新，Agent系列要是能写下去就更好了。