MateClaw 2.0.0 稳定版现已发布。本次版本的核心变化,是把 MateClaw 从“单个数字员工完成任务”推进到“多位数字员工围绕共享任务板协作”。
MateClaw 是一个基于 Spring Boot 的开源 AI Agent 平台,提供数字员工运行时、LLM Wiki、记忆、Tool / Skill / MCP / ACP、工作流、触发器、多渠道接入、权限审批和审计能力。项目采用 Apache License 2.0,支持自托管,数据与模型 Key 由使用者自己掌握。
版本亮点
1. Agent Teams 与共享任务板
2.0.0 新增常设 Agent 团队,成员角色包括 lead、member 与 reviewer。用户向 Lead 提交目标后,Lead 可以把目标拆成任务写入团队任务板,通过 blockedBy 描述任务依赖,并由派发引擎把可执行任务分配给空闲成员。
任务板包含八种状态:pending、in_progress、in_review、completed、failed、cancelled、blocked、stale。任务状态由后端状态机管理,关键更新带数据库条件守卫,避免并发重复认领。
前置任务完成后,其结果与交付物会自动进入下游任务上下文;任务全部完成后,系统自动通报并唤醒 Lead 汇总结果。
2. Plan-Execute 计划整体移交任务板
Plan-Execute 类型的 Lead 可以将整份计划移交团队任务板:步骤映射为任务,依赖映射为 blockedBy,可以并行的步骤由不同成员并行执行。
任务全部落定后,系统通过停靠计划恢复门进入汇总节点,从任务结果与交付物重建上下文。如果计划中存在无法分配的步骤,则整份计划回落原有串行管线,避免出现半移交状态。
3. 面向长任务的可靠执行链
团队任务通常持续时间更长,因此 2.0.0 增加了以下机制:
-
执行租约与心跳:运行中自动续期,只有真正失联的任务才进入 stale 并允许重派;
-
取消即中断:取消任务会在下一个 Agent 图节点边界停止成员子会话;
-
审批卡点:声明 requireApproval 的任务提交后进入 in_review;
-
失败恢复:failed 与 stale 任务可重试;
-
交付物登记:DOCX、PPTX、XLSX、PDF 等文件可绑定任务并直接下载;
-
全程可观测:团队 SSE 事件、活动横幅、任务时间线和成员子会话转写实时可见。
4. 工作空间隔离继续加固
本版本完成了渠道会话与 Skill 的工作空间隔离收口:
-
渠道会话 ID 编入渠道标识,避免不同工作空间的同一外部用户发生会话串扰;
-
Skill 的安装查重、磁盘目录与运行时解析均按工作空间隔离;
-
不同工作空间可以安装同名 Skill,运行时只解析当前会话有权访问的版本。
5. 渠道、会话与错误恢复
-
新增全渠道命令:/new、/clear、/status、/stop、/model、/help;
-
企业微信新增事件驱动进度气泡,实时展示思考状态、工具轨迹与耗时;
-
“回退到此处”改为服务端真实截断,“重新生成”复用原始用户消息;
-
自动批准未命中原因码进入审计记录,并支持从审计页一键补策略;
-
LLM 错误恢复区分过载与限流,支持 Retry-After、Provider TTL 自动回收与抖动退避。
6. Skill、附件与可选 Mem0 插件
-
SKILL.md 成为运行时与控制台的单一事实源;
-
scripts/、references/、templates/ 可在控制台查看和管理;
-
PDF、DOCX、XLSX、HTML、Markdown、文本与代码附件支持在线预览;
-
Mem0 作为可选插件式 Memory Provider 接入,默认本地优先方案保持不变;
-
知识图谱新增关系模式白名单。
升级说明
从 v1.8.0 升级时,已有员工、Skill、Wiki、渠道、定时任务、Workflow、Trigger 与 Goal 均保留。Flyway 会自动执行 V170–V174 迁移。
-
团队能力按需启用;不创建团队时,原有使用方式不变;
-
delegateToAgent 与 Agent Teams 可以同时使用;
-
新的渠道会话 ID 格式主要影响新会话,历史会话提供迁移与兼容兜底;
-
自动批准结果字段只对升级后的新调用生效。
快速开始
git clone https://github.com/mateaix/mateclaw.git
cd mateclaw
cp .env.example .env
docker compose up -d
浏览器访问 http://localhost:18080。
默认账号为 admin,默认密码为 admin123,正式部署前请及时修改。
相关链接
MateClaw 2.0.0 的主题可以概括为一句话:从“一个能干活的人”,到“一支能协作的队伍”。