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/month - **Value:** Saves tokens by eliminating context repetition - **ROI:** If persistent memory saves >0.5 USDT/month in tokens, it pays for itself See [AGENT-PAYMENTS.md](AGENT-PAYMENTS.md) for x402 integration details. ## Privacy - All data stored locally in `~/.openclaw/openclaw-memory/` - No external servers or telemetry - Embeddings can use local models (no API calls) - Open source - audit the code yourself ## Dashboard Access web UI at `http://localhost:9091`: - Browse and search memories - View memory timeline - Check quota and stats - Manage Pro subscription ## Foundation for Future Tools Memory System is the foundation for: - **Context Optimizer** - Uses memories to compress context - **Smart Router** - Learns routing patterns - **Rate Limit Manager** - Tracks usage patterns ## Requirements - Node.js 18+ - OpenClaw v2026.1.30+ - OS: Windows, macOS, Linux ## Links - [Documentation](README.md) - [Agent Payments Guide](AGENT-PAYMENTS.md) - [GitHub Repository](https://github.com/yourusername/openclaw-memory) - [ClawHub Page](https://clawhub.ai/skills/openclaw-memory) --- **Built by the OpenClaw community** | First memory system with x402 payments