mirror of
https://gitee.com/mateos/mateclaw.git
synced 2026-09-13 19:23:42 +08:00
231 lines
9.5 KiB
Markdown
231 lines
9.5 KiB
Markdown
<div align="center">
|
||
|
||
<p align="center">
|
||
<img src="mateclaw-ui/public/logo/mateclaw_logo_s.png" alt="MateClaw Logo" width="120">
|
||
</p>
|
||
|
||
# MateClaw
|
||
|
||
<p align="center"><b>让 AI 真正去思考、行动、记忆，并把结果交付出来。</b></p>
|
||
|
||
[](https://github.com/matevip/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/matevip/mateclaw)
|
||
[](LICENSE)
|
||
|
||
[[官网](https://claw.mate.vip)] [[在线演示](https://claw-demo.mate.vip)] [[文档](https://claw.mate.vip/docs)] [[English](README.md)]
|
||
|
||
</div>
|
||
|
||
<p align="center">
|
||
<img src="assets/images/preview.png" alt="MateClaw 预览" width="800">
|
||
</p>
|
||
|
||
---
|
||
|
||
一个智能体引擎。一个知识系统。一个记忆层。一个工具运行时。一个多渠道入口。
|
||
|
||
**一个产品。完整交付。**
|
||
|
||
MateClaw 是基于 **Java + Vue 3** 构建的个人 AI 操作系统，由 [Spring AI Alibaba](https://github.com/alibaba/spring-ai-alibaba) 驱动。它不是聊天框，不是工作流编排器，不只是又一个编码助手。它是从推理到记忆到交付的完整系统——一次部署，全部搞定。
|
||
|
||
三件事让它截然不同：
|
||
|
||
1. **智能体做事，不只聊天** — ReAct + 计划执行。不是一问一答——是迭代推理，直到任务真正完成
|
||
2. **知识被塑造，而非仅仅被存储** — LLM Wiki 把原始资料消化成结构化的链接页面。仓库和图书馆的区别
|
||
3. **端到端，不妥协** — Web 控制台、桌面端、7 个 IM 渠道、工具防护、企业认证。一个团队、一次部署、一个体验
|
||
|
||
---
|
||
|
||
## 为什么选 MateClaw
|
||
|
||
大多数 AI 工具只做好一件事。MateClaw 做好整件事。
|
||
|
||
| 能力 | MateClaw | [OpenClaw](https://github.com/openclaw/openclaw) | [CoPaw](https://github.com/agentscope-ai/CoPaw) | [QClaw](https://cntechpost.com/2026/03/20/tencent-opens-qclaw-public-testing-amid-fierce-ai-rivalry/) | [Claude Code](https://github.com/anthropics/claude-code) | [Cursor](https://cursor.com) | [Windsurf](https://windsurf.com) |
|
||
|:---|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
|
||
| 智能体编排 | **ReAct + 计划执行** | 多智能体团队 | 多智能体协作 | 专家智能体 | Agent Teams + 子智能体 | 后台 Agent（云端 VM） | Cascade 引擎 |
|
||
| 知识系统 | **LLM Wiki（消化式）** | Intelligence Mode + Wiki | 个人知识库 | 知识图谱 | CLAUDE.md（无 RAG） | 代码库索引 | 无 |
|
||
| 记忆 | **提取 + 整理 + 涌现** | SQLite + Dreaming + Wiki | ReMe（混合检索） | 三层记忆 | 三层（CLAUDE.md + 自动 + 文件） | 无持久记忆 | Memories（~48h 学习） |
|
||
| 工具防护与审批 | **RBAC + 审批流** | HITL + 风险等级 | 无 | 无 | 权限 + 沙箱 + Hooks | 无 | Turbo Mode（自动放行） |
|
||
| 多渠道 IM | **7 个渠道** | 25+ 渠道 | 7 个渠道 | 5 个渠道 | 3 个渠道（预览） | 仅 IDE | 仅 IDE |
|
||
| Web 管理界面 | **完整管理仪表盘** | Control UI | Console UI | 控制面板 | 企业版仪表盘 | 无 | 无 |
|
||
| 桌面端 | **Electron + 内嵌 JRE** | macOS 菜单栏 | Electron（Beta） | Win/Mac 应用 | Claude Desktop（Mac/Win） | VS Code 分支 | VS Code 分支 |
|
||
| 多模态创作 | **TTS/STT/图/音乐/视频** | TTS/视频/音乐/图片 | 视觉输入 | 无 | 仅视觉输入 | 无 | 无 |
|
||
| 技能生态 | **ClawHub 市场** | ClawHub 注册表 | Python 技能 | 模板 | 340+ 插件, 1300+ 技能 | MCP 市场 | MCP 一键集成 |
|
||
| 企业认证 | **RBAC + JWT** | 基础（密码） | 基础认证 | 无 | SSO/SCIM/RBAC | SSO + 团队版 | 团队版 |
|
||
| 开源 | **Apache 2.0** | MIT | Apache 2.0 | 部分 | 否（源码可见） | 否 | 否 |
|
||
| 定价 | **免费** | 免费 | 免费 | 免费（公测） | $20–200/月 | $0–200/月 | $0–200/月 |
|
||
| 技术栈 | **Java + Vue 3** | TypeScript | Python + TS | OpenClaw 衍生 | TypeScript | Electron (VS Code) | Electron (VS Code) |
|
||
|
||
**MateClaw 的差异化在哪？**
|
||
|
||
这张表里的每个产品都有真正的实力。MateClaw 的独特空间在这里：
|
||
|
||
- **计划-执行编排** — 把复杂工作分解为有序步骤，逐一执行，动态调整计划。别人有多智能体，但结构化任务规划+动态重规划是稀缺能力
|
||
- **LLM Wiki 消化式知识库** — 别人索引和搜索。MateClaw 的 Wiki 把原始资料转化为结构化、有链接的页面——搜索引擎和百科全书的区别
|
||
- **Java 生态** — 为已经在生产环境运行 Spring Boot 的团队而生。一个 JAR，一次部署。无需 Python 运行时，无需 Node.js 依赖链
|
||
- **完整管理仪表盘** — 智能体、模型、工具、技能、渠道、安全、定时任务、Token 用量——全在一个 Web 界面。不是 CLI 优先的附属品
|
||
- **完整多模态创作** — TTS、STT、图片、音乐、视频生成作为内置一等功能。OpenClaw 在这方面同样强；其他竞品不具备
|
||
- **免费开源，没有星号** — Apache 2.0。无按量计费，无按席收费，无功能阉割。Claude Code 起步 $20/月，Cursor 和 Windsurf 最高 $200/月
|
||
|
||
---
|
||
|
||
## 架构全景
|
||
|
||
<p align="center">
|
||
<img src="assets/architecture-biz-zh.svg" alt="业务架构" width="800">
|
||
</p>
|
||
|
||
<details>
|
||
<summary><b>技术架构</b></summary>
|
||
<p align="center">
|
||
<img src="assets/architecture-tech-zh.svg" alt="技术架构" width="800">
|
||
</p>
|
||
</details>
|
||
|
||
---
|
||
|
||
## 核心能力
|
||
|
||
### 智能体引擎
|
||
|
||
- **ReAct 智能体** — 思考、行动、观察、循环。迭代推理直到完成任务
|
||
- **计划-执行智能体** — 将复杂工作分解为有序步骤，逐一执行
|
||
- **动态配置** — 运行时从数据库加载智能体的人格、工具和约束
|
||
- **运行时韧性** — 上下文裁剪、智能截断、僵死流清理、异常恢复
|
||
|
||
### 知识与记忆
|
||
|
||
- **LLM Wiki 知识库** — AI 驱动的知识库，将原始资料消化为结构化、有链接的页面
|
||
- **工作区记忆** — `AGENTS.md`、`SOUL.md`、`PROFILE.md`、`MEMORY.md`、每日笔记
|
||
- **记忆生命周期** — 对话后自动提取、定时整理、记忆涌现工作流
|
||
- **记忆应该积累** — 理解随时间加深，而非每次查询都从零开始
|
||
|
||
### 工具、技能与 MCP
|
||
|
||
- **内置工具** — 联网搜索、文件操作、记忆访问、日期时间等
|
||
- **MCP 集成** — 支持 stdio、SSE、Streamable HTTP 三种传输
|
||
- **技能系统** — 可安装的 `SKILL.md` 技能包 + ClawHub 市场
|
||
- **工具防护** — 审批流、文件路径保护、运行时过滤
|
||
|
||
### 多模态创作
|
||
|
||
语音合成 · 语音识别 · 图片生成 · 音乐生成 · 视频生成
|
||
|
||
### 模型灵活性
|
||
|
||
14+ 供应商支持，包括 DashScope、OpenAI、Anthropic、Gemini、DeepSeek、Kimi、Ollama、LM Studio、MLX 等。在 Web 界面中配置一切。
|
||
|
||
### 用户触点
|
||
|
||
- **Web 控制台** — 对话、智能体、工具、技能、知识、模型、安全、设置
|
||
- **桌面端** — Electron + 内嵌 JRE 21，无需安装 Java
|
||
- **多渠道** — 钉钉、飞书、企业微信、Telegram、Discord、QQ
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
### 环境要求
|
||
|
||
- Java 17+ · Node.js 18+ · pnpm · Maven 3.9+
|
||
|
||
### 本地开发
|
||
|
||
```bash
|
||
# 后端
|
||
cd mateclaw-server
|
||
mvn spring-boot:run # http://localhost:18088
|
||
|
||
# 前端
|
||
cd mateclaw-ui
|
||
pnpm install && pnpm dev # http://localhost:5173
|
||
```
|
||
|
||
默认登录：`admin` / `admin123`
|
||
|
||
### Docker 部署
|
||
|
||
```bash
|
||
cp .env.example .env
|
||
docker compose up -d # http://localhost:18080
|
||
```
|
||
|
||
### 桌面端
|
||
|
||
从 [GitHub Releases](https://github.com/matevip/mateclaw/releases) 下载安装包。内嵌 JRE 21，无需额外安装 Java。
|
||
|
||
---
|
||
|
||
## 技术栈
|
||
|
||
| 层次 | 技术 |
|
||
|------|------|
|
||
| 后端 | Spring Boot 3.5 · Spring AI Alibaba 1.1 |
|
||
| 智能体 | StateGraph 运行时 |
|
||
| 数据库 | H2（开发）/ MySQL 8.0+（生产）|
|
||
| ORM | MyBatis Plus 3.5 |
|
||
| 认证 | Spring Security + JWT |
|
||
| 前端 | Vue 3 · TypeScript · Vite |
|
||
| UI | Element Plus · TailwindCSS 4 |
|
||
| 桌面端 | Electron · electron-updater |
|
||
|
||
---
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
mateclaw/
|
||
├── mateclaw-server/ Spring Boot 后端
|
||
├── mateclaw-ui/ Vue 3 SPA 前端
|
||
├── mateclaw-desktop/ Electron 桌面端
|
||
├── docker-compose.yml
|
||
└── .env.example
|
||
```
|
||
|
||
---
|
||
|
||
## 文档
|
||
|
||
完整文档请访问 **[claw.mate.vip/docs](https://claw.mate.vip/docs)**
|
||
|
||
---
|
||
|
||
## 路线图
|
||
|
||
- 更丰富的多智能体协作
|
||
- 更智能的模型路由
|
||
- 更深度的多模态理解
|
||
- 更强的长期记忆
|
||
- 更丰富的 ClawHub 生态
|
||
|
||
---
|
||
|
||
## 参与贡献
|
||
|
||
```bash
|
||
git clone https://github.com/matevip/mateclaw.git
|
||
cd mateclaw
|
||
cd mateclaw-server && mvn clean compile
|
||
cd ../mateclaw-ui && pnpm install && pnpm dev
|
||
```
|
||
|
||
---
|
||
|
||
## 为什么叫这个名字
|
||
|
||
**Mate** 是陪伴。**Claw** 是能力。
|
||
|
||
一个陪在你身边的系统，一个能真正抓住工作、推动它前进的系统。
|
||
|
||
---
|
||
|
||
## 许可证
|
||
|
||
[Apache License 2.0](LICENSE)
|