MateClaw v1.5.0 已发布。

这一版的重点不是“多接一个模型”或“多加几个按钮”，而是继续补齐 Agent 在真实团队里运行时需要的基础能力：目标要能验收，知识库要能维护一致性，记忆要能区分不同使用者。

如果用一句话概括 v1.5.0：

把 Agent 从“能继续干活”推进到“能按清单收尾、按知识关系维护上下文、按用户身份隔离长期记忆”。

本次更新主线

v1.5.0 主要做了三件事：

1. Goal checklist：目标不再只靠完成度分数，而是拆成可逐条验证的验收准则。

2. LLM Wiki 自维护：Wiki 支持页面互联、坏链扫描、事实/经验分层、pageType 权限、流水线和本地知识源同步。

3. Memory per-owner 隔离：同一个 Agent 服务多个用户时，个人记忆不再混在一起。

除此之外，本版还包含员工主知识库、模型偏好提供商路由、Claude Opus 4.8 模型条目、生成文件落盘、MCP 超时调整、飞书文件跟进、微信/企微媒体管线等改进。

1. Goal Checklist：从完成度评分到验收清单

v1.4.0 已经支持持久化 Goal、预算、自动评估和 auto-followup。但完成度分数有一个明显问题：0.8 到底代表什么？是还差部署，还是测试没过，还是文档没写？

v1.5.0 把 Goal 改成 checklist。

一个目标可以被拆成多条独立准则，例如：

目标：完成一篇技术文章上线
​
准则：
1. 文章正文已完成
2. 本地构建通过
3. 已部署到生产环境
4. 首页访问验证通过

系统里 evaluator 分成两种模式：

模式	触发时机	作用
bootstrap	目标还没有准则时	把目标拆成 checklist
verdict	目标已有准则时	逐条判断准则是否通过，并记录证据

完成判定也更明确：只有所有准则都通过，目标才算 completed。如果 4 条完成了 3 条，就继续停留在 active，而不是靠一个模糊阈值提前结束。

这一点对自动跟进尤其重要。开启 auto-followup 后，系统会把“剩余未通过准则”明确注入下一轮，而不是只让 Agent 笼统地“继续”。

本版新增：

• addGoalCriterion 工具：运行中的目标可以追加准则；

• POST /api/v1/goals/{id}/criteria：通过 API 追加准则；

• 创建 Goal 时可直接传入 criteria；

• mateclaw.goal.default-auto-followup；

• mateclaw.goal.allow-auto-followup；

• mateclaw.goal.max-followups-per-run。

下图是 v1.5.0 实际运行界面中的 Goal 执行链路，可以看到 Set Goal、Progress Update、Write File 等工具调用和目标推进过程。

2. LLM Wiki：从知识库到知识引擎

LLM Wiki 是 v1.5.0 工程量最大的一部分。

常规 RAG 系统通常围绕“文档切块、向量检索、召回增强”展开。MateClaw 的 LLM Wiki 更强调结构化页面、页面关系和可维护性。v1.5.0 继续往这个方向推进。

2.1 Wikilink：页面之间可以互联

Wiki 页面正文支持：

[[slug]]
[[slug|显示文字]]

这不是简单的 Markdown 展示，而是带维护能力的链接系统：

• slug 优先解析，避免模糊匹配造成误连；

• 代码块和行内代码里的 [[...]] 不会被识别成链接；

• 页面改名时，同一事务里级联改写旧链接；

• 页面删除时清理引用；

• 坏链扫描结果可持久化；

• 聊天回答中的 wikilink 可以点击跳转到目标页。

对长期维护知识库来说，改名、删页、坏链扫描这些能力比“能不能显示链接”更关键。

2.2 Fact / Experience：知识分层与失效传播

v1.5.0 给 Wiki 页面增加了知识层：

层级	含义
fact	事实层，描述基础事实
experience	经验层，描述总结、分析、判断和经验

经验页可以依赖事实页。当事实页更新后，依赖它的经验页会被自动标记为 stale，提醒需要复核。

这解决的是知识库里很常见的问题：事实变了，结论却还停留在旧版本。v1.5.0 开始把这种“结论可能过期”的状态显式暴露出来。

新增工具：

• wiki_stale_pages：列出待复核页面；

• 搜索支持按知识层过滤。

