# mateclaw
**Repository Path**: mateos/mateclaw
## Basic Information
- **Project Name**: mateclaw
- **Description**: 🤖 MateClaw — 你的超级大脑,JAVA智能体 ,支持多 Agent 编排、Skills、Memory、Dream 、MCP协议与多渠道接入,底层由 Spring AI Alibaba 驱动。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: dev
- **Homepage**: https://claw.mate.vip
- **GVP Project**: Yes
## Statistics
- **Stars**: 588
- **Forks**: 276
- **Created**: 2026-04-04
- **Last Updated**: 2026-11-20
## Categories & Tags
**Categories**: ai
**Tags**: SpringAI, agentic, Harness, mateclaw, agent-harness
## 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)
你的超级大脑
可插拔 Agent Runtime · Native + DSH · Spring Boot 内核
[](https://github.com/mateaix/mateclaw)
[](https://claw.mate.vip/docs)
[](https://claw-demo.mate.vip)
[](https://claw.mate.vip)
[](https://adoptium.net/)
[](https://spring.io/projects/spring-boot)
[](https://vuejs.org/)
[](https://github.com/mateaix/mateclaw)
[](LICENSE)
[[官网](https://claw.mate.vip)] [[在线演示](https://claw-demo.mate.vip)] [[文档](https://claw.mate.vip/docs)] [[English](README.md)]
---
> **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 |
| **网页嵌入式聊天** | 一个 `