🧠 memory-simple

Simple JSON-based Memory System for OpenClaw

A lightweight, stable alternative to LanceDB-Pro. No complex dependencies, no crashes, just reliable memory storage and retrieval.

✨ Features

🚀 Quick Start

1. Configuration

Edit config.json:

{
  "embedding": {
    "provider": "zhipu",
    "apiKey": "your-api-key",
    "model": "embedding-3",
    "dimensions": 2048
  }
}

2. Capture Memories

const { captureMemories } = require('./scripts/capture');

const conversation = [
  { role: 'user', content: '我喜欢喝咖啡' },
  { role: 'user', content: '记住我的邮箱是 user@example.com' }
];

await captureMemories(conversation, 'session-id');

3. Recall Memories

const { searchMemories } = require('./scripts/recall');

const results = await searchMemories('用户喜欢什么', {
  topK: 5,
  sessionId: 'session-id'
});

console.log(results);

📁 File Structure

memory-simple/
├── config.json              # Configuration
├── package.json
├── SKILL.md                 # This file
├── memories/
│   ├── global.json         # Global memories
│   └── sessions/           # Session-specific memories
│       ├── session-1.json
│       └── session-2.json
└── scripts/
    ├── utils.js            # Utility functions
    ├── embedder.js         # Embedding API
    ├── capture.js          # Memory capture
    └── recall.js           # Memory retrieval

⚙️ Configuration

Embedding Settings

Capture Settings

Recall Settings

🔧 API Reference

Capture Module

captureMemories(conversation, sessionId?)

Automatically extracts and stores memories from conversation.

Parameters:

• conversation (Array): Array of message objects
• sessionId (String, optional): Session identifier

Returns: Promise - Captured memories

Example:

const memories = await captureMemories([
  { role: 'user', content: '我喜欢喝茶' },
  { role: 'assistant', content: '好的' },
  { role: 'user', content: '记得提醒我下午开会' }
], 'session-123');

manualStore(content, type?, metadata?)

Manually store a memory.

Parameters:

• content (String): Memory content
• type (String): Memory type (preference, decision, important, general)
• metadata (Object): Additional metadata

Returns: Promise