openclaw-mem 1.0.3 → 1.2.1

package/setup.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+/**
+ * OpenClaw-Mem Setup Script
+ *
+ * Prompts for DeepSeek API key and saves configuration
+ */
+
+import readline from 'readline';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const CONFIG_DIR = path.join(os.homedir(), '.openclaw-mem');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+
+function question(prompt) {
+  return new Promise((resolve) => {
+    rl.question(prompt, resolve);
+  });
+}
+
+async function setup() {
+  console.log('\n');
+  console.log('╔════════════════════════════════════════════════════════════╗');
+  console.log('║           🧠 OpenClaw-Mem Setup                            ║');
+  console.log('╚════════════════════════════════════════════════════════════╝');
+  console.log('\n');
+
+  // Ensure config directory exists
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+
+  // Load existing config
+  let config = {};
+  if (fs.existsSync(CONFIG_FILE)) {
+    try {
+      config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+    } catch (e) {
+      config = {};
+    }
+  }
+
+  // Check if already configured
+  const existingKey = process.env.DEEPSEEK_API_KEY || config.deepseekApiKey;
+  if (existingKey) {
+    const maskedKey = existingKey.slice(0, 8) + '...' + existingKey.slice(-4);
+    console.log(`✓ DeepSeek API Key already configured: ${maskedKey}`);
+
+    const reconfigure = await question('\nDo you want to reconfigure? (y/N): ');
+    if (reconfigure.toLowerCase() !== 'y') {
+      console.log('\nSetup complete! OpenClaw-Mem is ready to use.\n');
+      rl.close();
+      return;
+    }
+  }
+
+  console.log('DeepSeek API is used for AI-powered session summarization.');
+  console.log('Get your API key at: https://platform.deepseek.com/\n');
+  console.log('(Press Enter to skip if you don\'t have one yet)\n');
+
+  const apiKey = await question('Enter your DeepSeek API Key: ');
+
+  if (apiKey.trim()) {
+    config.deepseekApiKey = apiKey.trim();
+
+    // Save to config file
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+    console.log(`\n✓ API Key saved to ${CONFIG_FILE}`);
+
+    // Suggest adding to shell profile
+    console.log('\n📝 To use the API key, add this to your shell profile (~/.bashrc or ~/.zshrc):');
+    console.log(`\n   export DEEPSEEK_API_KEY="${apiKey.trim()}"\n`);
+
+    // Ask if user wants to auto-add
+    const autoAdd = await question('Add to ~/.zshrc automatically? (y/N): ');
+    if (autoAdd.toLowerCase() === 'y') {
+      const zshrc = path.join(os.homedir(), '.zshrc');
+      const exportLine = `\n# OpenClaw-Mem DeepSeek API\nexport DEEPSEEK_API_KEY="${apiKey.trim()}"\n`;
+
+      try {
+        fs.appendFileSync(zshrc, exportLine);
+        console.log('\n✓ Added to ~/.zshrc');
+        console.log('  Run `source ~/.zshrc` or restart your terminal to apply.\n');
+      } catch (e) {
+        console.log(`\n⚠ Could not write to ~/.zshrc: ${e.message}`);
+        console.log('  Please add the export line manually.\n');
+      }
+    }
+  } else {
+    console.log('\n⚠ No API key provided. AI summarization will be disabled.');
+    console.log('  You can run `npx openclaw-mem-setup` later to configure.\n');
+  }
+
+  // Additional configuration
+  console.log('─'.repeat(60));
+  console.log('\n📁 Data storage location: ~/.openclaw-mem/');
+  console.log('📊 Database: ~/.openclaw-mem/memory.db');
+  console.log('🔌 HTTP API port: 18790');
+  console.log('\n✓ Setup complete! OpenClaw-Mem is ready to use.\n');
+
+  rl.close();
+}
+
+// Run setup
+setup().catch(err => {
+  console.error('Setup failed:', err.message);
+  process.exit(1);
+});

