自部署 AI 操作系统——把多智能体放回你自己的机器

一句话定义

MateClaw 是一整套可以自部署的 AI 操作系统。一个 JAR 包，一套登录，持久化数据和外发集成由你掌控。

说它是「操作系统」而不是「助手」，是因为它把 Agent 引擎、知识库、记忆、工具治理、渠道、安全、定时调度、审计日志全部装在同一个进程里——不是一个聊天框外挂了几个功能，而是一个有边界、有记忆、有执行器、有权限控制的完整运行时。

为什么自部署这件事重要

把 AI 跑在自己的机器上，不是合规打个勾那么简单。它改变的是这个产品到底是什么。

你掌控数据与外发边界

对话、日志、文档和记忆持久化在自己的部署中。只有完成任务所需的内容会发送到你主动配置的云模型、IM 渠道、MCP 或其他工具服务。需要完全本地处理时，可以组合本地模型与本地工具，并关闭外部集成。

路线图是你的

记忆整合的规则你不喜欢？自己改。需要一个厂商不给你做的工具？自己加。Apache 2.0 协议，不是 source available，不是 open core——不用等别人的季度产品评审。

账单是你自己算的

一开始上 DashScope，等本地 GPU 到了就切 Ollama，某个高价值 Agent 单独挂 OpenAI，其他的走便宜的。Agent 配置和工具图不关心底下的模型接口是什么。

部署面是实打实的

一个 JAR 包。一个 Spring Boot 进程。运行服务不要求额外安装 Python 或 Node。桌面端自带 JRE，Docker Compose 一条命令启动 PostgreSQL、SearXNG 与服务端。

底下是什么

MateClaw 的技术选型偏务实，追求「一个进程能跑完整套服务」：

• 后端：Spring Boot 3.5 + Spring AI Alibaba 1.1。Agent 运行时是一张 StateGraph，reasoning、action、observation、plan generation、step execution 都是图上的节点。MyBatis Plus 持久化。流式走 SSE。
• 前端：Vue 3 + TypeScript。Pinia 管状态，Element Plus + Tailwind 做 UI，支持深色模式。前端 build 的产物直接进后端 JAR 的 static/，一个进程服务两端。
• 桌面端：Electron 包 JRE 21 + 后端 JAR。双击启动，用户完全不需要知道底下跑的是 Java。
• 存储：开发与桌面端默认使用 H2 文件数据库；公开 Docker 栈默认使用 PostgreSQL 16；MySQL 8 profile 继续支持。Flyway 按数据库方言管理 schema 迁移。