mateclaw (Matevip)

MateClaw

Your second brain

Agent Harness · Spring Boot inside · One JAR to ship

](https://github.com/matevip/mateclaw)    ](https://adoptium.net/)    

\[网站\] \[现场演示\] \[文档\] \[中文\]

______________________________________________________________________

其他个人AI代理是为一个人构建的。MateClaw是您的IT部门可以实际签署的。 多用户工作区。审批限制敏感操作。完整的审计跟踪。Spring Boot执行器健康监测。每通道错误隔离，因此一个聊天平台的中断不会影响其余部分。您自己的机器上有一个JAR，零数据出口。 下面是一个真正的特工马具。 在StateGraph运行时上重新执行+计划和执行——而不是一次精心打扮的RAG调用。工具、技能、MCP和ACP汇聚在一个注册表中，每个员工都有绑定。敏感的工具调用通过一个您可以实际检查的审批门。当提供程序不运行时，多供应商故障转移会保持循环运行。

大多数人工智能工具都会在供应商糟糕的一天死去。大多数人在标签关闭的那一刻就忘记了你。大多数人给你一个聊天框，并称之为产品。

MateClaw是整个小部件。 一次部署。推理、知识、记忆、工具、渠道——构建在一起，而不是栓在一起。当你的主要模型失效时，下一个模型会在句子中间出现。

______________________________________________________________________

三件事让它与众不同

1·当模型死亡时，你的AI不会死亡

主键已过期。供应商返回401。网络故障。配额耗尽。

其他工具会给你一张红色的错误卡。MateClaw路由到下一个健康的提供商——DashScope、OpenAI、Anthropic、Gemini、DeepSeek、Kimi、Ollama、LM Studio、MLX，总共14+——用户看到回复完成。供应商健康跟踪器将不良供应商停放在冷却窗口中，这样他们就不会在每次转弯时浪费时间。

您不编写重试脚本。您可以将提供者拖动到优先级顺序中 设置→ 模型 当请求实时绕过失败时，观察健康仪表板上布满绿点。

2·相互关联的知识

上传一个PDF，一批降价，一个刮掉的页面——原材料。

MateClaw的 LLM维基 将其分解为结构化页面，构建 [[links]] 他们之间，并记得每一句话从哪里来。单击引文，查看确切的源代码块。问一个问题，你得到的页面是由正确的块拼接而成的——有你可以验证的引用。

这就是仓库和图书馆的区别。

3·一个产品，五个表面

同样的大脑。同样的记忆。同样的工具。不同的门。

$0 · No tokens metered. No seats billed. Your server. Your data. Your keys.

______________________________________________________________________

盒子里有什么

数字化员工，而非聊天机器人

你雇佣的是同事，而不是聊天室。每个人都有一个 角色一 目标一 背景故事，一个像素艺术化身和一种自己的颜色——五个职业模板已经准备就绪（产品研究员、客户支持、知识策展人、数据分析师、行政助理）。 交互式推理与行动 驱动迭代推理， 计划和执行 分解复杂的多步骤工作，员工可以并行委派。动态上下文修剪、智能截断、过时流清理——这些无聊的东西让长对话真正奏效。

知识与记忆

• LLM维基 --原材料被消化成带有引文的链接页面；这 热缓存 自动注入每个员工的系统提示。 转换引擎 （1.3.0+）将Wiki从搜索索引转变为处理管道
• 工作空间内存 — AGENTS.md, SOUL.md, PROFILE.md, MEMORY.md，每日笔记
• 内存生命周期 --对话后提取、计划整合、梦想工作流程。工作流也可以直接写入员工的 MEMORY.md 通过 write_memory 步

技能·MCP·ACP——拓展能力的三种途径

• SKILL.md软件包 --清单+提示+工具列表+ LESSONS.md（越用越聪明）八个入门模板加上一个五步创建向导 飞行前检查 在安装之前告诉您缺少什么
• 主控程序 --stdio/SSE/Streamable HTTP，可插入任何外部工具服务器。 每位员工绑定 （1.3.0+）意味着您为一名员工安装的工具不会流入另一名员工的工具箱
• 自动控制面板 --将Claude Code和Codex等顶级编码代理作为员工，使用包装工具自动桥接到技能卡上
• 工具防护装置 --RBAC+审批流+路径保护。能力需要边界

业务编排（1.3.0+）

• 工作流程 --将多个员工和系统操作（批准/渠道调度/写入内存）组合成一个可发布、可触发、可重放的线性DSL。七步模式(sequential / fan_out / collect / conditional / await_approval / dispatch_channel / write_memory).JSON首次使用Monaco+模式验证或自然语言创作→ 草稿生成
• 触发器 --将系统事件关联到工作流或员工对话。六种图案类型(cron / webhook / channel_message / agent_lifecycle / content_match / workflow_completion).事件治理的默认值：去重、每触发率限制、机器人自我过滤、递归保护、故障关闭未知模式
• Wiki转换 --Wiki不再仅用于检索。用户编写的模板针对原材料或现有页面运行，具有跨材料映射减少聚合、反向引用提取、JSON输出模式和每个模板模型选择器

你看每个员工都在做什么

管理员运行时控制台 (Settings → System → Runtime)--谁在跑步，他们在走哪一步，有多少代币，卡住时一键强制回收。流媒体是诚实地进行的（思考/工具/答案），每个事件的SSE ID使重新连接安全，多员工授权不再自我斗争，长期任务需要基于证据的答案。

多模式创建

文本转语音·语音转文本·图像·音乐·视频·3D。头等舱，不是附加舱。 侧车路线 （1.3.0+）表示纯文本主模型+图像附件不再是死胡同——配置的视觉模型描述了图像，主模型给出了答案。 图像编辑 土地也是：请参阅之前的对话附件 msg:: 并要求模型重新着色或重新设计 文档生成工具 (DocxRenderTool / XlsxRenderTool / PptxRenderTool / PdfRenderTool)将Markdown直接渲染到JVM内的Office文件中——无需子进程，也无需安装Office。

企业就绪

RBAC+JWT。 个人访问令牌 用于无头脚本和CI。 HMAC-SHA-256出站webhook签名. 分布式Cron锁 因此，多实例部署不会双重启动。完整的审计跟踪。Flyway管理的模式在升级时自动修复。一个JAR要发货。MySQL在生产环境中，H2用于开发——代码中没有任何变化。

______________________________________________________________________

人工智能正在成为基础设施

2026年3月2日，Claude在API、网络和移动设备上暗了4个小时。三周后，又过了五个小时。每一家将人工智能战略押注于单一供应商的公司，在这些停机期间都盯着红色的错误卡。

这与2010年左右数据库和2018年左右云计算所经历的转变相同：获胜层不再与一个供应商挂钩。 57%的公司现在在生产中运行人工智能代理。 他们都不希望一个供应商的糟糕日子变成他们的糟糕日子。

MateClaw就是那个层——以Spring Boot的方式构建。

______________________________________________________________________

为什么选择MateClaw

|:---|:---:|:---:|:---:|:---:|:---:| | 多供应商故障转移 | 链+健康追踪器+冷却 |通过配置交换提供者|重新编排|仅限人类|一个模型| | 知识消化 | LLM Wiki+页面级引用 |画布+内存|技能中心+内存|--|代码索引| | 多用户管理员 | RBAC+审批+审核+运行时控制台 |配置文件优先|单用户CLI |企业层|团队计划| | 能力扩展 | 技能（课程）+MCP+ACP |--|--|MCP|MCP| | 表面 |Web管理员+桌面+小部件+SDK+8 IM | 25+聊天频道| 15+频道（CLI主导）| 3 IM预览|仅限IDE| | 堆栈 | Java（Spring Boot） |TypeScript | Python | TypeScript |电子/TS| | 许可证/价格 | Apache 2.0·免费 | 麻省理工学院 · 免费 | 麻省理工学院 · 免费 | 专有 · $20–200/月 | 专有 · $0–200/月 |

OpenClaw和Hermes Agent是优秀的个人AI平台 --如果您在一台笔记本电脑上运行一个用户，从CLI构建自己的代理，并将所有内容视为配置文件进行手动调优，请选择其中之一。两者都有比今天的MateClaw更大的社区。

MateClaw是为团队构建的版本。 每个数字员工、每个模型、每个工具的RBAC。暂停风险操作以供审查的审批流。完整的审计跟踪。管理员运行时控制台让一名操作员实时查看14家供应商的50名员工——卡住了吗？一键强制回收。内置Spring Boot——任何已经运行生产服务的Java商店都可以使用。

同样的“整体小部件”哲学。不同的重心。

______________________________________________________________________

快速开始

# Backend
cd mateclaw-server
mvn spring-boot:run           # http://localhost:18088

# Frontend
cd mateclaw-ui
pnpm install && pnpm dev      # http://localhost:5173

登录： admin / admin123

码头工人

cp .env.example .env
docker compose up -d          # http://localhost:18080

桌面

下载自 .Bundles JRE 21。无需安装Java。

______________________________________________________________________

建筑

Technical architecture

______________________________________________________________________

项目结构

mateclaw/
├── mateclaw-server/        Spring Boot 3.5 backend (Spring AI Alibaba, StateGraph runtime)
├── mateclaw-ui/            Vue 3 + TypeScript admin SPA (built into the server JAR)
├── mateclaw-webchat/       Embeddable chat widget (UMD / ES bundles)
├── mateclaw-plugin-api/    Java SDK for third-party capability plugins
├── mateclaw-plugin-sample/ Reference plugin implementation
├── docker-compose.yml
└── .env.example

桌面二进制文件通过以下方式发布 使用捆绑的JRE 21，无需安装Java。

技术栈

______________________________________________________________________

文档

完整文档请访问 claw.mate.vip/docs -设置、体系结构、每个子系统、API参考。

路线图

v1.3.0（2026年5月13日发货） --工作流引擎·6模式触发系统·Wiki转换·每代理MCP绑定·多模式sidecar路由·四个JVM原生文档生成工具·图像编辑。看 v1.3.0发行说明 完整的故事。

下一步 --拖动以编辑工作流画布·运行回放时间线· loop 和 invoke_skill 步骤模式·触发优先级和事件回放·行业场景市场·更多ACP上游集成。

贡献

git clone https://github.com/matevip/mateclaw.git
cd mateclaw
cd mateclaw-server && mvn clean compile
cd ../mateclaw-ui && pnpm install && pnpm dev

______________________________________________________________________

为什么叫这个名字

伴侣 是伴侣。 爪 是能力。

它会一直伴随着你，抓住工作并移动它。

许可证

Apache许可证2.0.没有星号。