开场
MateClaw(GitHub · Gitee)——基于 Java + Spring Boot + Vue 3 的开源 AI 操作系统——今天发布 v1.1.0。这是 1.x 系列最大一次更新:98 个 commit,25 项特性,44 项修复。
1.0 做了一套完整皮肤。1.1 把"跑起来真的像那么回事"这件事做完——聊天回复在每一个渠道实时流式呈现,长任务切换会话后继续在后台跑完,Wiki 变成真正的语义检索引擎,而且 agent 第一次可以给自己写技能。
本次发布的重点(6 件事)
1. Agent 开始给自己写技能(Auto Skill Synthesis)
这可能是整个 1.1.0 里最大的那件事。
当 agent 发现自己反复在做一类任务——某种数据库查询套路、一种报表格式、一段 SSH 到服务器的命令序列——它会主动提议把这段经验变成一个 skill,走你设置的审批流,存下来,下次复用。
不再需要你一遍一遍"记住我喜欢这个格式"。Agent 的记忆和你一起生长。
2. 多 Agent 并行协作
一个 agent 可以把任务委派给另一个——或者同时委派给三个。让代码 agent 处理 Jira,同时让研究 agent 拉竞品,同时让写作 agent 起草 Slack 回复。每个在独立会话里跑,结果流式回传给编排者。
-
delegateToAgent 和 delegateParallel 工具
-
子会话追踪 + 事件 relay,你能实时看到子任务进度
-
系统 prompt 里内置路由提示,主 agent 学会怎么拆分
3. Wiki 变成语义检索引擎
你喂给 Wiki 的那些 PDF,以后不再只是个搜索框。它现在是真正的检索引擎:
-
页面级 + chunk 级语义搜索——问"我们关于 auth 决定了什么"直接返回决策,不是一堆包含"auth"的页面
-
两阶段摘要:阶段 A 做路由和元信息,阶段 B 按页合并——大文档处理速度数量级提升(60+ 页并发)
-
每条原始素材独立进度条——看到 页数完成 / 总页数,不再盯着"处理中..."
-
可恢复:中途断掉,点"重新处理"只重跑未完成的页
新增 wiki_search_pages(混合检索)、wiki_semantic_search(chunk 级)、wiki_read_page、wiki_trace_source 四个工具。Agent 可以直接调用。
4. 深度思考(Deep Thinking)
每个 agent、每次对话可以打开 Anthropic extended thinking / DashScope qwq 推理 / OpenAI o1 级别的 reasoning_effort。设置 thinkingLevel: off / low / medium / high / max。
思考块流式进入 UI,做成可折叠面板——你看得见模型在怎么想,也不会把 token 烧在不需要推理的闲聊上。
5. ChatConsole 重新做,真正多渠道
"实时看着外部 IM 会话发生"这件事是新的。这也是 MateClaw 从"一个 web 应用"变成"运营控制台"的那条分界线。
-
外部渠道实时同步——WeChat 用户在和你的 agent 聊天,你能在 ChatConsole 侧栏同步看到推理、工具调用、流式回复。不用 F5
-
运行指示器——正在跑 agent 的会话图标上有琥珀色脉冲
-
切换不踩死——切到别的会话时,上一个在后台继续跑;切回来,重连到活跃 buffer
-
不再重复气泡——reconcile 层通过 ID 提升把前端流式 placeholder 和后端落库的 assistant 消息匹配为同一条
-
错误卡可操作——Ollama "不支持工具调用" 现在显示具体中文指引("请切换到 qwen3 / qwen2.5:7b+ / llama3.1:8b+"),不再是"未知错误"
6. 其他产品级升级
-
所有 IM 渠道支持语音输入——WeCom / 个人微信 / 钉钉统一走 DashScope 或 OpenAI Whisper 做 ASR,回复走 TTS 合成后以音频消息发回。微信加密 CDN 的语音有三路回退
-
Anthropic prompt 缓存——系统 prompt、agent 人格、工具定义自动带上 cache_control: ephemeral,Dashboard 新增缓存命中维度统计
-
声明式 Hook 系统——5 个生命周期钩子(before_tool / after_tool / before_llm / after_llm / on_error),工具守卫规则现在就是一种 Hook
-
插件 SDK——第三方不用 fork 就能扩展,放个 JAR 到 plugins/ 目录就能发现加载。ChannelAdapter / Tool / MemoryProvider / Hook 都有 SPI
-
嵌入模型 UI 可配——不用再配 EMBEDDING_API_KEY 环境变量,嵌入模型和 chat 模型一起在"设置 → 模型"里管理
运维层的硬化
给已经在生产跑 MateClaw 的团队:
-
MySQL 迁移脚本修复 — 所有使用 MariaDB 语法的 ALTER TABLE ADD COLUMN IF NOT EXISTS 改写成 INFORMATION_SCHEMA + 预处理语句。全新 MySQL 8.x 部署跑通,已有用户通过 FlywayRepairConfig 自愈(Gitee #IIYHLJ)
-
首次连接自动建库 — 不用再手动 CREATE DATABASE mateclaw
-
Docker compose 不接受默认密码启动 — 未设置 DB_PASSWORD / DB_ROOT_PASSWORD / DASHSCOPE_API_KEY → docker compose up 直接拒绝启动并给明确错误信息。原来硬编码的 mateclaw123 没了
-
微信 / 企业微信长连接重建(RFC-024) — pollLoop 看门狗、抖动指数退避、token 跨重启持久化、语音 ASR 三路回退覆盖微信 CDN 的各种加密方式
-
防御性硬化(RFC-025) — 日志里工具参数脱敏 / Stream fallback 定时器 / 审批占位超时清理 / Agent 实例缓存配置变更失效 / 渠道 adapter 陈旧连接驱逐
60 秒体验
git clone https://github.com/matevip/mateclaw.git
cd mateclaw/mateclaw-server
mvn spring-boot:run # http://localhost:18088
默认登录:admin / admin123
Docker 部署:
cp .env.example .env # 务必填写必填项(强制校验)
docker compose up -d # http://localhost:18080
桌面端从 GitHub Releases 下载,内嵌 JRE 21,无需额外装 Java。
在线体验:claw-demo.mate.vip完整文档:claw.mate.vip/docs
从 1.0.x 升级
大部分用户无需手工操作:
生产部署者必须在 .env 里设置:
|
变量
|
说明
|
必填
|
|
DB_PASSWORD
|
强密码,不能是 mateclaw123
|
✅
|
|
DB_ROOT_PASSWORD
|
MySQL root 密码
|
✅
|
|
DASHSCOPE_API_KEY
|
或其他主 LLM 厂商 key
|
✅
|
|
JWT_SECRET
|
JWT 签名密钥
|
推荐
|
|
MATECLAW_CORS_ALLOWED_ORIGINS
|
允许的跨域来源
|
推荐
|
详细步骤见仓库根目录 UPGRADING.md。
下一步去哪
v1.2 正在路上,聚焦 RFC-026(channel tunnel / 统一队列 / skill 修复) 和更深的 agent 自主性。也已在密集做多模型失败转移和 provider health tracking 相关的改造——那是 1.2 的故事,敬请期待。
链接
Apache 2.0。无 token 计费,无座位收费。你的服务器、你的数据、你的 Key。