v1.0.0

Released: 2026-03-20

Initial release of MateClaw — a Java + Vue 3 personal AI assistant system built on Spring AI Alibaba.

Agent Engine

ReAct Agent — Thought → Action → Observation loop with tool calling and multi-step tasks
Plan-and-Execute — Automatic task decomposition into ordered sub-steps with verification
StateGraph Unified Engine — Unified streaming and state management architecture
Multi-Agent Collaboration — Agent-to-agent delegation tool for inter-agent cooperation
Agent Workspace — Markdown-based system prompt management

Multi-provider — DashScope, Ollama, OpenAI, Kimi, DeepSeek, Zhipu, Anthropic/Claude and 15+ providers
Model Discovery & Connection Test — Auto-discover remote models + connectivity check
Thinking Models — Kimi K2.5 thinking display + typewriter effect
GPT-5 Compatibility — Auto-remove tools when conflicting with reasoning_effort
ModelFamily Adaptation — gpt-5 max_tokens → max_completion_tokens auto-conversion

Built-in Tools — WebSearch, DateTime, ShellExecute, file operations, etc.
MCP Protocol — Dynamic MCP Server connections and tool integration (stdio + SSE)
ToolGuard Security Engine — 3-tier decision (auto-allow / human-approval / auto-deny)
Human-in-the-Loop (HITL) — User confirmation before sensitive tool execution, with persistence
Cross-platform Commands — Windows compatibility + proper timeout enforcement

SKILL.md Protocol — Define, upload, and install skills
Skill Runtime — Full SkillMarket integration, auto-sync built-in skills on startup
Security Scanning — Layered security policy + dependency declaration & runtime checks
Built-in Skills — docx/pdf/pptx/xlsx/himalaya document processing

Web — SSE streaming, drag-and-drop file upload (including directories), 100MB limit
DingTalk — Stream persistent connection, event flow and rendering separation
Feishu — WebSocket persistent connection + dynamic permission prompts
WeChat Work — WebSocket persistent connection (replacing HTTP callback)
Telegram — Long-Polling mode + proxy support
Discord — Gateway WebSocket + media upload fallback + proxy support
QQ Bot — WebSocket persistent connection
Channel Icons — SVG brand icons, session list shows source channel

Vue 3 + Element Plus + TailwindCSS — Pinia state management, dark mode
Chat — Multi-message queue, thread safety, message ordering, streaming loading bar
Tool Approval UI — Approval actions inline in the input area
Token Usage — Collection, persistence, query and display
Workspace File Management — File system browser with document seed data

Spring Security + JWT — Authentication and authorization
MyBatis Plus ORM — camelCase auto-mapping, logical delete
H2 / MySQL / MariaDB — H2 for dev, MySQL 8.0+ and MariaDB 10.11 for production
Auto Database Detection — MySQL/MariaDB specific SQL files, auto-detect on startup
SpringDoc OpenAPI — Replaced Knife4j, API documentation
Cron Jobs — Scheduled task management