路线图

"人们不知道自己想要什么，直到你把它摆在他们面前。"

这不是一份功能清单。这是一个关于你的 AI 助手应该如何存在的宣言。

---

我们的信念

每个人都值得拥有一个真正理解自己的 AI 助手。

不是一个聊天玩具。不是一个技术 demo。而是一个数字分身——它知道你的工作方式，连接你的所有工具，替你思考、替你执行、替你记住。

MateClaw 就是这个东西。

---

我们已经做到了什么

v1.0 —— 它能思考和行动 ✅ 已发布

让一个 AI 助手成为"会用工具的同事"，不是一个聊天框。

• ReAct 引擎：思考、行动、观察、再思考
• Plan-and-Execute 编排：先制定计划，再逐步执行
• StateGraph 架构：基于状态图的 Agent 编排
• DynamicAgent：从数据库加载配置，运行时随时调整
• 20 个内置工具：搜索 / Shell / 文件 / 委派 / 多模态生成 / 定时任务 / SQL 查询
• ToolGuard + FileGuard + AuditLog：每一次工具调用有审批、有控制、有记录
• SKILL.md 技能系统：像装 App 一样给 AI 装新能力

v1.1 —— 它无处不在 ✅ 已发布

把 AI 从"网页上的对话框"搬进你团队真正在用的每一个 IM。

• 8 个渠道：Web / 钉钉 / 飞书 / 企业微信 / Telegram / Discord / QQ / 微信个人 / Slack
• 4 层记忆：会话上下文 + 工作空间记忆 + 对话后提取 + 每天凌晨 2:00 自动整合
• DREAMS.md 整合日记：人类可读的记忆变更审计
• 工作空间隔离：每个 agent / skill / wiki / conversation / memory 都属于一个工作空间
• ChatGPT OAuth + Anthropic Claude Code OAuth：用订阅直接登录，不需要 API Key
• LLM Wiki 知识库 + RAG：把原始文件吃进去变成结构化、有双向链接、有摘要的知识页

v1.2 —— 它是你的同事 ✅ 已发布（2026-05-05）

把"智能体"换成数字员工——这不是术语洁癖，是世界观换了。

• 数字员工：每位有角色（Role）、目标（Goal）、背景故事（Backstory），不是冰冷的 system prompt
• 5 个职业模板：产品研究员 / 客户支持 / 知识管理员 / 数据分析师 / 行政助理——开箱即用
• 技能是骨架：每个技能有自己的 SKILL.md + LESSONS.md + workspace 文件空间
• ACP 桥接：Claude Code、Codex、Gemini CLI 这些顶级编码 Agent 以"员工"身份接入
• Backstage 运行时控制台：第一次能看见每个员工正在干什么
• Onboarding wizard + Dashboard + Doctor

完整故事：v1.2.0 Release Notes。

v1.3 —— 它能编排业务流 ✅ 已发布（2026-05-13）

从"chatbot 框架"升级为"业务流程 OS"——一条业务流不再是几个员工各自聊天的总和，而是一份可发布、可触发、可重放的线性 step DSL。

• 工作流：7 种 step mode（sequential / fan_out / collect / conditional / await_approval / dispatch_channel / write_memory）+ Pebble 表达式 + JSON-first 编辑 + 整数 revision + 运行历史
• 自然语言 → 工作流草稿：描述需求，agent 生成 graph_json，人工审阅后发布
• 触发器：6 种 pattern type（cron / webhook / channel_message / agent_lifecycle / content_match / workflow_completion），事件治理默认开（去重 / 限速 / 递归切断）
• await_approval 持久化暂停：服务重启不丢
• 图像编辑、4 个文档生成工具（Docx/Xlsx/Pptx/Pdf）、MCP per-agent 工具绑定、多模态旁路路由

完整故事：v1.3.0 Release Notes。

v1.4 —— 它更自主、能带团队 ✅ 已发布（2026-05-23）

流程是你写死的，员工本身还是"答完一轮就停"。这一版把焦点放回员工自己身上。

• 持久化目标（Goal）：你说一次目标，员工锁住它、每轮自检、自己续命，直到完成或耗尽预算
• 子员工委派树：递归委派最深 3 层，同步 / 并行扇出 / 异步三种委派工具；「数字员工构建器」一句话拉起一支团队
• 渐进式工具/技能披露：核心层始终可见，扩展层按需 enable_tool / load_skill——工具再多，上下文不爆
• 工作空间 RBAC：Owner / Admin / Member / Viewer 四级角色 + 能力门禁，MateClaw 第一次能给团队用
• 飞书一等公民：互动卡片、审批卡片、流式卡片、语音转写、文件音视频收发、渠道原生工具
• 原生 Gemini、xAI / Grok、按会话选模型、结构化上下文压缩、限流自动故障转移

