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

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。 升级时建议注意： 新目标默认持久执行，生产环境建议显式设置预算、并发和 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/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 让运行本身可替换、可恢复、可互联。