2.3 PageType Profile：给页面类型加 schema、模板和权限

每个知识库可以配置 pageType profile，用来定义页面类型。例如：

• 概念；

• 教程；

• 决策记录；

• 产品说明；

• 事故复盘。

每种 pageType 可以配置：

• 结构化字段 schema；

• route/create/merge 阶段提示词；

• Markdown 模板；

• 元数据校验状态。

同时，v1.5.0 支持按“员工 + 知识库 + 页面类型”设置权限：

权限项	说明
read	是否可读
create	是否可新建
update	是否可修改
delete	是否可删除
writePolicy	allow、approval_required、deny

写权限的设计是偏保守的：如果某个 KB 没配任何 pageType 规则，保持旧行为；一旦开始配置规则，没有匹配到的页面类型默认拒绝写入。这对企业知识库更符合 fail-safe 思路。

2.4 Wiki Pipeline：知识库可以自动跑流程

v1.5.0 增加 Wiki Pipeline。它可以在页面事件发生后自动触发流程。

支持的触发器包括：

• page_type_count：某类页面数量达到阈值；

• page_created：新建页面；

• stale_marked：页面被标记为待复核。

支持的步骤执行器包括：

• llm：调用模型处理；

• skill：调用受限技能。

每次运行和每个步骤都会持久化记录，并按 (definition, trigger, subject, bucket) 去重，避免重复触发。

这让 Wiki 不只是“存知识”，还可以在知识变化后自动触发总结、复核、归档、通知等流程。

2.5 Ingest-Source SPI：本地目录可作为知识源

v1.5.0 把知识源做成可插拔接口，内建文件系统实现。

配置 source_directory 后，可以把本地目录挂到知识库上，后台按内容哈希做定时增量同步。新增或变更的文件会被重新吸入，未变化的文件不会重复处理。

安全策略上，生产环境默认是 fail-closed：

• 路径规范化；

• 解析软链；

• 允许根目录白名单；

• 空白名单默认拒绝扫描。

这部分更适合在内部知识库、团队文档目录、研发资料归档场景中使用。

下面两张图是 v1.5.0 的 Wiki 详情页和高级管理面板截图。

3. Memory Per-owner：同一个员工，记忆不串台

Agent 要进入多人协作场景，记忆隔离是基础能力。

过去同一个员工服务多个用户时，记忆可能都进入同一份上下文。v1.5.0 给记忆增加：

• owner_key：这条记忆属于谁；

• scope：这条记忆的可见范围。

owner_key 归一规则如下：

来源	owner_key
Web 控制台	user:<用户id>
IM 渠道	<渠道>:<发送者id>
第三方 API	api:<endUserId>
系统任务 / cron	system

scope 分为三档：

• PERSONAL：个人可见；

• TEAM：团队可见；

• GLOBAL：全局可见。

第三方接口 /api/v1/chat 和 /api/v1/chat/stream 新增可选字段 endUserId。这意味着一个接入方可以用同一个 PAT 调用 MateClaw，但为不同终端用户传入不同 endUserId，从而隔离每个人的长期记忆。

随发行版打包的配置中，mate.memory.lifecycle-mediator-enabled=true，默认安装下记忆隔离开启。历史数据迁移为 TEAM，避免升级后旧记忆突然不可见。

4. 员工主知识库：Wiki 工具有默认落点

v1.5.0 支持为每个员工绑定一个主知识库。

需要注意，这不是把知识库变成某个员工的私有资源。知识库仍然属于工作空间，其他员工仍可访问。主知识库只是给 Wiki 工具提供默认落点：

• 调用工具时显式传 kbName / kbId，按显式参数走；

• 没传时，优先使用员工绑定的主知识库；

• 仍没绑定时，回退到工作空间最近更新的知识库。

底层字段为 mate_agent.primary_kb_id。旧版本中 mate_wiki_knowledge_base.agent_id 的绑定关系会在迁移中回填。

5. 模型选择链路：偏好提供商真正生效

v1.5.0 调整了模型选择优先级，让员工配置的偏好提供商真正参与主模型选择。

当前优先级是：

1. 会话钉选模型；

2. 员工自身 modelName 覆盖；

3. 全局默认模型；

4. 偏好提供商路由。

偏好提供商路由还带能力门禁。例如某个员工绑定的技能声明需要 vision 能力，系统会优先选择满足能力要求的提供商。