完整故事：v1.4.0 Release Notes。

v1.5 —— 它可验证、知识会自维护、记忆认人 ✅ 已发布（2026-06-04）

让"自主"变得可验证，让"知识"变得会自维护，让"记忆"变得认人。

• 目标清单（checklist）：目标拆成可逐条验证的准则，evaluator 一条条勾，全勾完才算完成——没有"差不多 95% 就放过"
• Wiki 自维护：[[wikilink]] 页面互联 + 改名/删页自动级联修链 + 坏链体检；知识分事实层 / 经验层，事实一改依赖它的经验页自动标"待复核"；pageType 档案 + per-agent 权限；页面事件触发的处理流水线；本地目录挂成知识源定时增量同步
• 记忆 per-owner 隔离：每条记忆带 owner_key 和可见范围（个人 / 团队 / 全局），一个员工服务一群人互不串台；API 透传 endUserId
• 员工绑主知识库、偏好提供商真正生效、生成文件落盘持久化

完整故事：v1.5.0 Release Notes。

v1.6 —— 它来到你所在的地方 ✅ 已发布（2026-06-22）

它能跑在哪、能用手和眼睛做什么、以及你能多直接地塑造它是谁。

• KingbaseES（人大金仓）+ PostgreSQL 一等公民：PostgreSQL 家族共用一套迁移树，国产化 / 受监管环境可用；MySQL 和桌面 H2 完全不动
• 图片跨轮次留在上下文：三条消息之前发的截图，追问还看得见；image_analyze 按需重读
• execute_code：员工写代码并运行——算术、文件转换、核对，从猜测变成真实动作
• 塑造员工身份：AGENTS.md 等上下文文件有了真正的编辑器（模态 + 章节重排）；About You 身份块；员工知道自己跑在哪个模型上
• 知识库访问限定范围 + Wiki Sources 标签（多路径 + glob + 按 KB 自动同步）
• 全局出站代理、最终回答确定性 Markdown 规范化

完整故事：v1.6.0 Release Notes。

v1.7 —— 它敢放进生产 ✅ 已发布（2026-07-04）

一次生产化加固：把它放进真正的协作里之后，那些看不见、收不拢、够不着、装不下、连不通的地方，这一版全补上。

• 审批三条链路彻底闭环：工作流 await_approval 真的推到渠道并能 resolve→恢复执行；WebChat（API-Key）渠道能批准/拒绝并重放；飞书/企微点卡片按钮直接 resolve 工作流审批
• 长任务看得见：常驻「运行总览」侧栏（步骤进度 + 委派子 Agent 树状实时状态）+ 本轮 Token 明细（缓存命中/未命中/写入 + 推理拆分）+ 子 Agent 成本向上滚加 + 生成文件一键下载
• 装得下真实模型窗口：本地模型上下文窗口探测、prefix 注入统一 Token 预算、小上下文自动降级、工具 schema 超预算按频度降级——不再被"猜个 32K"坑到预检拒绝或悄悄截断
• 开放出去：知识库与 Deep Research 开放 API（API-Key + 限流 + SSE）、插件化搜索 Provider SPI、MCP 身份透传（把认证用户身份带给 STDIO MCP）
• 够得着更远：桌面端本地内嵌 / 远程集中部署双模式 + 多服务器切换 + mateclaw-desktop 源码开放；局域网部署模式放开受控内网访问
• 运营数据一键导出：Dashboard 9 表 Excel + CLI 命令行离线导出
• Wiki 处理失败可视化、按员工模型链偏好、OpenAPI / Swagger 可直接调试、聊天回到底部浮动按钮

完整故事：v1.7.0 Release Notes。

v1.8 —— 它干完一整件活 ✅ 已发布（2026-07-12）

员工转向对外、把一整件活干完——从一句话简报到可发布成品——全用 MateClaw 自身的原子能力。

• 内容工作室 —— 第一个招牌场景：预置员工跑通 选题 → 搜集 → 成文 → 配图 → 去 AI 化 → 排版 → 交付。微信公众号（公众号） 图文文章（内联样式 HTML → 草稿箱）与 小红书 以图为主图文笔记（≥3 张竖版 3:4 卡片 + 在线预览）首批一等公民
• 可度量的去 AI 化 —— 启发式 AI 痕迹评分驱动 检测 → 改写 → 复检 闭环，硬上限 3 轮
• 为长期投产而加固的发布链 —— 正文图上传进微信、AES-GCM 加密密钥、服务复用 + token 持久化、重试 + 中文错误提示、兜底封面；草稿箱优先，发表走审批
• 会去重、会记账的内容日历 —— 每次交付都合规扫描 + 自动落台账、选题指纹防重复、只读内容日历页展示草稿/已打包/已发布/失败
• 浏览器 Agent 按引用去看 —— 无障碍树 ref 快照 + 按 ref 交互、真实浏览器隐私护栏、受控 CDP 逃生舱
• 注意力锚定与环境感知、工具调用循环护栏、改动后校验提醒；快加载优化（初始包体 ↓约 78%）、上下文占用面板、跨知识库 wikilink、MCP 进度通知、火山方舟供应商、PostgreSQL 16

