mateaix/mateclaw

MateClaw – 엔터프라이즈급 AI 에이전트 플랫폼

개요 – MateClaw는 팀이 "디지털 직원"을 만들고, 실행하고, 관리할 수 있는 자체 호스팅 Java 기반 플랫폼입니다. 각 직원은 역할, 목표, 배경 스토리, 그리고 호출할 수 있는 도구 세트를 가진 AI 기반 에이전트입니다. 시스템은 완전한 백엔드(Spring Boot 4, Spring AI, AgentScope)와 Vue 기반 관리 UI, 그리고 선택적 데스크톱, 웹 위젯, IM 채널 클라이언트를 번들로 제공합니다.

주요 기능

• 다중 공급업체 모델 장애 조치 – LLM 공급업체(OpenAI, Anthropic, Gemini, DeepSeek, Ollama 등)의 우선순위 목록을 구성합니다. 기본 모델을 사용할 수 없는 경우 요청은 자동으로 다음 정상 공급업체로 라우팅되며, 상태 추적 및 냉각 시간이 적용됩니다.
• LLM-Wiki 지식 베이스 – PDF, 마크다운, 웹 페이지 등을 업로드합니다. 시스템은 이를 에이전트 프롬프트에 주입되는 인용이 포함된 연결된 Wiki 페이지로 파싱합니다.
• 영구적이고 체크포인트된 목표 – 장기 실행 작업은 데이터베이스에 저장됩니다. 충돌 후 런타임은 마지막 체크포인트에서 재개하며 모든 검증 검사를 통과한 경우에만 목표를 완료합니다.
• 팀 실행 및 워크플로 DSL – 여러 에이전트와 시스템 작업(승인, 채널 디스패치, 메모리 쓰기)을 7가지 단계 모드(순차, 팬아웃, 조건 등)가 있는 JSON 우선 워크플로로 구성합니다.
• 확장 가능한 도구 – SKILL.md 패키지, MCP(stdio/SSE/HTTP) 및 ACP 브리지를 사용하여 사용자 지정 도구를 추가하거나 Claude Code와 같은 외부 코딩 에이전트를 연결할 수 있습니다.
• 엔터프라이즈 기능 – RBAC, JWT, 개인 액세스 토큰, 감사 추적, 분산 크론 잠금, Flyway 관리 스키마, 채널별 오류 격리.
• 다중 프런트엔드 – 웹 관리 콘솔, Electron 데스크톱 앱(JRE 21 포함), 임베드 가능한 채팅 위젯, DingTalk, Feishu, WeChat Work, 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 UI(npm install && npm run dev).
• 또는 제공된 Docker Compose(docker compose up -d)를 사용합니다.
• 데스크톱 바이너리는 임베디드 JRE가 포함된 단일 JAR로 제공됩니다.

대상 고객 – 중앙 관리형 AI 에이전트 계층, 다중 사용자 액세스, 감사 가능성, 모델 중단에 대한 생존 능력이 필요한 Java 중심 엔터프라이즈. 이것은 단순한 챗봇이 아니라 AI 기반 디지털 동료를 구축하기 위한 확장 가능한 "세컨드 브레인" 플랫폼입니다.

---

TL;DR – MateClaw = 자체 호스팅 Spring Boot 기반 AI 에이전트 런타임으로, 다중 모델 장애 조치, 지식 베이스 수집, 영구 목표, 워크플로 오케스트레이션, 엔터프라이즈급 보안을 갖추고 있으며 웹, 데스크톱, 위젯 및 다양한 IM 채널을 통해 제공됩니다.