MateClaw

中文

English

中文

English

Appearance

路线图 ​

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

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

我们的信念 ​

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

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

MateClaw 就是这个东西。

我们已经做到了什么 ​

我们用 v1.0 和 v1.1 证明了一件事：一个人也能拥有企业级的 AI 能力。

一颗会思考的大脑 ​

  • [x] ReAct 引擎——你的 AI 会思考、行动、观察，然后再思考。就像人类解决问题一样
  • [x] Plan-and-Execute 编排——面对复杂任务，它会先制定计划，再逐步执行
  • [x] StateGraph 架构——基于状态图的 Agent 编排，让多步骤任务像流水线一样精确
  • [x] DynamicAgent——从数据库加载配置，运行时随时调整，不需要重启

一双万能的手 ​

  • [x] 12 个内置工具——搜索、时间、Shell 执行……开箱即用
  • [x] MCP 协议——stdio / SSE / streamable_http，三种传输方式全覆盖
  • [x] ToolGuard + FileGuard + AuditLog——每一次工具调用都有审批、有控制、有记录
  • [x] SKILL.md 技能系统——像安装 App 一样给你的 AI 安装新能力
  • [x] Skill Workspace——每个技能有自己的文件空间，安全隔离，互不干扰
  • [x] 启动时自动同步预置技能——升级即可用，零配置

一张无处不在的脸 ​

  • [x] Web 端——SSE 流式输出，打字机般的实时响应
  • [x] 钉钉——Stream 长连接 + AI Card 流式卡片
  • [x] 飞书——WebSocket 长连接
  • [x] 企业微信——长连接模式
  • [x] Telegram——Long-Polling + Typing 指示器
  • [x] Discord——JDA Gateway WebSocket
  • [x] QQ 频道——机器人适配
  • [x] 微信个人——iLink 协议（实验性）
  • [x] 会话来源追踪——每条消息都知道来自哪个渠道

8 个渠道。 你在哪里，MateClaw 就在哪里。

一个不会忘事的记忆 ​

  • [x] 短期记忆——会话上下文窗口，对话不断线
  • [x] 上下文自动压缩——长对话也不会丢失关键信息
  • [x] WorkspaceMemoryTool——PROFILE.md / MEMORY.md / 每日记忆
  • [x] 对话后自动记忆提取——聊完即归档，重要的事情不会忘
  • [x] 记忆整合服务——每天凌晨 2:00 自动整理，像睡眠时的大脑一样

一面坚固的盾 ​

  • [x] JWT 认证 + 滑动窗口续期
  • [x] Spring Security 集成
  • [x] 统一 401/403 错误处理

一个聪明的前端 ​

  • [x] Vue 3 + Pinia + TailwindCSS 4 + Element Plus
  • [x] 暗色模式——保护你凌晨两点还在工作的眼睛
  • [x] 中英双语——国际化不是锦上添花，是基本尊重
  • [x] 会话管理——你的每一次对话都有迹可循

160+ 模型，随你挑选 ​

  • [x] DashScope 通义千问系列
  • [x] Ollama 本地模型——你的数据不出你的电脑
  • [x] OpenAI 兼容协议——几乎接入一切
  • [x] 大模型内置搜索 + Kimi $web_search
  • [x] 搜索配置从配置文件迁移到 UI——不再需要改 YAML

进行中：让它真正好用 ​

"设计不是外观和感觉。设计是它如何运作。"

v1.0.101 —— 像人一样协作 ​

这个版本的目标不是加功能，是让 MateClaw 像一个真正的同事。

  • [x] 文件拖拽上传——把文件丢给它，就像丢给坐在旁边的人
  • [x] 目录引用——指向一个文件夹，它就理解整个上下文
  • [x] 多 Agent 协作——DelegateAgentTool，一个 Agent 可以委派任务给另一个
  • [x] Ollama 启动自动发现——插上就用，不需要配置
  • [x] 智谱 GLM-5 全系列接入
  • [x] 模型管理分组——本地模型和云端模型，一目了然
  • [ ] 系统托盘集成优化——它应该安静地待在那里，需要时立刻出现

ClawHub 技能市场——完善中 ​

  • [x] 技能市场 UI（浏览 + 安装）
  • [x] Skill Workspace 文件系统
  • [ ] 技能版本管理——像 App Store 一样，每个技能都有版本号
  • [ ] 技能评分与评论——让社区告诉你哪个技能值得安装

MCP 连接——最后一公里 ​

  • [x] Streamable HTTP 传输支持
  • [x] stdio 配置热更新
  • [x] Server 动态加载与卸载
  • [ ] 连接池管理——当你同时用 10 个工具时，不能卡
  • [ ] 健康检查与自动重连——断了就自己接上，不要让用户操心

下一步：三件事，只做三件事 ​

"聚焦不是对要关注的事情说 Yes。而是对其他一百个好点子说 No。"

我砍掉了原来路线图上的一半功能。不是因为它们不好。而是因为现在不是做它们的时候。

v1.2 —— 让它记住一切（RAG） ​

如果 MateClaw 明天就死了，用户最痛的是什么？

答案很简单：它不认识我的文档。

你可以跟它聊天，让它搜索网页，让它执行命令。但你不能把一份 200 页的产品手册丢给它，然后说"帮我找到第三季度的退货政策"。

这是不可接受的。

v1.2 只做一件事：让你的 AI 读懂你的所有文档。

  • [ ] 文档索引与向量化——丢进去的每份文档都被理解、被记住
  • [ ] 向量数据库集成——让语义搜索变得可能
  • [ ] 语义检索增强生成——不是关键词匹配，是真正的"理解"
  • [ ] 知识库管理 UI——上传、分类、搜索，三步完成

类比：如果之前的 MateClaw 是一个聪明但刚入职的新员工，v1.2 之后，它就是一个读完了公司所有文档的老员工。

v1.3 —— 让它开口说话（语音） ​

键盘是 1970 年代的交互方式。

最自然的交互是什么？说话。你不会给坐在对面的同事发消息——你直接开口。

  • [ ] 语音输入——说出来，它就听懂了
  • [ ] 语音输出——它的回答不再只是文字
  • [ ] 实时语音对话——像打电话一样和你的 AI 聊天

类比：v1.2 让 MateClaw 有了记忆，v1.3 让它有了嘴巴和耳朵。它不再是一个屏幕上的文字框，而是一个你可以对话的存在。

v1.4 —— 让你看见它在想什么（可观测性） ​

信任来自透明。

你会把重要任务交给一个你看不懂在干什么的人吗？不会。你的 AI 也一样。

  • [ ] Agent 执行链路追踪——每一步思考都可视化
  • [ ] Token 消耗统计仪表盘——钱花在哪里，一目了然
  • [ ] 工具调用频次分析——哪些工具最有用，数据说话

类比：这就像给你的 AI 装了一个透明的大脑。你能看到它的每一个念头、每一次决策、每一分钱的去向。

我们故意不做的事 ​

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

砍掉的功能为什么什么时候才该做
RBAC 权限模型MateClaw 是个人 AI 助手，不是企业管理平台。一个人不需要管理自己的权限当真正有团队用户需求，且 DAU > 1000 时再考虑
多租户同上。过早的多租户是架构癌症——它会感染每一行代码当有明确的 SaaS 商业化路径时
SSO / LDAP / SAML企业集成是一个无底洞。做了 LDAP 就要做 SAML，做了 SAML 就要做 SCIM当有付费企业客户明确要求时
可视化工作流编辑器听起来很酷，但 90% 的用户不会用。好的 AI 应该理解自然语言指令，而不是让用户画流程图当 Agent 编排复杂到自然语言无法表达时
图像生成这不是 MateClaw 的核心价值。市面上有太多更好的专业工具可以通过 MCP 或技能系统集成，不需要内置
移动端适配8 个 IM 渠道已经覆盖了所有移动场景。你在手机上用钉钉/飞书/Telegram 就能用 MateClaw当 Web 端有不可替代的移动端专属功能时

版本里程碑 ​

版本一句话用户体验目标状态
v1.0它能思考和行动一个能用工具解决问题的 AI 助手已发布
v1.1它无处不在在你的所有 IM 工具里都能找到它已发布
v1.0.101它像同事一样协作拖文件、指目录、多 Agent 协作开发中
v1.2它记住你的一切丢进文档，它就懂了下一站
v1.3它开口说话用声音和你的 AI 对话规划中
v1.4它完全透明看见每一步思考和每一分钱规划中

One More Thing ​

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

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

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

它住在你的钉钉里、你的飞书里、你的 Telegram 里。它读过你所有的文档。它记得你三个月前说过的话。它会用你公司的内部工具。它在你睡觉的时候整理记忆。

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

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

Stay hungry. Stay foolish.