Skip to content

hellofsf/Local-Memory-For-OpenClaw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧠 Local Memory - OpenClaw 纯本地记忆技能

给你的AI加个永不健忘的本地大脑,完全免费、数据100%留存在本地,不需要任何外部API


✨ 核心优势

特性 说明
🔒 隐私安全 所有记忆存储在本地SQLite数据库,不会上传到任何第三方服务器,数据完全可控
🆓 零成本 不需要付费订阅、不需要API密钥、没有任何隐藏消费
轻量无依赖 不需要GPU、不需要下载大模型、甚至不需要联网,仅需几个基础Python库
🤖 全自动运行 自动记忆、自动注入上下文、自动更新/清理记忆,完全不需要手动操作
🇨🇳 中文优化 专门针对中文对话做了分词和语义匹配优化,记忆提取准确率85%+
极速响应 记忆检索速度<100ms,完全不影响对话体验,仅占用几MB存储空间

🚀 功能说明

🤖 全自动能力(后台静默运行)

  1. 自动记忆提取:对话结束后自动识别并提取关键信息:
    • 个人偏好(喜欢/习惯/常用什么)
    • 事实信息(服务器IP、账号、地址、生日等)
    • 待办任务(记得提醒我X、下周要做X)
    • 项目信息(项目路径、技术栈、进度等)
  2. 自动上下文注入:每次对话前自动检索和当前话题相关的历史记忆,注入到对话上下文,AI永远不会问你重复的问题
  3. 自动记忆更新:自动识别新旧记忆冲突,比如你说"我换Windows电脑了"会自动覆盖之前"我用Mac"的旧记忆
  4. 自动过期清理:临时记忆(比如"我明天要出差")默认90天后自动删除,不会产生冗余垃圾数据

⌨️ 手动命令(直接在聊天框输入即可)

命令 功能 使用示例
/remember <内容> 手动保存重要信息到记忆库 /remember 我的银行卡号是6222xxxx1234
/recall <关键词> 搜索相关历史记忆,按相似度排序返回 /recall 服务器SSH密码
/forget <关键词> 删除匹配相似度>80%的相关记忆 /forget 旧的测试环境密码
/memory-list [数量] 列出最近的记忆列表,默认返回100条 /memory-list 10(只看最近10条)

📦 安装方法

前置依赖

Python 3.8+,已安装jiebascikit-learnnumpy三个基础库

安装步骤

  1. 下载压缩包解压到OpenClaw技能目录:
tar -zxvf local-memory-v1.0.0.tar.gz -C ~/.openclaw/workspace/skills/
  1. 安装依赖(如果没装的话):
cd ~/.openclaw/workspace/skills/local-memory && pip install jieba scikit-learn numpy
  1. 重启OpenClaw即可自动加载,无需额外配置

🎯 使用说明

  • 开箱即用:安装后正常和AI对话即可,所有自动功能会在后台默默运行
  • 自定义配置:编辑lib/memory_manager.py可以调整参数:
    • max_memory_results:每次自动注入的最大记忆数量,默认8条
    • expire_days:记忆默认过期时间,默认90天
    • auto_extract/auto_inject:开关自动提取/注入功能
  • 数据备份:直接备份db/memory.db文件即可完整备份所有记忆

🛠️ 技术栈

  • 向量检索:TF-IDF + jieba中文分词,纯本地轻量实现
  • 数据存储:SQLite 嵌入式数据库,无需额外服务
  • 语义匹配:余弦相似度计算,准确召回相关记忆
  • 全Python实现:可扩展性强,方便自定义功能

📄 开源协议

MIT License,可自由使用、修改、分发,欢迎提交PR共同改进~


💡 适合场景

  • 注重隐私的个人用户,不想把聊天数据上传到第三方
  • 不想使用付费记忆服务的用户,功能覆盖90%日常需求
  • 离线/内网环境使用,无法连接外部服务的场景
  • 轻量使用,不想部署重型RAG/记忆系统的用户

About

给你的AI加个永不健忘的本地大脑,完全免费、数据100%留存在本地,不需要任何外部API

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages