MateClaw

定位与适用场景#

MateClaw 定位为上层编排与调度层，不涉及底层大模型的训练或微调，而是聚焦于多模型路由管控、RAG 知识消化与多端统一分发。适用于企业 AI 中台统一管控、多模型容灾调度、团队私有化知识库问答、多渠道统一智能客服，以及对数据安全有极高要求的私有化部署环境。

核心能力#

模型调度与容灾#

接入 DashScope、OpenAI、Anthropic、Gemini、DeepSeek、Kimi、Ollama、LM Studio、MLX 等 14+ 模型供应商。内置 Provider Health Tracker，持续监控各供应商健康状态，一旦检测到故障即触发冷却窗口，后续请求自动无缝路由至备用节点，保障业务连续性。

Agent 运行时#

基于 StateGraph 引擎，支持 ReAct（迭代式推理）与 Plan-and-Execute（复杂多步骤工作流）两种模式。具备动态上下文裁剪、智能截断与过期流清理能力，支撑长对话稳定性。

知识库（LLM Wiki）#

支持上传 PDF、Markdown、网页等原始材料，自动消化为结构化页面并构建 [[links]] 双向链接关系。问答结果由相关 chunk 拼接而成，每句话可点击追溯至原文，附带可验证引用。

工具、技能与 MCP 协议#

内置网页搜索、文件操作、记忆管理等基础工具。原生支持 MCP（Model Context Protocol）的 stdio / SSE / Streamable HTTP 三种传输方式。集成 ClawHub 技能市场（SKILL.md 技能包）。引入 Tool Guard 层，提供工具级 RBAC 权限控制、审批流与路径保护。

记忆系统#

维护 Workspace 记忆文件（AGENTS.md、SOUL.md、PROFILE.md、MEMORY.md、每日笔记）。实现"对话后提取 → 定时整合 → Dreaming 工作流"的完整生命周期。

多模态支持#

Text-to-Speech、Speech-to-Text、图像、音乐、视频均作为一等公民支持。

多渠道接入#

覆盖 Web Console（全功能管理后台）、Electron 桌面端（内置 JRE 21，无需安装 Java）、Webchat Widget（<script> 标签嵌入）及 8 大 IM 渠道：钉钉、飞书、企业微信、微信、Telegram、Discord、QQ、Slack。

企业级特性#

RBAC + JWT 认证、完整审计日志、Flyway 数据库自动迁移（升级时自动修复 schema）、Spring Boot Actuator 健康监控、单渠道错误隔离、单 JAR 部署。

架构与设计理念#

模块划分#

采用单体仓库结构：

• mateclaw-server：Spring Boot 3.5 后端核心（Spring AI Alibaba 1.1, StateGraph 运行时）
• mateclaw-ui：Vue 3 + TypeScript 管理后台 SPA（打包进服务端 JAR）
• mateclaw-webchat：可嵌入聊天组件库（UMD / ES bundles）
• mateclaw-plugin-api / mateclaw-plugin-sample：第三方插件开发体系

关键设计理念#

• "Whole widget" 哲学：推理、知识、记忆、工具、渠道在系统内部一体化构建，而非外部松散拼凑。
• Per-channel Error Isolation：单个 IM 渠道异常不会波及或阻塞其他渠道。
• Memory Lifecycle：通过自动化工作流沉淀结构化记忆。

安装部署#

本地开发#

cd mateclaw-server
mvn spring-boot:run           # http://localhost:18088
cd mateclaw-ui
pnpm install && pnpm dev      # http://localhost:5173
# 默认登录: admin / admin123

Docker#

cp .env.example .env
docker compose up -d          # http://localhost:18080

桌面应用#

从 GitHub Releases 下载，内置 JRE 21，双击运行。

待确认信息#

• ClawHub 技能市场独立 URL 未公开
• Live Demo 具体地址未显示
• Hugging Face 模型/数据集页面未提及
• 关联学术论文未找到