完整故事：v1.8.0 Release Notes。

v2.0 —— 它带队干活 ✅ 已发布（2026-07-26）

从"一个能干活的人"到"一支能协作的队伍"——Agent 团队成为常设编制，围着一块共享任务板协作。

• 团队实体与角色编制：团队 = 名字 + Lead + 成员 + reviewer，持久化、可复用；团队名册与协作准则注入成员提示词
• 共享任务板：八状态看板、blockedBy 依赖编排、成员级并行派发、前置结果自动传递、结果通报唤醒 Lead
• 队长调度：Lead 拆任务、指派、验收；Plan-Execute 型 Lead 的计划整体移交任务板——步骤变任务、依赖变并行
• 执行加固：租约心跳防双重执行、取消即中断、in_review 人工审批卡点、失败/过期可重试
• 交付物与全程可观测：产出文件登记到任务、任务时间线、团队 SSE 实时看板、跳进成员子会话看逐字执行
• 外加：工作空间隔离全面收口、渠道魔法命令 + 企微进度气泡、会话回退/重新生成、自动批准可解释性、LLM 错误恢复策略化、附件在线预览、SKILL.md 单一事实源、Mem0 插件 provider

完整故事：v2.0.0 Release Notes，使用指南：团队协作。

---

下一站：Agent Loop 与团队进阶

"伟大的事业不是一个人做成的，是一个团队做成的。"

回头看这条线：v1.2 员工有了身份，v1.3 流程能编排，v1.4 员工会自主跟目标、能临时拉起委派树，v1.7 长任务看得见，v2.0 团队成了常设编制。

还剩一个"停"：员工是被动的。 目标的自动延续只活在单次运行内；cron 和触发器能定时叫醒它，但每次醒来都是一次孤立的响应。没有一个员工真正"在岗"——持续盯着自己的职责范围，自己决定什么时候该干什么。

Agent Team 进阶 —— 编制有了，接下来长本事

2.0 交付了团队实体、任务板、队长调度与执行链（见上），团队方向还想做：

• [ ] 成员互审（peer review）：关键产出可以配置"另一个成员复核后才交付"（2.0 的 in_review 是人工审批；成员互审是下一步）
• [ ] 团队级目标：一个 goal 拆成成员子目标，清单跨成员汇总——hover 队长头像，看到整个团队还差哪几条
• [ ] 团队绑渠道：一个飞书群 / 钉钉群绑一个团队，群里 @ 团队，队长决定谁接
• [ ] 团队复盘：任务收尾自动生成 retrospective，沉淀进团队的 LESSONS.md——这个团队下次会做得更好
• [ ] 协作 DAG / 泳道视图：在时间线数据之上画出任务依赖与成员泳道
• [ ] 「数字员工构建器」升级：一句话直接产出一个带编制的常设团队

Agent Loop（智能体循环）—— 从"答完就停"到"长期在岗"

让员工进入一种新状态：在岗。不是等你说话才动，而是按心跳周期自主循环——醒来 → 看收件箱和目标 → 决定做不做 → 行动 → 记日志 → 休眠：

• [ ] 常驻循环运行时：员工可以被设为"在岗"，按可配置的心跳（分钟级到天级）自主醒来检查职责范围
• [ ] 任务收件箱（Inbox）：渠道消息、触发器事件、其他员工的委派、你随手丢的待办——统一进一个队列，循环醒来按优先级消化
• [ ] 跨会话目标延续：v1.4 / v1.5 的自动延续只活在单次运行内；loop 让目标跨会话、跨天持续推进，直到清单全勾完
• [ ] 预算与熔断：每循环有 token / 成本 / 轮次预算，连续失败自动熔断进入休眠等你处置；ToolGuard 审批门禁照常拦截敏感操作——自主不等于失控
• [ ] 循环日志（Loop Journal）：每次醒来干了什么、为什么决定不干、花了多少——人类可读、可回放，像 DREAMS.md 之于记忆
• [ ] 暂停 / 恢复 / 一键下班：UI 和渠道命令都能控制；运行总览侧栏显示每个在岗员工的循环状态
• [ ] 安静时段与打扰策略：夜间静默积攒、重要事项主动汇报——和 nudge 体系结合，它知道什么值得叫醒你

两者合流：会自己运转的部门

队长在岗循环，成员按需唤起——这就是一个会自己运转的数字部门：

