MateClaw 是什么？What is MateClaw?

MateClaw 是一个开源的自部署团队 AI 操作系统，基于 Spring AI Alibaba 构建。它集成了 ReAct + Plan-and-Execute、Goals checklist 确定性验收、LLM Wiki 自维护、per-owner 记忆隔离、MCP/ACP 工具协议和多渠道运行治理。一个 JAR 包部署，数据完全私有。

MateClaw 和 Dify、LobeChat 有什么区别？

MateClaw 是完整的团队 AI 操作系统，而非单纯的聊天界面或工作流编排器。它把目标验收、知识维护、记忆边界、工具审批、模型路由和渠道运行放在同一个可审计控制台里。

MateClaw 支持哪些部署方式？

三种方式：1) 桌面端双击运行（内置 JRE 21，60 秒到第一条消息）；2) Docker Compose 一键部署（18 行配置）；3) 源码构建（mvn spring-boot:run）。支持 Windows、macOS、Linux。

MateClaw dark dashboard showing agents, providers, and system status

MateClaw 1.5.0 · 可验证自主 · 知识自维护

MateClaw

把团队 AI 放回你自己的机器里。

1.5.0 让 Agent 的自主行为有清单可验、Wiki 知识会自我维护、长期记忆按使用者隔离。一个 JAR 跑起控制台、模型、工具、渠道和审计，数据不必离开你的部署边界。

目标清单逐条裁决 Wiki 事实 / 经验分层 per-owner 记忆可见性 ACP / MCP / 多渠道接入

60 秒跑起来阅读 1.5 文档

1.5.0

当前发布线

知识库示例

已安装技能

已连接渠道

1.5.0 Highlights

不是把功能堆高。
是让 AI 真正可用、可管、可验证。

首页现在对齐 1.5.0：目标完成有确定依据，知识会自维护，记忆按人隔离，工具、模型和渠道都能在控制台里被看见。

GOALS

自主行为有清单可验

目标不再靠一个分数猜完成。1.5.0 会生成 criteria checklist，执行后逐条裁决；全勾完才完成，未通过项会直接变成下一轮跟进提示。

criteria checklistbootstrap / verdictEvaluator SPI确定性完成

WIKI

知识库会自我维护

Wiki 页面有 pageType、读写权限、处理流水线和本地目录 watcher。改名、删除、坏链、陈旧事实都会传播，不再只是一堆向量碎片。

pageType 档案事实 / 经验分层stale 传播目录 watcher

MEMORY

记忆开始认人

endUserId 进入记忆链路，owner_key + PERSONAL / TEAM / GLOBAL 控制可见性。团队共享知识还在，个人偏好不会随便串到别人会话里。

owner_key三档可见性endUserId默认开启隔离

SKILLS · MCP · ACP

能力按需装，调用有边界

聊天里可以用 /skill 精准加载技能；MCP 接外部工具，ACP 把编码 Agent 接进来。Tool Guard 和审批工作流让高风险动作留下明确边界。

/skill 菜单MCP 动态工具ACP 编码员工Tool Guard

CHANNELS

同一个大脑，进到团队现场

Web、桌面端和企业 IM 统一接入。飞书最近文件能跟会话关联；微信和企业微信走统一媒体管线，图片、语音、文件不再各写一套。

飞书最近文件微信 / 企微媒体Telegram / SlackChannelAdapter

MODELS

模型路由和治理在同一张控制台

会话钉选、Agent 覆盖、全局默认之后，才进入偏好提供商路由。Claude Opus 4.8、健康检查、工具调用详情和生成文件落盘，都能被运维看见。

Opus 4.8偏好提供商执行详情生成文件落盘

Quick Start

自己动手，
几分钟跑起来。

一条命令，或双击桌面应用。数据全程留在你机器上。

生产推荐方式。一条 docker compose 命令，附带 MySQL 数据库，端口 18080 直接开用。

curl -fsSL https://raw.githubusercontent.com/matevip/mateclaw/main/.env.example -o .env# 编辑 .env：设置 DB_PASSWORD / DB_ROOT_PASSWORD / JWT_SECRETdocker compose -f https://raw.githubusercontent.com/matevip/mateclaw/main/docker-compose.yml up -d# 打开 http://localhost:18080  ·  admin / admin123

开发者首选。本地启动后端 + 管理控制台，热重载、H2 文件库、零外部依赖。

git clone https://github.com/matevip/mateclaw.git && cd mateclawexport DASHSCOPE_API_KEY=your-keycd mateclaw-server && mvn spring-boot:run    # 后端在 :18088cd ../mateclaw-ui && pnpm install && pnpm dev # 控制台在 :5173

已经有 JDK 21、Maven 和 pnpm 的机器，从源码打包 JAR 后直接运行。

git clone https://github.com/matevip/mateclaw.git && cd mateclawcd mateclaw-ui && pnpm install && pnpm build && cd ..mvn -pl mateclaw-server -am clean package -DskipTestsexport DASHSCOPE_API_KEY=your-keyjava -jar "$(ls -1 mateclaw-server/target/mateclaw-server-*.jar | grep -v sources | head -n 1)"

完整文档遇到问题？提 Issue 默认账号 admin / admin123

How it works

四层架构。
每一层都能独立站住。

多智能体编排在最上面，知识和记忆在中间，工具和安全护栏在底层，全渠道触达贯穿始终。这不是堆砌功能——是一个完整系统的四个层次。

LAYER 1

目标循环

ReAct 和 Plan-and-Execute 负责执行，Goal criteria checklist 负责验收。每条标准都有 verdict，全通过才结束，未通过项进入下一轮跟进。

ReAct 循环 Plan-and-Execute criteria verdict 确定性完成

LAYER 2

知识引擎

LLM Wiki 不只做检索：页面有类型档案、权限、处理流水线和本地目录知识源。事实和经验分层后，陈旧状态能沿引用关系传播。

pageType 处理流水线本地 watcher stale 传播

LAYER 3

身份化记忆

记忆召回带 owner 可见性，PERSONAL / TEAM / GLOBAL 三档控制共享边界。Chat 的 endUserId 会一路透传到记忆链路。

owner_key PERSONAL / TEAM / GLOBAL endUserId 隔离默认开启

LAYER 4

运行治理

模型路由、技能、MCP、ACP、渠道和工具审批都在运行时治理层统一暴露。管理员能看见系统正在用什么、为什么用、产物落在哪里。

会话钉选 Tool Guard 执行详情生成文件落盘

MateClaw 的重点不是多一个聊天入口，而是把目标验收、知识维护、记忆边界、工具审批和渠道运行放进同一个可审计系统。

Product proof

这些不是 mockup。
是真实本地控制台截图。

使用本地 localhost:5173 管理后台实拍，覆盖 Dashboard、Chat、Agents、Wiki、Skills 和 Channels。

打开在线演示

运行总览 localhost:5173

运行总览

版本、Agent、Provider、工具和系统健康状态在 Dashboard 上直接露出。

聊天工作台 localhost:5173

聊天工作台

会话、Agent 选择、文件入口和推荐任务都在一个工作面里，适合真实团队每天反复使用。

员工管理 localhost:5173

员工管理

内置员工、执行模式、状态筛选和新员工入口在一个页面里，适合团队管理数字员工。

Wiki 知识库 localhost:5173

Wiki 知识库

知识库、文档数量、状态和类型一屏可扫，配合 1.5.0 的页面档案和处理流水线。

技能管理 localhost:5173

技能管理

技能包以可见资产管理，聊天里的 /skill 菜单从这里取得可用能力。

渠道连接 localhost:5173

渠道连接

Web、飞书、企业微信、微信、QQ 等渠道和健康状态集中管理。

Built out of

一个 JAR。就是这一个 JAR。

开源、可审计、一个进程、零隐藏依赖。每一块都能自己在生产里活下来。

Spring Boot 3

Backend

Spring AI Alibaba

Agent Graph

MCP Protocol

Tool SPI

Frontend

TypeScript

Type-safe

TailwindCSS 4

Styling

Element Plus

MyBatis Plus

ORM

MySQL 8

Database

Spring Security

Auth · JWT

SpringDoc OpenAPI

API Docs

Electron + JRE 21

Desktop

Release line

每一个版本，都往一个方向走。

7 个稳定发布 · 1 个当前版本 · 1 个下一步。重点始终是把 AI 放进可运行、可审计、可部署的系统里。

v1.0 已发布

稳定内核

JWT 认证、工作空间、任务运行时、管理控制台和一个 JAR 自部署底座成型

v1.0.101 已发布

多 Agent 协作

文件 / 文件夹拖拽、DelegateAgentTool、Ollama 自动发现和多 Agent 委派

v1.0.314 已发布

LLM Wiki 与多模态

结构化知识库、多模态生成 / 识别和 ChatGPT OAuth 接入进入主线

v1.0.418 已发布

治理与健康检查

工作空间隔离、规则式 Tool Guard、Doctor、Dashboard 和多层记忆运行时

v1.2.0 已发布

数字员工与技能骨架

角色 / 目标 / 背景故事、5 个职业模板、技能 manifest / LESSONS 自进化、ACP 编码员工和运行时控制台

v1.3.0 已发布

工作流与 Wiki 流水线

7 种 step mode、6 种触发器、Wiki 处理流水线、per-agent MCP 工具绑定、多模态旁路和文档生成工具

v1.4.0 已发布

持久化目标与企业协作

持久化目标、递归子员工委派、渐进式工具 / 技能披露、工作空间 RBAC 和飞书一等公民支持

v1.5.0 当前版本

可验证自主

Goals checklist、Wiki 自维护、per-owner 记忆、Opus 4.8、执行详情和生成文件落盘

Next 下一步

更细的运行观测

继续补强 Agent 执行链路、成本分析、渠道事件和企业部署诊断