mateclaw/README_zh.md

MateClaw

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

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

---

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

一个产品。完整交付。

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（消化式）	Intelligence Mode + Wiki	个人知识库	知识图谱	无	无	无
记忆	提取 + 整理 + 涌现	SQLite + Dreaming + Wiki	ReMe（混合检索）	三层记忆	自动记忆	无	仅会话
工具防护与审批	RBAC + 审批流	HITL + 风险等级	无	无	无	无	无
多渠道 IM	7 个渠道	25+ 渠道	7 个渠道	5 个渠道	仅终端	仅 IDE	仅 IDE
Web 管理界面	完整管理仪表盘	Control UI	Console UI	控制面板	无	无	无
桌面端	Electron + 内嵌 JRE	macOS 菜单栏	Electron（Beta）	Win/Mac 应用	CLI	有	有
多模态创作	TTS/STT/图/音乐/视频	TTS/视频/音乐/图片	视觉输入	无	无	无	无
技能生态	ClawHub 市场	ClawHub 注册表	Python 技能	模板	MCP 技能	无	MCP
企业认证	RBAC + JWT	基础（密码）	基础认证	无	无	团队版	团队版
开源	Apache 2.0	MIT	Apache 2.0	部分	仅 CLI	否	否
定价	免费	免费	免费	免费（公测）	按量付费	$0–200/月	$0–60/月
技术栈	Java + Vue 3	TypeScript	Python + TS	OpenClaw 衍生	TypeScript	Electron	Electron

MateClaw 的差异化在哪？

这张表里的每个产品都有自己的强项。MateClaw 的独特空间在这里：

• 计划-执行编排 — 不只是 ReAct 循环。把复杂工作分解为有序步骤，逐一执行，执行中动态调整计划。大多数竞品止步于单轮 Agent 调用
• LLM Wiki 消化式知识库 — 别人索引和搜索。MateClaw 的 Wiki 把原始资料转化为结构化、有链接的页面——搜索引擎和百科全书的区别
• Java 生态 — 为已经在生产环境运行 Spring Boot 的团队而生。无需 Python 运行时，无需 Node.js 依赖链。一个 JAR，一次部署
• 完整的管理体验 — 智能体、模型、工具、技能、渠道、安全、定时任务、Token 用量的完整仪表盘。不是 CLI 优先的附属品
• 多模态创作套件 — TTS、STT、图片、音乐、视频生成内置。不是插件——是一等公民
• 永久免费 — Apache 2.0。无按量计费，无按席收费，无功能阉割

---

架构全景

技术架构

---

核心能力

智能体引擎

• 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 是能力。

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

---

许可证

Apache License 2.0