StackMap
Subscribe
Explore / mateclaw
mateaix

mateclaw

Self-hosted Java agent platform: ReAct plus plan-and-execute 'digital employees' with an LLM Wiki knowledge layer, skills/MCP/ACP tools, approval-gated actions and eight IM channels in one JAR.

1,039 318 Java Apache-2.0updated today
View on GitHubDispute this mapping →
Curator's take

Pick it when the buyer is an IT department rather than a hacker: multi-user workspaces, RBAC and approval gates on sensitive tool calls, audit trail, Spring Actuator health, per-channel error isolation, and provider failover across DashScope/OpenAI/Anthropic/Gemini/DeepSeek/Ollama when a vendor 401s mid-request. Underneath it's a real harness — StateGraph runtime, Team Runs with a durable runId, task DAGs, human approval — not a RAG call in a wrapper. The cost is weight and gravity: Java 21 + Spring Boot 3.5 + Vue, an enormous and fast-moving feature surface (workflows, triggers, Wiki transformations, Dream consolidation, skill mining), and a China-first channel set (DingTalk, Feishu, WeChat Work, QQ) whose value drops sharply outside that ecosystem. For a personal agent on a $5 VPS this is orders of magnitude too much machinery.

Mapped by ShipWithAI editors · links verified
README.md

MateClaw Logo

MateClaw

Your second brain

Agent Harness · Spring Boot inside · One JAR to ship

GitHub Repo Documentation Live Demo Website Java Version Spring Boot Vue Last Commit License

[Website] [Live Demo] [Documentation] [中文]

MateClaw Preview


Latest stable: v2.1.0 — Team Runs, closed skill evolution, and replayable reasoning. One team request is now one durable runId across Chat, Agents, and Teams; skills can mine recurring requests under explicit controls and restore from snapshots; reasoning, tool calls, and observations can be exported in execution order. Read the v2.1.0 release notes.


Other personal AI agents are built for one person. MateClaw is the one your IT department can actually sign off on.

Multi-user workspaces. Approval-gated sensitive actions. Full audit trail. Spring Boot Actuator health monitoring. Per-channel error isolation so one chat platform's outage doesn't take down the rest. One JAR in your environment; you control persisted data, and task content is sent only to model, channel, or tool services you explicitly configure.

And underneath, a real agent harness. ReAct + Plan-and-Execute on a StateGraph runtime — not a one-shot RAG call dressed up. Tools, Skills, MCP, and ACP converge on one registry with per-employee binding. Sensitive tool calls flow through an approval gate you can actually inspect. Multi-vendor failover keeps the loop running when a provider doesn't.

Most AI tools die when their vendor has a bad day. Most forget you the moment the tab closes. Most give you a chatbox and call it a product.

MateClaw is the whole widget. One deployment. Reasoning, knowledge, memory, tools, channels — built together, not bolted on. And when your primary model is unavailable, the next healthy provider retries the current request.


Three things that make it different

1 · Your AI doesn't die when a model does

Primary key expired. Vendor returns 401. Network blip. Quota drained.

Other tools hand you a red error card. MateClaw tries the next healthy provider in configured order — including built-in and OpenAI-compatible options such as DashScope, OpenAI, Anthropic, Gemini, DeepSeek, Kimi, Ollama, LM Studio, and MLX — and attempts to recover the current request. It returns an error only when the available chain is exhausted. A provider health tracker parks bad vendors in a cooldown window so they don't waste seconds on every turn.

You don't write a retry script. You drag providers into priority order in Settings → Models and watch the health dashboard fill with gr

Continue your stack

What teams reach for next — and why each earns a place beside mateclaw. Ranked by curator confidence.