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场景治理关系NativeReAct、Plan-Execute、Persistent Goal、Team Run执行和治理均在 MateClaw 内DSHDeepSeek 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链路进一步加固。
可选 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。
新目标默认持久执行，生产环境建议显式设置预算、并发和 Provider failure backoff；旧目标不会自动启动。DSH 和 OfficeCLI 都是可选能力，未安装不影响原有 Native Runtime 与 JVM 文档助手。A2A 默认关闭，启用前应配置认证和网络边界。恢复执行不等于外部副作用 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/mateclawv2.2.0 上线运营说明：https://claw.mate.vip/docs/zh/releases/2.2.0v2.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.0MateClaw 2.2.0 的主题可以概括为一句话：2.1 让协作成为一份运行，2.2 让运行本身可替换、可恢复、可互联。
