openclaw-memory

# OpenClaw Memory System

**Persistent memory across sessions with semantic search and x402 payments.**

## What is it?

The first OpenClaw skill that gives your agents **persistent memory** - they remember facts, preferences, patterns, and conversation history across all sessions. Never repeat context again.

## Key Features

- 🧠 **Persistent Memory** - Remembers everything across sessions
- 🔍 **Semantic Search** - Find memories by meaning, not just keywords
- 🤖 **Automatic Learning** - Extracts facts and preferences automatically
- 💾 **Local Storage** - SQLite database with vector embeddings
- 💰 **x402 Payments** - Agents can pay for unlimited storage (0.5 USDT/month)

## Free vs Pro Tier

**Free Tier:**
- 100 memories maximum
- 7-day retention
- Basic semantic search

**Pro Tier (0.5 USDT/month):**
- Unlimited memories
- Permanent retention
- Advanced semantic search
- Memory relationship mapping

## Installation

```bash
claw skill install openclaw-memory
```

## Commands

```bash
# Search memories
claw memory search "What does user prefer?"

# List recent memories
claw memory list --limit=10

# Show stats
claw memory stats

# Open dashboard
claw memory dashboard

# Subscribe to Pro
claw memory subscribe
```

## How It Works

1. **Hooks into requests** - Automatically extracts important information
2. **Generates embeddings** - Creates semantic vectors for search
3. **Stores locally** - SQLite database with full privacy
4. **Retrieves on demand** - Injects relevant memories before requests
5. **Manages quota** - Prunes old memories when limits reached (Free tier)

## Use Cases

- Remember user preferences and coding style
- Store project context and requirements
- Learn patterns from repeated interactions
- Maintain conversation history across sessions
- Build knowledge base over time

## Agent Economy

Agents can autonomously evaluate if Pro tier is worth it:
- **Cost:** 0.5 USDT/mont...

# OpenClaw Memory System

**The first OpenClaw tool with persistent memory across sessions + x402 agent payments.**

Stop repeating context every session. Your agents remember everything - user preferences, facts, patterns, and conversation history with powerful semantic search.

🤖 **First memory system enabling agent autonomy** - agents can pay 0.5 USDT/month for unlimited storage. [Agent Payments →](AGENT-PAYMENTS.md)

## The Problem

OpenClaw users are experiencing:
- 🔄 **Context reset every session** - agents forget everything
- 📝 **Repeating preferences** - "I told you I prefer Python last time!"
- 🧠 **No knowledge retention** - valuable insights lost between sessions
- 💰 **Wasted tokens** - re-explaining context costs money
- 📊 **No pattern learning** - agents can't improve from past interactions

## The Solution

**Persistent memory with semantic search that works across all sessions.**

## Features

- ✅ **Persistent Memory** - Never repeat context again
- ✅ **Semantic Search** - Find relevant memories by meaning, not just keywords
- ✅ **Automatic Learning** - Extracts facts, preferences, and patterns from conversations
- ✅ **Smart Retrieval** - Injects relevant memories before each request
- ✅ **Quota Management** - Free tier (100 memories, 7 days) + Pro tier (unlimited)
- ✅ **Memory Types** - Facts, preferences, patterns, conversations
- ✅ **Web Dashboard** - Beautiful interface to browse and search memories
- ✅ **CLI Interface** - Full control from command line
- 🤖 **x402 Agent Payments** - Agents can autonomously pay for Pro tier (0.5 USDT/month)

## Why Memory System?

**The ONLY OpenClaw tool that provides persistent memory with x402 payments.**

| Feature | Memory System | Custom Context | Manual Notes | Vector DB Tools |
|---------|---------------|----------------|--------------|-----------------|
| Automatic Extraction | ✅ | ❌ | ❌ | ❌ |
| Semantic Search | ✅ | ❌ | ❌ | ✅ |
| Persistent St...