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 1.6.0 · 可验证自主 · 知识自维护

MateClaw

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

把 Agent 的自主行为变得可验、可恢复，Wiki 知识自维护并连成图谱，长期记忆按使用者隔离。一个 JAR 跑起控制台、模型、工具、渠道和审计，数据不必离开你的部署边界。

60 秒跑起来阅读文档

一个 OS，覆盖全能力

Agent、Wiki、记忆、工具、渠道、模型同一内核

一个 JAR，自部署落地

$ docker compose up -d

✓ http://localhost:18080

admin / admin123

Docker / JAR / 桌面端，60 秒跑起来

自主闭环，数据不出门

目标→执行→工具→记忆，全在你的边界内

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

目标会自己扛住卡点，知识连成图谱，记忆按人隔离还自己控量，工具、模型和渠道都在控制台里看得见。

GOALS

自主执行，卡住也能自己爬起来

目标用 criteria checklist 逐条裁决，全勾完才算完成。撞到迭代上限会硬延续、某步卡死会自动重规划、停滞会被检测并打断；多步计划还能按步委派给专职员工，在 Agents 看板上实时看进度。

criteria checklist硬延续 / 重规划按步委派计划看板

WIKI

知识库自维护，还连成知识图谱

Wiki 页面带 pageType、读写权限和处理流水线，改名 / 删除 / 坏链会级联自修。入库还会抽出人、组织、事件的实体知识图谱，类型可自定义；聊天回答里的 [n] 引用可点击，直跳对应页面。

实体知识图谱可点 [n] 引用自定义实体类型stale 传播

MEMORY

记忆认人，还自己控量

owner_key + PERSONAL / TEAM / GLOBAL 控制可见性，个人偏好不会串到别人会话里。always-on 记忆还有注入预算、夜间巩固和文件上限三道闸，常驻上下文不会无限膨胀。

owner_key 隔离注入预算夜间巩固文件上限

SKILLS · MCP · ACP

一句话造员工，能力按需装

一句话描述就能生成一个数字员工，工具 / 技能 / 知识库从真实目录反查、不会幻觉。聊天里用 /skill 精准加载技能，MCP 接外部工具、ACP 接编码员工，Tool Guard 和审批给高风险动作留边界。

一句话造员工/skill 菜单MCP / ACPTool Guard

CHANNELS

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

Web、桌面端、企业 IM 和可嵌入网站的 WebChat 统一接入。飞书 / 钉钉 / 企微 / 微信 / Telegram / Discord / Slack 走统一媒体管线，图片、语音、文件不再各写一套。

可嵌入 WebChat8 个 IM 渠道统一媒体管线ChannelAdapter

MODELS

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

会话钉选、Agent 覆盖、全局默认之后，才进入偏好提供商路由。Claude Opus 4.8 / Fable 5、GLM-5.2 等几十个供应商即插即用，健康检查、工具调用详情和生成文件落盘都看得见。

Opus 4.8 / Fable 5GLM-5.2偏好提供商执行详情

Quick Start

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

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

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

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

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

git clone https://github.com/mateaix/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/mateaix/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 知识库

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

技能管理 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、执行详情和生成文件落盘

v1.6.0 当前版本

国产数据库与多感官

人大金仓 / PostgreSQL 家族、跨轮次图片 + image_analyze、execute_code、AGENTS.md 编辑器、Wiki Sources 标签、全局出站代理、Claude Fable 5

Next 下一步

看板、知识图谱与记忆控量

计划看板 + 按步委派、循环鲁棒（硬延续 / 重规划 / 停滞检测）、Wiki 实体知识图谱 + 可点引用、记忆注入预算、一句话造员工向导、GLM-5.2