# mateclaw **Repository Path**: opjk-java/mateclaw ## Basic Information - **Project Name**: mateclaw - **Description**: No description available - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: dev - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-20 - **Last Updated**: 2026-11-20 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
> **3.1.0 正式版 · 2026-11-19**。Java 21 / Spring Boot 4.1.2 / Spring AI 2.0.2 / AgentScope Java 2.0.5。 > 技能经验审阅与撤回、快照恢复预览、精确记忆编辑、清晰的聊天状态,以及更可靠的模型与工具执行。 > [3.1.0 更新说明](mateclaw-server/src/main/resources/docs/zh/changelog.md) · [版本历史](CHANGELOG.md) · [下载发行包](https://github.com/mateaix/mateclaw/releases)

MateClaw Logo

# 太一(MateClaw)

你的超级大脑

可插拔 Agent Runtime · Native + DSH · Spring Boot 内核

[![GitHub 仓库](https://img.shields.io/badge/GitHub-仓库-black.svg?logo=github)](https://github.com/mateaix/mateclaw) [![文档](https://img.shields.io/badge/文档-在线-green.svg?logo=readthedocs&label=Docs)](https://claw.mate.vip/docs) [![在线演示](https://img.shields.io/badge/演示-在线-orange.svg?logo=vercel&label=Demo)](https://claw-demo.mate.vip) [![官网](https://img.shields.io/badge/官网-claw.mate.vip-blue.svg?logo=googlechrome&label=Site)](https://claw.mate.vip) [![Java 版本](https://img.shields.io/badge/Java-21+-blue.svg?logo=openjdk&label=Java)](https://adoptium.net/) [![Spring Boot](https://img.shields.io/badge/Spring%20Boot-4.1.2-brightgreen.svg?logo=springboot)](https://spring.io/projects/spring-boot) [![Vue](https://img.shields.io/badge/Vue-3-4FC08D.svg?logo=vuedotjs)](https://vuejs.org/) [![最后提交](https://img.shields.io/github/last-commit/mateaix/mateclaw)](https://github.com/mateaix/mateclaw) [![许可证](https://img.shields.io/badge/license-Apache--2.0-red.svg?logo=opensourceinitiative&label=License)](LICENSE) [[官网](https://claw.mate.vip)] [[在线演示](https://claw-demo.mate.vip)] [[文档](https://claw.mate.vip/docs)] [[English](README.md)]

MateClaw 预览

--- > **3.1.0——可审阅的技能经验与更可靠的执行。** 逐条审阅或撤回经验、恢复快照前预览影响、引用回答选文继续提问,同时加固模型上下文恢复、工具结果、Wiki 引用和渠道投递。[更新与升级说明](https://claw.mate.vip/docs/zh/releases/3.1.0)。 --- > **别的 AI 助手是给一个人用的。MateClaw 是公司允许部署的那一个。** > > 多用户工作空间。敏感操作走审批。完整审计日志。Spring Boot Actuator 健康监控。单个渠道挂掉不影响其他渠道的错误隔离。一个 JAR 包跑在自己的环境里;持久化数据由你掌控,任务所需内容只会发送到你主动配置的模型、渠道或工具服务。 > > **底下是一套真正的 Agent Runtime。** 员工不再焊死在一套推理循环上:可以用原生 AgentScope 运行 ReAct、Plan-and-Execute、Goal 与 Team Run,也可以通过 SDK JSON-RPC 把 DeepSeek Harness 作为受管理的外部循环。两条路径最终进入同一套会话、工作空间边界、Tool Guard、事件投影与生命周期控制。 大多数 AI 工具一到厂商抽风那天就两手一摊。关一次标签页就忘了你是谁。给你一个聊天框,就敢叫产品。 **MateClaw 是完整的一整套。** 一次部署——推理、知识、记忆、工具、多渠道入口,从第一天就一起设计,不是事后拼接。主模型不可用时,系统会按优先级改由下一家健康供应商重新完成当前请求。 --- ## 3.1.0 更新内容 以下为 [3.0.0](https://claw.mate.vip/docs/zh/releases/3.0.0) 之后的改动,按使用场景归类: - **技能与记忆**:逐条审阅、撤回技能经验,恢复快照前预览影响,异步安装技能并支持取消;精确保留记忆章节,避免异步编辑串入其他会话。 - **聊天与工具可见性**:引用回答选文继续提问;浏览器标题与图标显示会话状态;展示命令意图标题和真实 Shell 失败结果,保留停止回合的 token 用量。 - **执行可靠性**:恢复上下文溢出和过大的历史媒体,保存前校验模型参数,限制供应商并发,保留工具超时覆盖,并约束团队累计派发预算。 - **知识与文档**:对单个 Wiki 来源提取实体,多轮检索后对齐引用;生成文档后继续推理,保留 Markdown 表格值、文件换行风格与技能二进制附件。 - **渠道与 DSH**:拆分钉钉长 Markdown、校验投递回执并保留飞书附件文件名。DSH `0.2.2-rc.1` 是要求 Node.js 24.9+(24.x)的可选候选,默认仍为 `0.2.0-rc.1`。 - **当前技术栈**:Spring Boot **4.1.2**、Spring AI **2.0.2**、AgentScope Java **2.0.5**、MyBatis Plus **3.5.18.1**。原生 ReAct 和计划单步循环继续遵守 MateClaw 的审批、权限、Goal 验收与持久化边界。 源码构建使用 Java 21。升级前备份数据库、workspace、插件与配置,回滚使用升级前备份。[架构与升级说明](mateclaw-server/src/main/resources/docs/zh/changelog.md) · [模型预算规则](mateclaw-server/src/main/resources/docs/zh/models.md) ## 三件让它与众不同的事 ### 1 · 模型挂了,AI 不挂 Key 过期。厂商返回 401。网络抖动。配额耗尽。 别的工具丢你一张红色错误卡。MateClaw 会按配置顺序尝试下一家健康供应商——DashScope、OpenAI、Anthropic、Gemini、DeepSeek、Kimi、Ollama、LM Studio、MLX 等内置或 OpenAI 兼容供应商——尽可能恢复当前请求;仅当可用链路全部失败时才返回错误。内置的 **Provider Health Tracker** 会把连续失败的供应商放进冷却窗口,避免每一轮对话都白白撞壁。 你不用写重试脚本。在 **设置 → 模型** 里把供应商拖成你想要的优先顺序,健康面板实时亮起一排绿点——请求绕着故障流过去。 ### 2 · 知识会自己长出链接 上传 PDF、一批 markdown、抓下来的网页——原始材料进去。 MateClaw 的 **LLM Wiki** 把它消化成结构化页面,页面之间自己长出 `[[链接]]`,生成内容保留可追踪引用。点开引用抽屉,就能看到对应的原始 chunk;页面与回答中的引用可以回到来源核对。 这是**仓库**和**图书馆**的区别。 ### 3 · 一个产品,五个入口 | 入口 | 它是什么 | |---|---| | **Web 控制台** | 完整的管理后台——数字员工、模型、技能、知识、安全、定时任务、**运行时控制台**(看见每位员工正在干什么、一键回收) | | **桌面端** | Electron + 内嵌 JRE 21,双击即用,无需装 Java | | **网页嵌入式聊天** | 一个 `