mateaix/mateclaw

MateClaw – 企业级AI智能体平台

产品简介 – MateClaw是一个自托管、基于Java的平台，允许团队创建、运行和管理“数字员工”。每个员工都是一个具有角色、目标、背景故事和一组可调用工具的人工智能驱动智能体。该系统捆绑了完整的后端（Spring Boot 4、Spring AI、AgentScope）和基于Vue的管理界面，以及可选的桌面、Web小部件和IM渠道客户端。

主要功能

• 多供应商模型故障转移 – 配置LLM提供商（OpenAI、Anthropic、Gemini、DeepSeek、Ollama等）的优先级列表。如果主模型不可用，请求将自动路由到下一个健康的提供商，并具有健康跟踪和冷却时间。
• LLM-Wiki知识库 – 上传PDF、Markdown、网页等；系统将它们解析为带引用的链接Wiki页面，并注入到智能体的提示词中。
• 持久化、检查点化的目标 – 长时间运行的任务存储在数据库中；崩溃后，运行时从最后一个检查点恢复，并且仅在所有验证检查通过后才完成目标。
• 团队运行和工作流DSL – 将多个智能体和系统操作（审批、渠道分发、写入记忆）组合成JSON优先的工作流，具有七种步骤模式（顺序、扇出、条件等）。
• 可扩展工具 – SKILL.md包、MCP（stdio/SSE/HTTP）和ACP桥接让您可以添加自定义工具或接入外部编码智能体，如Claude Code。
• 企业功能 – RBAC、JWT、个人访问令牌、审计跟踪、分布式cron锁、Flyway管理的架构以及按渠道的错误隔离。
• 多前端 – Web管理控制台、Electron桌面应用（捆绑JRE 21）、可嵌入的聊天小部件，以及钉钉、飞书、企业微信、Telegram、Discord、Slack等集成。

工作原理

1. 智能体运行时 – 本地Java AgentScope循环（ReAct、计划与执行）或外部DSH JSON-RPC运行时。两者都公开相同的事件模型（思考、工具使用、回答、使用量、取消）。
2. 工作区 – 每个团队都有一个工作区目录；上传的材料被消化到LLM-Wiki中并存储在数据库中。
3. 执行 – 当用户发送请求时，选定的智能体运行，可能通过工具防护（RBAC+审批）调用工具，并更新其记忆文件（MEMORY.md、PROFILE.md等）。长任务被检查点化；监督服务在重启后协调中断的运行。
4. 可观测性 – 管理运行时控制台显示每个员工的实时状态、令牌使用量，并允许操作员强制回收卡住的运行。

开始使用

• 使用Maven运行后端（mvn -pl mateclaw-server spring-boot:run）和Vue界面（npm install && npm run dev）。
• 或使用提供的Docker Compose（docker compose up -d）。
• 桌面二进制文件作为带有嵌入式JRE的单个JAR提供。

目标受众 – 需要集中治理的AI智能体层、多用户访问、可审计性以及应对模型中断能力的以Java为中心的企业。它不是简单的聊天机器人；它是一个可扩展的“第二大脑”平台，用于构建由AI驱动的数字同事。

---

TL;DR – MateClaw = 自托管的基于Spring Boot的AI智能体运行时，具有多模型故障转移、知识库摄取、持久目标、工作流编排和企业级安全性，通过Web、桌面、小部件和许多IM渠道公开。