mirror of
https://gitee.com/mateos/mateclaw.git
synced 2026-09-13 03:13:41 +08:00
7.6 KiB
7.6 KiB
MateClaw 是一个基于 Java + Vue 3 构建的个人 AI 操作系统,由 Spring AI Alibaba 驱动。
不是又一个聊天框。这是一个完整的 AI 工作系统——智能体能推理、用工具、构建记忆、把原始资料消化成 Wiki、创作多模态内容,还能出现在每一个真正发生工作的渠道里。
三件事让它与众不同:
- 智能体做事,不只聊天 — ReAct 循环推理 + 计划执行,完成真正的任务
- 知识被塑造,而非仅仅被存储 — LLM 驱动的 Wiki 把原始资料消化成结构化的链接页面
- 端到端整合 — 一个团队、一次部署,从桌面端到 IM 渠道的完整体验控制
为什么选 MateClaw
大多数开源 AI 工具只做好一件事。MateClaw 做好整件事。
| 能力 | MateClaw | Dify | LobeChat | FastGPT | NextChat | MaxKB | Open WebUI |
|---|---|---|---|---|---|---|---|
| 智能体 (ReAct + 计划执行) | 完整支持 | 仅 ReAct | 部分 | 无 | 无 | 无 | 无 |
| LLM Wiki 知识库 | 原创 | 仅 RAG | 仅 RAG | 仅 RAG | 无 | 仅 RAG | 仅 RAG |
| 复合记忆系统 | 完整支持 | 无 | 无 | 无 | 无 | 无 | 无 |
| MCP 协议 | 完整支持 | 插件 | 支持 | 支持 | 无 | 支持 | 无 |
| 工具防护与审批 | 完整支持 | 无 | 无 | 无 | 无 | 无 | 无 |
| 技能市场 | ClawHub | 插件市场 | 插件商店 | 无 | 无 | 无 | 无 |
| 多渠道 IM | 7 个渠道 | 仅 Webhook | 2 个 | 无 | 无 | 无 | 无 |
| 桌面端 | Electron + JRE | 无 | 仅 PWA | 无 | 有 | 无 | 无 |
| 多模态创作 | TTS/STT/图/音乐/视频 | 无 | TTS/图片 | 无 | 无 | 仅 I/O | 无 |
| 技术栈 | Java + Vue 3 | Python + Next.js | TypeScript + Next.js | TypeScript + Next.js | TypeScript + Next.js | Python + Vue | Python + Svelte |
差异在哪? 别人给你一个聊天界面或工作流编排器。MateClaw 给你一个 AI 操作系统——智能体能推理、能记忆、用工具有防护、出现在你工作发生的每一个地方。
架构全景
核心能力
智能体引擎
- 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+
本地开发
# 后端
cd mateclaw-server
mvn spring-boot:run # http://localhost:18088
# 前端
cd mateclaw-ui
pnpm install && pnpm dev # http://localhost:5173
默认登录:admin / admin123
Docker 部署
cp .env.example .env
docker compose up -d # http://localhost:18080
桌面端
从 GitHub 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
路线图
- 更丰富的多智能体协作
- 更智能的模型路由
- 更深度的多模态理解
- 更强的长期记忆
- 更丰富的 ClawHub 生态
参与贡献
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 是能力。
一个陪在你身边的系统,一个能真正抓住工作、推动它前进的系统。

