mnemo — AI智能体的云端持久化记忆 🧠

你的智能体是无状态的。但你的记忆不应该如此。

每一次AI智能体会话都从零开始。上下文丢失，决策被遗忘，你的智能体不断重新发现它们已知的信息。mnemo将智能体记忆外部化到TiDB Cloud Serverless中——这样智能体可以随时丢弃，但记忆永久保存。

┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Claude Code │ │ OpenCode │ │ OpenClaw │
│ 插件 │ │ 插件 │ │ 插件 │
└──────┬───────┘ └──────┬──────┘ └──────┬──────┘
│ │ │
└────────────────────┼────────────────────┘
│
┌───────┴────────┐
│ mnemo-server │ ← 可选（团队模式）
└───────┬────────┘
│
┌───────┴────────┐
│ TiDB Cloud │ ← 零运维，免费层级
│ Serverless │
│ │
│ • VECTOR类型 │
│ • EMBED_TEXT │
│ • HTTP API │
└────────────────┘

这解决了什么问题？

为什么选择TiDB Cloud Serverless？

mnemo选择了TiDB Cloud Serverless，因为它独特地结合了智能体记忆所需的一切——在一个服务中，零成本：

• - 原生VECTOR类型 — 在与元数据相同的表中进行语义搜索。无需单独的向量数据库。
• EMBEDTEXT()自动嵌入 — TiDB在服务端生成嵌入向量（例如tidbcloudfree/amazon/titan-embed-text-v2）。语义搜索无需OpenAI API密钥。
• HTTP数据API — 智能体通过fetch/curl与TiDB通信。无需数据库驱动，无需连接池。
• 免费层级 — 25 GiB存储，2.5亿请求单位/月。个人使用绰绰有余。
• MySQL兼容 — 随时迁移到自托管TiDB或MySQL。

一个数据库为你提供关系型存储+向量搜索+自动嵌入+HTTP访问。无需胶水代码。无需基础设施。

混合搜索：向量+关键词

配置了嵌入？
┌─────────┴─────────┐
是 否
│ │
混合搜索 仅关键词
(向量+关键词) (LIKE %q%)
│ │
┌─────────┴─────────┘ │
向量结果 关键词结果 │
(ANN余弦) │
└─────────┬─────────┘ │
合并并排序 直接返回结果

三种嵌入选项——选择一个或都不选：

1. 1. TiDB自动嵌入 — EMBEDTEXT()在服务端生成向量。零配置。免费。
2. OpenAI/兼容API — 设置MNEMOEMBEDAPIKEY。也适用于Ollama。
3. 无嵌入 — 关键词搜索立即可用。稍后添加向量，无需迁移。

多智能体冲突解决（CRDT）

当多个智能体写入同一记忆时，mnemo使用向量时钟——无需协调：

智能体A：时钟 {A:3, B:1} 智能体B：时钟 {A:2, B:2}
\ /
└──── 服务器比较 ─────────┘
│
两者都不占优 →
并发冲突！
│
确定性平局决胜
│
胜者保存，时钟合并：{A:3, B:2}

删除是软删除（墓碑+时钟增量）——不会因错过删除的智能体而出现幽灵复活。

为OpenClaw安装

bash
npm install mnemo-openclaw

添加到openclaw.json：

json
{
plugins: {
slots: { memory: mnemo },
entries: {
mnemo: {
enabled: true,
config: {
host: <你的tidb主机>,
username: <你的tidb用户名>,
password: <你的tidb密码>
}
}
}
}
}

在tidbcloud.com上30秒内获取免费集群。

可选——启用自动嵌入（无需API密钥）：

json
{
config: {
host: ...,
username: ...,
password: ...,
autoEmbedModel: tidbcloud_free/amazon/titan-embed-text-v2,
autoEmbedDims: 1024
}
}

也适用于

5个记忆工具

两种模式，一个插件

模式从配置中推断。从个人开始，扩展到团队——无需修改代码。

链接

• - GitHub：github.com/qiffang/mnemos
• 设计文档：docs/DESIGN.md
• CRDT提案：crdt-memory-proposal.md
• TiDB Cloud Serverless：tidbcloud.com（免费层级）