你是否曾为AI智能体“转头就忘”而困扰?每次对话重启,它都要重新学习你的偏好、项目背景、关键约定——这不仅低效,更阻碍真正可信的协作。OptMem 正是为此而生:一个极简却强大的永久记忆系统,无需数据库、不依赖云服务,仅用一个426词的精巧提示词+单文件Python脚本,就能让AI智能体拥有可追溯、可检索、可演化的长期记忆能力。它不是另一个大模型插件,而是为AI代理(Agent)设计的底层记忆基础设施——像给大脑装上可自动整理的“记忆皮层”。
核心功能
- 即插即用的记忆唤醒:运行
memo wake即刻加载结构化记忆摘要,作为每轮会话的固定开场白,确保AI始终“带着上下文上岗” - 原子化记忆记录:用
memo note "今天确认了API密钥有效期至2025年"一句话存入记忆,严格限制280字符,强制提炼关键信息,杜绝冗余噪音 - 智能记忆合并(Nap机制):当新记忆触发语义关联时,自动发起“合并请求”,人工确认后生成更高阶摘要,实现记忆的渐进式压缩与升华
- 精准全文检索:支持正则表达式搜索
memo recall "payment.*failed",在数千条记忆中秒级定位原始记录,不依赖向量相似度,结果确定可靠 - 记忆树可视化导航:用
memo zoom 12-34展开任意记忆节点,逐层下钻查看子摘要或原始日志,像浏览文件目录一样管理记忆层级 - 无损记忆修正:发现错误摘要?执行
memo forget 56-78删除指定区间,系统会在下次nap中基于原始日志自动重建,记忆库永远可审计、可回滚
适合哪些人用
OptMem 不是给终端用户点击的App,而是为构建专业AI应用的技术实践者打造的“隐形引擎”:AI Agent开发者(需为Claude、GPT或本地模型赋予跨会话一致性)、自动化工作流工程师(如用LangChain/LlamaIndex编排复杂任务链)、研究型提示工程师(需严谨追踪实验变量与结果),以及重视数据主权的团队——所有记忆仅存于本地 ~/.optmem/ 目录,LOG.txt 为纯文本追加日志,TREE为可完全重建的缓存,真正实现“我的记忆,我做主”。
快速上手
只需一行命令完成安装与初始化:
curl -fsSL https://raw.githubusercontent.com/VictorTaelin/OptMem/main/install.sh | sh
执行后将自动生成 ## Memory 区块,请将其粘贴到你的智能体主配置文件顶部(如 AGENTS.md 或 CLAUDE.md)。随后将 ~/.optmem 加入系统PATH,即可全局调用 memo 命令。首次使用推荐三步走:memo wake 查看当前记忆快照 → memo note "记下关键事项" 录入第一条记忆 → memo nap 处理首个合并建议。整个过程无需启动服务、不占用后台进程,完全符合Unix哲学——小而专注,静默可靠。
项目信息
Permanent memory for AI agents. A 426-token prompt, a script, plug and play.
928
Stars
52
Forks
Python
—
编程语言:Python|Star 数:928|开源协议:未明确声明(建议使用前查阅仓库最新LICENSE)|GitHub 项目地址
如果你厌倦了让AI反复解释同一份文档、重复询问已确认的需求,那么OptMem就是那个能真正让智能体“越用越懂你”的记忆基石——它不炫技,但足够聪明;不庞大,却足够可靠。



