MateClaw 是一个面向团队的多用户 AI 智能体平台，定位为“你的第二大脑”，基于 Spring AI Alibaba 构建。当前开发版本为 3.0.0-SNAPSHOT，技术栈包括 Java 21、Spring Boot 4.1.1、Spring AI 2.0.1、AgentScope 2.0.4。AgentScope 负责执行循环，MateClaw 保留工具审批、权限、Goals、SSE 与持久化。
用途与定位 MateClaw 面向需要多用户工作区、审批门控敏感操作、完整审计追踪和按渠道错误隔离的团队场景。它强调“数字员工”而非聊天机器人：每位员工拥有 Role、Goal、Backstory、运行时、像素风头像和专属颜色，内置六种模板（通用助手、产品助手、研究分析师、客户支持、数据分析师、代码审查员）。员工身份与治理在更换执行引擎时保持稳定。
主要能力
- 多智能体编排与 Agent Runtime：AgentRuntimeProvider 契约将员工与执行引擎解耦。原生运行时在 MateClaw 内保留 ReAct、Plan-and-Execute、持久化 Goals 和 Team Runs；DSH 运行时启动官方 dsh --profile sdk CLI，并规范化其思考、文本、工具、用量、完成与取消事件。托管安装固定 0.2.0-rc.1（备选 0.1.7-rc.2），使用经审查的 npm 锁与 Node.js 22。
- 持久化长任务：Persistent Goals 将耗时数小时的工作拆分为有界、可恢复的片段。数据库保存目标清单、继续状态、尝试次数、冷却、租约以及工作期间接受的用户输入。单后端实例重启后，监督器会协调中断的尝试，读取持久化检查点与产物，并调度下一个安全片段。
- Team Runs：一次请求对应一个持久化 Team Run，稳定的 runId 关联用户目标、任务 DAG、工作执行、最终综合与交付物。聊天是结果界面，Agents Live 实时观察，Teams 管理历史与治理。底层共享看板提供依赖编排、并行调度、前置交接、执行租约、取消中断和人工审批门。
- 知识与记忆：LLM Wiki 将原始材料消化为带链接的结构化页面并保留可追溯引用；热缓存自动注入每位员工的系统提示。工作区记忆包括 AGENTS.md、SOUL.md、PROFILE.md、MEMORY.md 和每日笔记。记忆生命周期涵盖对话后提取、定时整合和 Dreaming 工作流。
- 技能、MCP、ACP：SKILL.md 包包含清单、提示、工具列表和 LESSONS.md；MCP 支持 stdio / SSE / Streamable HTTP，可按员工绑定；ACP 可将 Claude Code、Codex 等编码智能体作为员工接入。Tool Guard 提供 RBAC、审批流和路径保护。
- 业务编排：Workflow 将多个员工与系统动作组合为可发布、可触发、可重放的线性 DSL，含七种步骤模式（sequential / fan_out / collect / conditional / await_approval / dispatch_channel / write_memory）。Triggers 支持六种模式（cron / webhook / channel_message / agent_lifecycle / content_match / workflow_completion）。Wiki Transformations 支持用户模板对原始材料或现有页面运行，含 map-reduce 聚合、反向引用提取和 JSON 输出。
- 多模态创作：文本转语音、语音转文本、图像、音乐、视频、3D。Sidecar 路由让纯文本主模型配合图像附件不再死路。四种文档生成工具（DocxRenderTool / XlsxRenderTool / PptxRenderTool / PdfRenderTool）在 JVM 内将 Markdown 渲染为 Office 文件。Content Studio 可将一句话变为可发布内容，支持微信公众号文章与小红书笔记。
- 企业就绪：RBAC + JWT、个人访问令牌、HMAC-SHA-256 出站 webhook 签名、分布式 Cron 锁、完整审计追踪、Flyway 管理 schema、单 JAR 部署。开发用 H2，公开 Docker 栈默认 PostgreSQL 16，MySQL 配置仍受支持，Kingbase 驱动可选。
使用方式 可从 GitHub Releases 下载，捆绑 JRE 21，无需安装 Java。默认登录：admin / admin123。完整文档位于 claw.mate.vip/docs，涵盖安装、架构、各子系统与 API 参考。模型提供商可在 Settings → Models 中拖拽排序，健康仪表盘实时显示路由状态。
适用场景 适合需要多用户工作区、审批门控、审计追踪和自有部署的团队；适合 Java 技术栈、已运行生产服务的企业；适合需要持久化长任务、多智能体协作和知识库管理的场景。
限制与说明 DSH 托管安装的包与真实模型适配器检查已在 macOS arm64 通过；Linux x64 与持久化 V3→V4 历史迁移尚未验证。运行时不对任意外部副作用承诺 exactly-once 行为，支付、发送、发布和破坏性调用仍需提供商幂等性或人工审核。技能上传中每个文件限制 10 MiB。OpenClaw 和 Hermes Agent 目前社区规模大于 MateClaw。