package/sync-recent.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+/**
+ * Sync recent messages from OpenClaw session files to database
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import Database from 'better-sqlite3';
+
+const SESSION_FILE = path.join(os.homedir(), '.openclaw/agents/main/sessions/b99a8d14-5b71-4f2d-8fb1-25b48cf4aa68.jsonl');
+const DB_PATH = path.join(os.homedir(), '.openclaw-mem/memory.db');
+
+const db = new Database(DB_PATH);
+const insert = db.prepare(`
+  INSERT INTO observations (session_id, timestamp, tool_name, tool_input, tool_response, summary, concepts, tokens_discovery, tokens_read)
+  VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+`);
+
+const content = fs.readFileSync(SESSION_FILE, 'utf-8');
+const lines = content.trim().split('\n').slice(-30); // Last 30 lines
+
+let saved = 0;
+for (const line of lines) {
+  try {
+    const entry = JSON.parse(line);
+    if (entry.type === 'message' && entry.message) {
+      const role = entry.message.role;
+      let text = '';
+      if (Array.isArray(entry.message.content)) {
+        text = entry.message.content.map(c => c.text || c).join(' ');
+      } else {
+        text = entry.message.content || '';
+      }
+
+      if (!text.trim()) continue;
+
+      const toolName = role === 'user' ? 'UserMessage' : 'AssistantMessage';
+      const summary = text.slice(0, 100) + (text.length > 100 ? '...' : '');
+
+      try {
+        insert.run(
+          'live-sync',
+          entry.timestamp || new Date().toISOString(),
+          toolName,
+          JSON.stringify({ role }),
+          JSON.stringify({ content: text.slice(0, 2000) }),
+          summary,
+          text.slice(0, 500),
+          Math.ceil(text.length / 4),
+          Math.ceil(summary.length / 4)
+        );
+        saved++;
+        console.log(`✓ [${role}] ${text.slice(0, 50)}...`);
+      } catch (e) {
+        // Skip duplicates
+      }
+    }
+  } catch (e) {}
+}
+
+console.log(`\n已同步 ${saved} 条消息`);
+db.close();

package/README_CN.md

@@ -1,184 +0,0 @@
-# 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/bin/openclaw-mem.js

@@ -1,117 +0,0 @@
-#!/usr/bin/env node
-/**
- * OpenClaw-Mem CLI
- *
- * Usage:
- *   npx openclaw-mem init     - Install hook to OpenClaw
- *   npx openclaw-mem status   - Show memory statistics
- *   npx openclaw-mem search   - Search memory
- *   npx openclaw-mem uninstall - Remove hook
- */
-
-import { fileURLToPath } from 'node:url';
-import path from 'node:path';
-import fs from 'node:fs';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const args = process.argv.slice(2);
-const command = args[0];
-
-// Colors for terminal output
-const c = {
-  reset: '\x1b[0m',
-  green: '\x1b[32m',
-  red: '\x1b[31m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  cyan: '\x1b[36m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m'
-};
-
-function log(msg, color = 'reset') {
-  console.log(`${c[color]}${msg}${c.reset}`);
-}
-
-function printBanner() {
-  console.log(`
-${c.cyan}╔══════════════════════════════════════════════════════════╗
-║                                                          ║
-║   ${c.bold}OpenClaw-Mem${c.reset}${c.cyan} - Persistent Memory for OpenClaw        ║
-║                                                          ║
-╚══════════════════════════════════════════════════════════╝${c.reset}
-`);
-}
-
-function printUsage() {
-  console.log(`
-${c.bold}Usage:${c.reset}
-  npx openclaw-mem <command>
-
-${c.bold}Commands:${c.reset}
-  ${c.green}init${c.reset}        Install openclaw-mem hook to your OpenClaw setup
-  ${c.green}status${c.reset}      Show memory database statistics
-  ${c.green}search${c.reset}      Search your memory (e.g., npx openclaw-mem search "topic")
-  ${c.green}uninstall${c.reset}   Remove openclaw-mem from OpenClaw
-  ${c.green}help${c.reset}        Show this help message
-
-${c.bold}Examples:${c.reset}
-  ${c.dim}# First time setup${c.reset}
-  npx openclaw-mem init
-
-  ${c.dim}# Check what's stored${c.reset}
-  npx openclaw-mem status
-
-  ${c.dim}# Search for conversations about AI${c.reset}
-  npx openclaw-mem search "AI memory"
-
-${c.bold}Learn more:${c.reset}
-  https://github.com/anthropics/openclaw-mem
-`);
-}
-
-async function main() {
-  if (!command || command === 'help' || command === '--help' || command === '-h') {
-    printBanner();
-    printUsage();
-    process.exit(0);
-  }
-
-  switch (command) {
-    case 'init': {
-      const { init } = await import('../scripts/init.js');
-      await init();
-      break;
-    }
-    case 'status': {
-      const { status } = await import('../scripts/commands.js');
-      await status();
-      break;
-    }
-    case 'search': {
-      const query = args.slice(1).join(' ');
-      if (!query) {
-        log('Error: Please provide a search query', 'red');
-        log('Usage: npx openclaw-mem search "your query"', 'dim');
-        process.exit(1);
-      }
-      const { search } = await import('../scripts/commands.js');
-      await search(query);
-      break;
-    }
-    case 'uninstall': {
-      const { uninstall } = await import('../scripts/init.js');
-      await uninstall();
-      break;
-    }
-    default:
-      log(`Unknown command: ${command}`, 'red');
-      printUsage();
-      process.exit(1);
-  }
-}
-
-main().catch(err => {
-  log(`Error: ${err.message}`, 'red');
-  process.exit(1);
-});