OptMem

这是什么？

OptMem 是一个极简 AI Agent 永久记忆方案。GitHub VictorTaelin/OptMem，1.1k Stars，MIT 许可证。

核心价值：仅 426 Token 的 prompt + 一个脚本，实现 Agent 的永久记忆。无需数据库、无需向量存储、无需额外服务。Agent 将重要信息写入一个 Markdown 文件，每次对话时自动加载。

适合谁：使用 Claude Code / Codex 等 AI Agent 的开发者，需要 Agent 记住项目上下文和个人偏好的用户。

前置条件：任何支持文件读写的 AI Agent 客户端。

准备工作

安装

git clone https://github.com/VictorTaelin/OptMem.git
cd OptMem

无需安装依赖。核心就是一个 426 Token 的系统 prompt 和一个 shell 脚本。

配置

将 optmem.prompt 的内容添加到你的 Agent 系统提示中。将 optmem.sh 脚本放在项目根目录。

时间预算：安装 1 分钟，配置 2 分钟。

三步上手

第一步：初始化记忆文件

echo "# Project Memory" > .optmem/memory.md

第二步：让 Agent 使用记忆

在对话中，Agent 会自动读取 .optmem/memory.md 获取上下文。当 Agent 学习到重要信息时，它会自动更新记忆文件。

“记住：这个项目使用 PostgreSQL 16，连接字符串在 .env 的 DATABASE_URL”

第三步：跨会话记忆

下次对话时，Agent 自动加载记忆文件，无需重复告知项目信息。

常见踩坑

踩坑 1：记忆文件无限膨胀

症状：.optmem/memory.md 超过 100KB，Agent 上下文窗口被占满。

原因：Agent 不断追加信息但未清理旧记忆。

解决：定期运行 optmem.sh --prune 清理过期和不重要的记忆条目。

踩坑 2：多项目记忆混淆

症状：Agent 在不同项目间混淆信息。

原因：所有项目共享同一个记忆文件。

解决：每个项目使用独立的 .optmem/ 目录，通过 --project 参数指定。

踩坑 3：敏感信息泄露

症状：API Key 或密码被写入记忆文件。

原因：Agent 将其认为”重要”的信息全部记录。

解决：在系统 prompt 中添加 [NEVER store API keys, passwords, or tokens in memory]。

踩坑 4：与现有 Agent 记忆系统冲突

症状：Claude Code 的 Memory 功能与 OptMem 重复记录。

原因：两个系统同时运作。

解决：选择其一。OptMem 的优势是跨平台（Claude Code / Codex / Copilot 通用）。

踩坑 5：中文编码问题

症状：记忆文件中的中文显示乱码。

原因：Shell 环境未设置 UTF-8。

解决：在脚本开头添加 export LANG=en_US.UTF-8。

FAQ

Q1: OptMem 是否免费？

A: 完全开源（MIT 许可证），无需任何付费服务。

Q2: 与 Claude Memory 有什么区别？

A: Claude Memory 绑定 Claude 平台，OptMem 跨所有 Agent 通用。OptMem 也更轻量（426 Token vs 数 KB 的系统 prompt）。

Q3: 存储容量有限制吗？

A: 仅受文件系统限制。建议保持在 10KB 以内以确保 Agent 上下文窗口有足够空间。

Q4: 能否多人共享记忆？

A: 支持。将 .optmem/ 目录加入 Git 仓库，团队成员共享项目记忆。

Q5: 是否支持结构化记忆？

A: 支持。记忆文件使用 Markdown 格式，可包含表格、列表、代码块等结构化内容。

参考链接

• 官方 GitHub

本文基于公开资料整理，AI 辅助生成，数据截至 2026-08-05。具体功能请以官方文档为准。