• 晨报部门：队长每天 7:00 醒来，派数据员工采数、分析员工汇总、写作员工成稿，互审后发进群——你睡醒看结果
• 客服部门：收件箱进一条工单，队长判断类型，指派对应成员处理，处理不了的升级给你
• 情报部门：监控员工循环盯着信息源，发现值得关注的变化才唤醒分析员工，分析完值得打扰才通知你

工作流负责"确定的流程"，团队 + 循环负责"不确定的日常"。 三者互补，不互相替代。

同步推进的事

• [ ] 工作流 loop / invoke_skill step mode：迭代处理数组 / 直接调技能不经过员工
• [ ] 工作流画布编辑：从只读链式渲染到拖拉编辑
• [ ] 运行回放视图：trace timeline + 任意节点看 input/output diff
• [ ] 场景模板与场景市场：把"员工 + 团队 + 工作流 + 触发器 + 知识库结构"打包成可一键导入的场景包

---

我们故意不做的事

"我对我们没做过的事情和我们做过的事情一样感到自豪。"

砍掉的功能	为什么	什么时候才该做
超出四级角色的细粒度 RBAC	v1.4 的 Owner / Admin / Member / Viewer + 能力门禁已覆盖真实团队需要。按钮级权限、自定义角色组合是企业管理平台的事	当真正出现需要细粒度权限的多团队 SaaS 客户时
多租户	过早的多租户是架构癌症。工作空间隔离已覆盖单组织多团队	当有明确的 SaaS 商业化路径时
SSO / LDAP / SAML	企业集成是个无底洞	当付费企业客户明确要求时
30+ 节点的可视化工作流编辑器	7 种 step mode 已覆盖 90% 实际场景，剩下的复杂度推给自然语言生成	真有用户场景需要 30+ 节点时（很少）
移动端原生 App	8 个 IM 渠道 + 桌面端（现已支持连远程）+ Web 已经覆盖。你在手机上用钉钉 / 飞书 / Telegram 就在用 MateClaw	当 Web / IM 渠道有不可替代的移动专属能力时
替代 ReAct / Plan-Execute	工作流、团队、循环和这两条引擎是协作关系，不是替代——单 agent 多轮推理仍在那两条引擎里	永远不替代
无预算的全自主 Agent	Agent Loop 永远带预算、熔断和审批门禁。"跑到没钱为止"不是自主，是失控	永远不做

---

版本里程碑

版本	一句话	用户体验目标	状态
v1.0	它能思考和行动	一个能用工具解决问题的 AI 助手	✅ 已发布
v1.1	它无处不在	8 个渠道 + 4 层记忆 + 工作空间 + LLM Wiki	✅ 已发布
v1.2	它是你的同事	数字员工 + 职业模板 + 骨架式技能 + ACP 桥接 + Backstage	✅ 已发布
v1.3	它能编排业务流	工作流 + 触发器 + 文档生成 + per-agent 工具绑定	✅ 已发布
v1.4	它更自主、能带团队	持久化目标 + 委派树 + 渐进披露 + RBAC + 飞书一等公民	✅ 已发布
v1.5	它可验证	目标清单 + Wiki 自维护 + 记忆认人	✅ 已发布
v1.6	它来到你所在的地方	国产数据库 + 视觉留存 + 代码执行 + 身份塑造	✅ 已发布
v1.7	它敢放进生产	审批三链路闭环 + 运行总览与成本可见 + 上下文/Token 预算 + 开放 API/Deep Research + 桌面远程/局域网 + 运营导出	✅ 已发布
v1.8	它干完一整件活	内容工作室 —— 一句话到可发布的公众号 / 小红书成品 + 浏览器 ref 交互	✅ 已发布
v2.0	它带队干活	Agent 团队 + 共享任务板 —— Lead 拆解派发、成员并行执行、交付物与全程可观测	✅ 已发布
下一站	它长期在岗	Agent Loop 常驻循环 + 团队进阶（互审 / 团队目标 / 群绑定 / 复盘）= 会自己运转的数字部门	📋 规划中

---

One More Thing

我们做 MateClaw，不是为了追赶 ChatGPT、不是为了做下一个 Dify、不是为了融资 PPT 上多一个 buzzword。

我们做它，是因为我们相信一件事：

AI 不应该是一个网页上的对话框。它应该是你的第二个大脑。

它住在你的钉钉里、你的飞书里、你的 Telegram 里。它读过你所有的文档。它记得你三个月前说过的话。它会用你公司的内部工具。它在你睡觉的时候整理记忆。它能替你跑一整条业务流程。很快，它还会带着一支常设团队，长期在岗，替你盯着那些你顾不上的事。

总有一天，你会忘记它是一个程序。

那一天，就是我们成功的那一天。

---

Stay hungry. Stay foolish.