本版同时新增 Claude Opus 4.8 / Opus 4.8 Fast 模型条目，覆盖：

• Anthropic 直连；

• OpenRouter 透传；

• Claude Code OAuth 通道；

• xhigh thinking tier。

这些条目默认不会自动成为默认模型，需要管理员显式配置。

6. 生产体验与渠道可靠性改进

除了三条主线，v1.5.0 还有一组偏生产环境的改动。

6.1 生成文件落盘

工具生成的文档、图片、音频等文件现在会落盘到 data/generated-files/，默认保留 7 天，并由定时任务清理。

这修复了过去重启后下载链接容易失效的问题。前端也增加了全局点击代理，下载失败时给出 toast，而不是让 SPA 卡住。

6.2 MCP 默认读超时调整

MCP 工具读取超时默认从 30 秒调整到 60 秒。

对一些需要联网、读取仓库、处理文件或调用较慢服务的 MCP 工具来说，这个改动能减少误超时。单个 MCP 服务仍然可以在 UI 中独立配置 5 到 300 秒。

6.3 聊天与工具体验

本版增加：

• 执行计划与工具调用详情查看器；

• /skill 斜杠菜单；

• 工具调用参数和响应输出弹窗；

• DashScope 工具调用修复；

• Plan-Execute 拆解判据重平衡。

6.4 渠道能力

渠道侧主要更新：

• 微信、企业微信接入统一入站媒体管线；

• 使用 magic-byte 判断文件类型；

• 支持指数退避重试；

• 飞书跟进文本会自动带上最近文件；

• 飞书文件缓存规则为每个聊天 5 个文件、60 分钟 TTL。

这些改动更偏实际使用场景：用户先在群里发文件，再发一句补充说明，Agent 能把最近文件一起带入上下文，而不是要求用户每次重新组织输入。

升级说明

v1.5.0 与 v1.4.0 配置兼容。已有的 agent、skill、wiki、channel、cron、workflow、trigger、goal 都会保留。

新增 schema 由 Flyway 自动迁移，包括：

• mate_agent_goal.criteria；

• memory owner/scope；

• mate_agent.primary_kb_id；

• Claude Opus 4.8 模型条目；

• Wiki 坏链、分层、pageType、权限、流水线；

• MCP 默认超时。

升级时建议注意：

项目	升级后行为
现有 Goal	继续按旧逻辑；新 Goal 使用 checklist
Memory	发行版默认开启 per-owner 隔离；旧数据回填为 TEAM
Wiki 权限	默认保持开放；配置规则后才收紧
知识源 watcher	只有配置 source_directory 且开启 watcher 才扫描
MCP 超时	旧服务保留原值；新建默认 60 秒

如果在生产环境启用本地目录知识源，建议同时配置 mate.wiki.allowed-source-roots，避免扫描范围过大或被错误路径影响。

对不同用户意味着什么

普通用户可以用 checklist 目标让 Agent 更清楚地“还差哪几步”。

知识库维护者可以用 wikilink、坏链扫描、fact/experience 分层和 stale 标记维护知识一致性。

团队管理员可以用 per-owner memory 避免多人共用同一员工时的记忆串台，用 pageType 权限限制不同员工能写哪些页面。

开发者可以通过 POST /api/v1/goals/{id}/criteria、endUserId、Wiki Pipeline、Ingest-Source SPI，把 MateClaw 接入自己的系统和数据流。

生产部署者可以受益于生成文件落盘、MCP 超时调整、DashScope 修复和渠道媒体管线。

总结

v1.5.0 的关键词是：

Checklist / Layers / Owner

Checklist 让目标完成变成可验收的清单；Layers 让知识库能区分事实与经验，并在事实变化后标记待复核；Owner 让记忆知道“这是谁的记忆”。

这三个变化放在一起，MateClaw 的 Agent Runtime 更接近团队里真实数字员工需要的运行环境：有目标、有验收、有知识维护、有记忆边界，也有更适合生产部署的稳定性补强。

相关链接

• GitHub：https://github.com/matevip/mateclaw

• 文档：https://claw.mate.vip/docs

• v1.5.0 发布说明：https://claw.mate.vip/zh/releases/1.5.0

• 在线演示：https://claw-demo.mate.vip