MateClaw 自部署多智能体 AI 操作系统完整指南
关于本站：第三方整理的中文文档站，非官方页面；内容来自公开资料整理，功能与界面以官方最新版为准。
MateClaw 是什么
MateClaw 是一整套可以自部署的 AI 操作系统。一个 JAR 包，一套登录，持久化数据和外发集成由你掌控。它把 Agent 引擎、知识库、记忆系统、工具治理、多渠道接入和安全审批放在同一个屋檐下，跑在你自己能摸到的硬件上。
和市面上大多数 AI 产品不同，MateClaw 不是单一功能的聊天框或工具执行器——它试图解决的是「AI 怎么在真实工作流里持续地、安全地、有记忆地干活」这个更大的问题。
产品档案速览
| 项目 | 说明 |
|---|---|
| 核心定位 | 自部署多智能体 AI 操作系统 |
| 技术栈 | Spring Boot 3.5 + Spring AI Alibaba 1.1 后端 / Vue 3 + TypeScript 前端 / Electron 桌面端 |
| 部署方式 | 桌面端安装包（自带 JRE 21）/ Docker Compose / 裸机 JAR |
| 数据源 | 开发/H2 文件数据库；生产/PostgreSQL 16；MySQL 8 与 KingbaseES 可选 |
| 模型支持 | DashScope、OpenAI、Anthropic、Gemini、DeepSeek、Kimi、MiniMax、智谱、OpenRouter、Ollama、ChatGPT Plus OAuth |
| 渠道 | Web、钉钉、飞书、企业微信、微信、Telegram、Discord、QQ、Slack 共九个 |
| 协议 | Apache 2.0 |
| 项目地址 | GitHub：mateaix/mateclaw |
三件和别的 AI 不一样的事
- 主动：它在该出现的时候自己出现——每天早上 9 点把简报推到飞书，竞品有大动作直接 ping 钉钉。不在浏览器 tab 里等你。
- 会做梦：你睡了它跑一次整合，把今天零散的对话整合成对你的理解。第二天从昨天结束的地方继续，不是从零开始。
- 可审批：Agent 想删文件、发邮件、写数据库——触发 Tool Guard 规则就在回合中途暂停，审批请求推到 IM，你点批准它才接着跑。
结构导览
下面是十个分组，每个分组聚焦 MateClaw 的一个能力面。从哪一组开始取决于你想做什么。
刚拿到手想跑起来 → 启动与部署 / 桌面端 60 秒启动
想搞清楚 Agent 引擎怎么工作 → Agent 引擎 / ReAct 思考行动观察循环
好奇「会做梦」的记忆系统 → 知识库与记忆 / Dreaming 睡眠整合
想让 AI 在飞书、钉钉里主动找你 → 主动型AI与多渠道 / AI 找你不是你找 AI
担心安全问题 → 安全与审批 / Tool Guard 基于规则的权限
想自己造技能或接 MCP 服务 → 技能与外部能力 / SKILL.md 技能包协议
卡在某个错误上 → 运维与排查 / 端口冲突排查