mateclaw/README_zh.md

7.9 KiB
Raw Blame History

MateClaw Logo

MateClaw

让 AI 真正去思考、行动、记忆,并把结果交付出来。

GitHub 仓库 文档 在线演示 官网 Java 版本 Spring Boot Vue 最后提交 许可证

[官网] [在线演示] [文档] [English]

MateClaw 预览


一个智能体引擎。一个知识系统。一个记忆层。一个工具运行时。一个多渠道入口。

一个产品。完整交付。

MateClaw 是基于 Java + Vue 3 构建的个人 AI 操作系统,由 Spring AI Alibaba 驱动。它不是聊天框,不是工作流编排器,不只是又一个编码助手。它是从推理到记忆到交付的完整系统——一次部署,全部搞定。

三件事让它截然不同:

  1. 智能体做事,不只聊天 — ReAct + 计划执行。不是一问一答——是迭代推理,直到任务真正完成
  2. 知识被塑造,而非仅仅被存储 — LLM Wiki 把原始资料消化成结构化的链接页面。仓库和图书馆的区别
  3. 端到端,不妥协 — Web 控制台、桌面端、7 个 IM 渠道、工具防护、企业认证。一个团队、一次部署、一个体验

为什么选 MateClaw

大多数 AI 工具只做好一件事。MateClaw 做好整件事。

能力 MateClaw OpenClaw CoPaw QClaw Claude Code Cursor Windsurf
多智能体编排 ReAct + 计划执行 单智能体 单智能体 单智能体 并行 Agent 后台 Agent Cascade 引擎
LLM Wiki 知识库 原创 知识图谱
复合记忆 提取 + 整理 + 涌现 插件依赖 ReMe 记忆 插件依赖 自动记忆 仅会话
工具防护与审批 完整支持
多渠道 IM 7 个渠道 25+ 渠道 5+ 渠道 微信/QQ 仅终端 仅 IDE 仅 IDE
Web 管理界面 完整仪表盘 有限
桌面端 Electron + JRE CLI CLI CLI CLI
多模态创作 TTS/STT/图/音乐/视频
技能市场 ClawHub 插件系统 Python 技能 模板 MCP 技能 MCP
企业认证 RBAC + JWT 团队版 团队版
开源 Apache 2.0 部分 仅 CLI
定价 免费 免费 免费 未发布 按量付费 $0200/月 $060/月

差异在哪? OpenClaw 给你渠道。Claude Code 给你终端。Cursor 给你编辑器。MateClaw 给你一个 AI 操作系统——智能体能推理、能记忆、能创作,出现在你工作发生的每一个地方。有管理仪表盘。免费。


架构全景

业务架构

技术架构

技术架构


核心能力

智能体引擎

  • ReAct 智能体 — 思考、行动、观察、循环。迭代推理直到完成任务
  • 计划-执行智能体 — 将复杂工作分解为有序步骤,逐一执行
  • 动态配置 — 运行时从数据库加载智能体的人格、工具和约束
  • 运行时韧性 — 上下文裁剪、智能截断、僵死流清理、异常恢复

知识与记忆

  • LLM Wiki 知识库 — AI 驱动的知识库,将原始资料消化为结构化、有链接的页面
  • 工作区记忆AGENTS.mdSOUL.mdPROFILE.mdMEMORY.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 是能力。

一个陪在你身边的系统,一个能真正抓住工作、推动它前进的系统。


许可证

Apache License 2.0