Open Source · Spring AI Alibaba · Apache-2.0 License

MateClaw

基于 Spring AI Alibaba 构建的全栈 AI 助手系统

Java + Vue 3 · ReAct Agent · Plan-and-Execute · MCP 工具协议 · 多模型 · 多渠道

🤖
15+
模型供应商
📡
8+
渠道接入
⚖️
Apache
开源协议
🚀
v1
当前版本
MateClaw Console
MateClaw Console Preview
向下探索

直观体验
强大功能

从对话界面到智能规划,每一个交互细节都精心打磨。

claw-demo.mate.vip 打开演示
在线体验 MateClaw
点击打开在线演示环境
Agent 配置
可视化配置 Agent 参数与行为,支持 ReAct 和 Plan-and-Execute 双模式
多渠道接入
钉钉 · 飞书 · Telegram · Discord · 企业微信,统一消息网关
工具 & 技能市场
MCP 工具生态 · 一键安装技能包 · 自定义工具扩展
任务规划执行
自动拆解复杂任务 · 可视化执行流程 · 实时状态追踪

为 AI 助手而生的
工程级特性

每一项特性都来自真实业务场景的工程沉淀,不是玩具,是生产级系统。

REACT AGENT

推理 + 行动循环

Reasoning & Acting 交替执行,AI 自主思考、调用工具、验证结果,完成复杂多步骤任务,无需人工干预。

ThoughtActionObservation
PLAN-AND-EXECUTE

任务规划与执行

复杂目标自动拆解为有序子步骤,动态规划执行路径,支持并行子任务、条件分支与失败重试。

PlannerExecutorReplanner
MCP PROTOCOL

MCP 工具生态

Model Context Protocol 标准接口,运行时动态加载工具,无限扩展 AI 能力边界,兼容主流 MCP Server。

Dynamic LoadTool RegistryRuntime
MULTI-CHANNEL

多渠道统一接入

一套 Agent 核心,同时服务 Web、钉钉、飞书、企业微信、Telegram、Discord,渠道适配层完全解耦。

WebDingTalkFeishuTelegram
MULTI-MODEL

15+ 模型供应商

DashScope (Qwen)、Ollama、OpenAI、Kimi、DeepSeek、Claude 等,统一 API 抽象,一键切换模型。

QwenDeepSeekOllama+12
MODERN FRONTEND

Vue 3 控制台

Vue 3 + Pinia + TailwindCSS + Element Plus 构建的现代化管理控制台,支持暗黑模式与 SSE 流式输出。

Vue 3PiniaSSE Stream

清晰分层,
职责明确

MateClaw 采用经典的分层架构设计,从渠道接入到 AI 推理,每一层都有明确的边界与职责,确保系统的可扩展性与可维护性。

Channel Layer Web · 钉钉 · 飞书 · Telegram · Discord
Gateway Layer API Gateway · Sa-Token 认证 · 限流
Agent Layer ReAct Engine · Planner · Tool Registry
AI Layer Spring AI Alibaba · 多模型路由 · MCP
Infra Layer MySQL · Redis · Docker · Kubernetes
ReActAgent.java
01 Thought
02 Action
03 Observe
04 Answer

精选技术栈,久经考验

每一项技术选型都经过生产环境验证,稳定、高效、社区活跃。

S
Spring Boot 3
Backend
S
Spring AI
AI
V
Vue 3
Frontend
T
TailwindCSS
Frontend
M
MySQL 8
Database
R
Redis
Cache
D
Docker
DevOps
S
Sa-Token
Security
M
MyBatis-Plus
ORM
K
Knife4j
API Docs

持续迭代,不断进化

v0.1 ✓ 已完成
ReAct Agent 核心
推理+行动循环,StateGraph 状态机,工具调用,多轮对话
v0.2 ✓ 已完成
Plan-and-Execute
任务规划器,子任务拆解,动态重规划,数据库持久化
v0.3 ✓ 已完成
MCP 工具 & 13 内置工具
MCP Server 动态加载,WebSearch、Shell、文件读写、浏览器自动化等
v0.4 ✓ 已完成
8 渠道全接入
Web SSE、钉钉、飞书、企微、Telegram、Discord、微信、QQ
v0.5 ✓ 已完成
技能系统 & ToolGuard
SKILL.md 协议,技能市场,ToolGuard 安全拦截与审批工作流
v0.6 ✓ 已完成
多模型 & 桌面端
7+ 模型供应商统一路由,Electron 桌面客户端,Token 用量追踪
v1.0 ⚡ 进行中
正式版发布
JWT 认证体系,定时任务,工作区记忆持久化,完整管理控制台
v1.1 ○ 规划中
RAG 知识库 & 长期记忆
向量数据库集成,文档语义检索,会话长期记忆,知识图谱
v1.2 ○ 规划中
可视化工作流引擎
拖拽式 Agent 编排,条件分支,循环节点,多 Agent 协作
v2.0 ○ 规划中
企业版
多租户架构,RBAC 权限,SSO/LDAP 对接,审计日志与合规
v2.1 ○ 规划中
信息化系统集成
ERP/OA/CRM 连接器,数据中台对接,企业知识库同步,工单系统联动
v2.2 ○ 规划中
高可用 & 可观测性
集群部署,链路追踪,Prometheus 监控,SLA 保障,灰度发布

立即开始构建
你的 AI 助手

完全开源,Apache-2.0 协议,一键 Docker 启动,5 分钟跑通第一个 AI 对话。

Quick Start
# Clone repo
git clone https://github.com/matevip/mateclaw.git
cd mateclaw

# One-click start (Docker Compose)
docker compose up -d

# Open console
open http://localhost:8080