openclaw-mem 1.0.1 → 1.0.3

package/README.md

@@ -5,6 +5,8 @@
 [![npm version](https://badge.fury.io/js/openclaw-mem.svg)](https://www.npmjs.com/package/openclaw-mem)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+English | [中文](README_CN.md)
+
 OpenClaw-Mem automatically captures your conversations and makes them searchable, allowing your AI assistant to remember what you've discussed across sessions.
 
 ## ✨ Features
@@ -34,7 +36,6 @@ That's it! Start chatting and your conversations will be remembered.
 
 Ask your AI assistant:
 - "What did we discuss before?"
-- "我们之前讨论过什么？"
 - "What were we working on last time?"
 - "Remind me about the authentication issue"
 
@@ -55,22 +56,23 @@ npx openclaw-mem uninstall
 ## 🏗️ How It Works
 
 ```
-┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
-│    Telegram     │────▶│  OpenClaw Gateway │────▶│   AI Agent      │
-└─────────────────┘     └──────────────────┘     └─────────────────┘
-                               │                         │
-                               ▼                         ▼
-                        ┌──────────────┐          ┌─────────────┐
-                        │ openclaw-mem │          │  Read Tool  │
-                        │    hook      │          └─────────────┘
-                        └──────────────┘                 │
-                               │                         ▼
-        ┌──────────────────────┼─────────────────────────┘
-        ▼                      ▼
-┌───────────────┐      ┌──────────────────┐
-│  SQLite DB    │      │ SESSION-MEMORY.md │
-│ (persistent)  │      │   (injected)      │
-└───────────────┘      └──────────────────┘
++-------------+     +------------------+     +------------+
+|  Telegram   | --> | OpenClaw Gateway | --> |  AI Agent  |
++-------------+     +------------------+     +------------+
+                            |                      |
+                            v                      v
+                    +--------------+        +------------+
+                    | openclaw-mem |        | Read Tool  |
+                    |    hook      |        +------------+
+                    +--------------+               |
+                            |                      v
+        +-------------------+----------------------+
+        |                   |
+        v                   v
++---------------+   +------------------+
+|   SQLite DB   |   | SESSION-MEMORY.md|
+|  (persistent) |   |    (injected)    |
++---------------+   +------------------+
 ```
 
 ### Event Flow
@@ -116,12 +118,12 @@ Add your preferences to `~/.openclaw/workspace/MEMORY.md`:
 - Current project: Building a chat application
 ```
 
-### Topic Keywords
+### Dynamic Topic Detection
 
-The system automatically searches for these topic keywords:
-- AI/Machine Learning: `短期记忆`, `长期记忆`, `向量数据库`, `RAG`
-- Health/Fitness: `长寿`, `禁食`, `力量训练`, `有氧运动`
-- Programming: `Node.js`, `TypeScript`, `微服务`, `架构`
+The system automatically extracts topics from your actual conversations:
+- Concepts mentioned frequently are detected automatically
+- No hardcoded keywords - everything comes from your data
+- Topics evolve as your discussions change
 
 ## 🔧 Troubleshooting
 

package/README_CN.md

@@ -0,0 +1,184 @@
+# OpenClaw-Mem 🧠
+
+> 为你的 OpenClaw AI 代理提供持久长期记忆
+
+[![npm version](https://badge.fury.io/js/openclaw-mem.svg)](https://www.npmjs.com/package/openclaw-mem)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+[English](README.md) | 中文
+
+OpenClaw-Mem 自动捕获你的对话并使其可搜索，让你的 AI 助手能够记住跨会话讨论的内容。
+
+## ✨ 功能特性
+
+- **🔄 自动记忆捕获** - 对话自动保存
+- **🔍 全文搜索** - 搜索你的整个对话历史
+- **📊 渐进式披露** - 分层上下文，高效使用 token
+- **🎯 话题检测** - 自动按话题索引讨论内容
+- **💾 本地存储** - 所有数据保存在你的机器上（SQLite）
+- **⚡ 零配置** - 开箱即用
+
+## 🚀 快速开始
+
+```bash
+# 一键安装和设置！
+npx openclaw-mem init
+
+# 重启 OpenClaw 网关
+openclaw gateway restart
+```
+
+就这样！开始聊天，你的对话将被记住。
+
+## 📖 使用方法
+
+### 在聊天中回忆记忆
+
+询问你的 AI 助手：
+- "我们之前讨论过什么？"
+- "上次我们在做什么？"
+- "提醒我关于认证问题的事"
+
+### CLI 命令
+
+```bash
+# 查看记忆状态
+npx openclaw-mem status
+
+# 搜索记忆
+npx openclaw-mem search "认证"
+npx openclaw-mem search "AI 记忆"
+
+# 卸载（保留数据库）
+npx openclaw-mem uninstall
+```
+
+## 🏗️ 工作原理
+
+```
++-------------+     +------------------+     +------------+
+|  Telegram   | --> | OpenClaw Gateway | --> |  AI Agent  |
++-------------+     +------------------+     +------------+
+                            |                      |
+                            v                      v
+                    +--------------+        +------------+
+                    | openclaw-mem |        | Read Tool  |
+                    |    hook      |        +------------+
+                    +--------------+               |
+                            |                      v
+        +-------------------+----------------------+
+        |                   |
+        v                   v
++---------------+   +------------------+
+|   SQLite DB   |   | SESSION-MEMORY.md|
+|   (持久存储)   |   |    (注入上下文)   |
++---------------+   +------------------+
+```
+
+### 事件流程
+
+1. **`gateway:startup`** - 初始化记忆数据库
+2. **`agent:bootstrap`** - 向新会话注入历史上下文
+3. **`command:new`** - 开始新对话时保存会话摘要
+
+### 渐进式披露
+
+为优化 token 使用，记忆按层级组织：
+
+| 层级 | 内容 | Token 消耗 |
+|------|------|-----------|
+| 索引 | 所有观察的紧凑表格 | 低 |
+| 话题 | 关键讨论摘要 | 中 |
+| 详情 | 完整内容（按需） | 高 |
+
+## 📁 文件位置
+
+| 文件 | 位置 | 用途 |
+|------|------|------|
+| 数据库 | `~/.openclaw-mem/memory.db` | 持久存储 |
+| Hook | `~/.openclaw/hooks/openclaw-mem/` | 事件处理器 |
+| 记忆上下文 | `~/.openclaw/workspace/SESSION-MEMORY.md` | 注入的上下文 |
+
+## ⚙️ 配置
+
+### 自定义 MEMORY.md
+
+在 `~/.openclaw/workspace/MEMORY.md` 中添加你的偏好：
+
+```markdown
+## 用户偏好
+- 沟通风格：技术性且简洁
+- 语言：中文
+
+## 长期上下文
+- 正在做：AI 记忆系统
+- 兴趣：机器学习、分布式系统
+
+## 当前关注
+- 当前项目：构建聊天应用
+```
+
+### 动态话题检测
+
+系统自动从你的实际对话中提取话题：
+- 频繁提及的概念会被自动检测
+- 没有硬编码关键词 - 一切来自你的数据
+- 话题随你的讨论内容变化
+
+## 🔧 故障排除
+
+### 记忆没有被回忆？
+
+1. **重启网关：**
+   ```bash
+   openclaw gateway restart
+   ```
+
+2. **检查 hook 是否安装：**
+   ```bash
+   ls ~/.openclaw/hooks/openclaw-mem/
+   ```
+
+3. **验证数据库有内容：**
+   ```bash
+   npx openclaw-mem status
+   ```
+
+### 搜索找不到结果？
+
+- 尝试更简单的搜索词
+- 检查拼写错误
+- 使用实际对话中的关键词
+
+### 数据库问题？
+
+```bash
+# 重置数据库（⚠️ 删除所有记忆）
+rm ~/.openclaw-mem/memory.db
+openclaw gateway restart
+```
+
+## 🤝 贡献
+
+欢迎贡献！请随时提交 Pull Request。
+
+1. Fork 仓库
+2. 创建你的功能分支 (`git checkout -b feature/amazing-feature`)
+3. 提交更改 (`git commit -m 'Add amazing feature'`)
+4. 推送到分支 (`git push origin feature/amazing-feature`)
+5. 打开 Pull Request
+
+## 📄 许可证
+
+MIT 许可证 - 详见 [LICENSE](LICENSE)
+
+## 🙏 致谢
+
+- 灵感来自 [claude-mem](https://github.com/anthropics/claude-mem)
+- 为 [OpenClaw](https://openclaw.ai) 构建
+
+---
+
+<p align="center">
+  用 ❤️ 为 AI 社区制作
+</p>

package/lib/context-builder.js

@@ -186,49 +186,63 @@ function buildRetrievalInstructions() {
 }
 
 /**
- * Build topic summaries from database search
+ * Build topic summaries from user's actual recorded concepts
+ * Dynamically extracts topics from what the user has discussed
  */
 function buildTopicSummaries() {
-  // Key topics to search for (based on common interests)
-  const topics = [
-    { name: 'AI记忆系统', keywords: ['短期记忆', '长期记忆', 'AI记忆', '向量数据库', 'RAG'] },
-    { name: '长寿与健身', keywords: ['长寿', '禁食', '热量限制', '力量训练', '有氧运动'] },
-    { name: '编程技术', keywords: ['Node.js', 'TypeScript', '微服务', '架构'] }
-  ];
-
-  const sections = [];
-
-  for (const topic of topics) {
-    const topicResults = [];
-    for (const kw of topic.keywords) {
-      try {
-        const results = database.searchObservations(kw, 2);
-        for (const r of results) {
-          // Avoid duplicates
-          if (!topicResults.find(t => t.id === r.id)) {
-            topicResults.push(r);
-          }
-        }
-      } catch (e) {
-        // Search might fail, continue
+  // Get all recent observations to extract actual concepts
+  const recentObs = database.getRecentObservations(null, 100);
+
+  // Extract and count concepts from user's actual data
+  const conceptCounts = {};
+  for (const obs of recentObs) {
+    if (obs.concepts) {
+      const concepts = obs.concepts.split(',').map(c => c.trim()).filter(c => c.length > 1);
+      for (const concept of concepts) {
+        // Skip generic tool names
+        if (['edit', 'bash', 'read', 'grep', 'write', 'glob'].includes(concept.toLowerCase())) continue;
+        conceptCounts[concept] = (conceptCounts[concept] || 0) + 1;
       }
     }
+  }
+
+  // Get top concepts (mentioned at least twice)
+  const topConcepts = Object.entries(conceptCounts)
+    .filter(([_, count]) => count >= 2)
+    .sort((a, b) => b[1] - a[1])
+    .slice(0, 10)
+    .map(([concept, _]) => concept);
+
+  if (topConcepts.length === 0) return '';
 
-    if (topicResults.length > 0) {
-      sections.push(`### ${topic.name}`);
-      sections.push('');
-      for (const r of topicResults.slice(0, 3)) {
-        const summary = r.summary || '';
-        if (summary.length > 30) {
-          sections.push(`- **#${r.id}**: ${summary.slice(0, 150)}${summary.length > 150 ? '...' : ''}`);
+  const sections = [];
+  const seenIds = new Set();
+
+  // Search for each top concept
+  for (const concept of topConcepts.slice(0, 5)) {
+    try {
+      const results = database.searchObservations(concept, 3);
+      const newResults = results.filter(r => !seenIds.has(r.id));
+
+      if (newResults.length > 0) {
+        sections.push(`### ${concept}`);
+        sections.push('');
+        for (const r of newResults.slice(0, 2)) {
+          seenIds.add(r.id);
+          const summary = r.summary || '';
+          if (summary.length > 20) {
+            sections.push(`- **#${r.id}**: ${summary.slice(0, 150)}${summary.length > 150 ? '...' : ''}`);
+          }
         }
+        sections.push('');
       }
-      sections.push('');
+    } catch (e) {
+      // Search might fail, continue
     }
   }
 
   if (sections.length > 0) {
-    return '## 历史话题讨论\n\n' + sections.join('\n');
+    return '## 历史话题讨论\n\n基于您的实际对话自动提取的主题：\n\n' + sections.join('\n');
   }
   return '';
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-mem",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Persistent memory system for OpenClaw - Give your AI agent long-term memory",
   "type": "module",
   "main": "lib/handler.js",
@@ -49,6 +49,7 @@
     "scripts/commands.js",
     "docs/",
     "README.md",
+    "README_CN.md",
     "LICENSE"
   ],
   "openclaw": {