🥝 kiwi-mem

大多数 AI 记忆系统是数据库。kiwi-mem 是一颗大脑。

English Version →

---

它做了什么

kiwi-mem 让你的 AI 拥有像人脑一样运转的长期记忆。

不是"把聊天记录存起来，用的时候搜一下"——是真的像人一样记东西：不常提起的事会慢慢淡忘，反复聊到的事越记越牢，睡一觉醒来会把零散的碎片整理成更深的理解，去年的事只记得个大概，昨天的事记得很清楚。

所有功能组合在一起，形成了一套完整的筛选机制：AI 会记住你也会记住的事情，遗忘的都是两个人都不会在意的内容。 同时不会撑爆上下文窗口，也不会烧穿你的 API 账单。

技术上，它是一个轻量级转发网关，插在你和大模型之间，同时兼容 OpenAI 格式和 Anthropic 原生格式的 LLM 服务商。Docker 一键部署，管理面板里点点就能配。

技术栈：Python / FastAPI · PostgreSQL + pgvector · Docker · AGPL-3.0-or-later 开源

---

为什么做 kiwi-mem

AI 的记忆应该属于你，而不是属于某个平台。

kiwi-mem 让任何人都能自托管、自审计、自迁移 AI 的长期记忆。没有供应商锁定，没有黑箱存储，不依赖于任何可能明天就消失的服务。

如果一个 AI 记得你，你应该能看到它记得什么、决定它留下什么，并且在你离开时带走它。

---

记忆怎样像人脑一样运转

kiwi-mem 的核心不是某个单一功能，而是多个机制协同运作，让 AI 的记忆行为逼近人类直觉：

🔥 会淡忘，也会加深

每条记忆都有"热度"。时间会让它自然衰减，但如果你们反复聊到同一件事，它会重新升温。高情绪浓度的记忆衰减更慢——就像人会更容易记住那些触动过自己的瞬间。而淡忘不是一刀切的删除：老记忆每晚被温柔地模糊，细节渐渐褪色、要点保留下来；如果某条已经模糊的记忆在对话里又被想起，它会自动续命 30 天。只有真正写进对话的才算"被想起"，又冷又老的记忆才会按热度被清走。遗忘是渐进的，就像人一样。热度同时决定了记忆如何被注入对话：高热度全文注入，中热度只给摘要，冷记忆不打扰你们。

🌙 会"睡觉"，醒来变聪明

Dream 模拟人脑睡眠时的记忆整合。它分三层工作：先清理过时和重复的碎片，再把相关的碎片融合成完整的"记忆场景"，最后从这些场景中推断出你没明说过、但 AI 应该理解的事情。你可以手动触发，也可以让它自己判断什么时候该睡了。而且梦不是做完就忘的——整合出的场景带有向量索引，白天聊到相关话题时会被搜到、重新进入对话。睡眠的产出回流到清醒的日子里，这才是整合的意义。

📅 近的清晰，远的模糊

日历系统把聊天记录自动压缩成层级摘要：日 → 周 → 月 → 季 → 年。注入对话时，最近几天给完整内容，上周给缩略版，更早的只保留高层概括。就像你自己回忆过去——昨天吃了什么记得住，上个月的事只剩轮廓。

🧩 矛盾了会更新，重要的不会丢

当新记忆和旧记忆冲突时（比如你换了工作、搬了家），系统会自动让旧的失效。你亲手锁定的记忆神圣不可侵犯——永不衰减、永不退役、永不自动清除。系统自动锁定的记忆则有退场机制：如果 90 天无人问津，它会从"永久"降级回高重要度的普通记忆（可逆、不删除），把宝贵的注入空间让给真正活跃的内容。

⚡ 省钱，也省上下文

所有静态内容（人设、画像、锁定记忆、日历摘要）排在 prompt 前部命中缓存，动态内容（搜索结果、犯困提示）排在后面。这个注入顺序让你的 API 输入费用最多能省 90%。配合日历压缩和热度分层，一个月的记忆量也不会撑爆上下文窗口。

🔌 不只 OpenAI——直连 Anthropic 也行

大多数 AI 记忆方案只能接 OpenAI 格式的 API。kiwi-mem 同时支持 Anthropic 原生格式——如果你直接买了 Anthropic 的 API Key，不用再找个中转站帮你转格式，直接连就行。在管理面板里添加供应商时选「Anthropic 原生」，kiwi-mem 帮你处理所有格式差异，包括流式输出和工具调用。

⚠️ Anthropic 原生格式需要在管理面板的供应商设置里配置（选择「Anthropic 原生」），不支持通过环境变量直连。环境变量方式仅适用于 OpenAI 兼容格式的服务商。

🧰 工具不是越多越好——用多少拿多少

kiwi-mem 内置了 20 多个工具（记忆搜索、日历查询、提醒、联网搜索等等）。以前每次对话都把所有工具描述塞给模型看，光这些就占掉好几百 token。

工具抽屉换了个思路：你说的每句话，系统会快速判断你可能需要哪几个工具，只把这几个拿出来，其余的收在抽屉里。就像厨师做菜——不会把所有调料都摆在台面上，用到哪个拿哪个。

默认关闭，想用的话在管理面板「配置」里打开就行。

🔒 项目之间互不串门

如果你用项目功能把不同场景分开管理（比如工作一个项目、日常生活一个项目、小说创作一个项目），全局记忆、日历与 Dream 会作为所有聊天共享的生活底座；项目则叠加自己的私有层，包括项目指令、文件、项目记忆与项目对话。项目私有内容不会流向全局或其他项目。

你不需要做任何设置，隔离是自动的。

项目由支持它的客户端传入和使用；管理面板仅在已有项目时显示「项目分隔」页，直达 #/projects 仍可增删改。

---

适合谁用

kiwi-mem 擅长的是记住一个人——你的习惯、偏好、情绪、经历、成长轨迹。它不是企业知识库，不做文档检索，不搭知识图谱。

它最适合这些场景：

🏠 生活助理 — 记住你的饮食习惯、健康状况、日程偏好，用得越久越懂你的生活节奏

🩶 长期陪伴 — 情感支持、日常闲聊、深度关系，AI 真的"认识你"而不是每次从头开始

📖 创作伙伴 — 连载小说、世界观构建、角色扮演，所有设定和剧情线都记得住

🎓 学习辅导 — 记住你的学习进度、薄弱环节、问过的问题，辅导越来越有针对性

---

快速开始

先搞清楚这张图

你的手机/电脑上的聊天软件        kiwi-mem（网关）         你买的 AI 服务
   （前端客户端）          （装在服务器上，中间人）       （中转站/API）
        │                        │                        │
        │   ①你说的话             │   ②转发给 AI           │
        ├───────────────────────→├───────────────────────→│
        │                        │   （顺便把记忆塞进去）    │
        │                        │                        │
        │   ④带记忆的回复          │   ③ AI 的回复           │
        ├←───────────────────────├←───────────────────────│
        │                        │   （顺便提取新记忆）      │

kiwi-mem 是一个中间人——它站在你的聊天软件和 AI 之间，帮你管记忆。你的聊天软件把话发给 kiwi-mem，kiwi-mem 把你的记忆塞进去再转发给 AI，AI 的回复经过 kiwi-mem 时又被提取出新的记忆。

所以你需要准备三样东西：