claw-mem - OpenClaw Memory System

Make OpenClaw Truly Remember.

🚀 Quick Start

Installation

git clone https://github.com/opensourceclaw/claw-mem/claw-mem.git ~/.openclaw/workspace/skills/claw-mem
cd ~/.openclaw/workspace/skills/claw-mem
pip3 install -e .

Enable

Add to ~/.openclaw/config.json:

{
  "skills": {
    "claw-mem": {
      "enabled": true
    }
  }
}

Usage

claw-mem automatically integrates into every OpenClaw session:

1. On Start - Load relevant memories
2. During Conversation - Auto-store and retrieve
3. On End - Auto-save memories

No manual configuration required!

📁 Memory Storage

claw-mem is fully compatible with existing OpenClaw memory formats:

~/.openclaw/workspace/
├── MEMORY.md              # Core Memory (Semantic)
└── memory/
    ├── YYYY-MM-DD.md      # Daily Memory (Episodic)
    └── skills/            # Skill Memory (Procedural)

🏗️ Core Features

1. Three-Layer Memory Architecture

2. Three Memory Types

3. Hybrid Retrieval

• ✅ Keyword search
• ✅ Type filtering
• ✅ Time-based sorting
• ✅ Semantic search (optional)

4. Security Design

• ✅ Write validation (rejects imperative content)
• ✅ Checkpoints (regular snapshots)
• ✅ Audit logging (records modifications)

⚙️ Configuration (Optional)

claw-mem is zero-config by default, but you can customize:

{
  "claw-mem": {
    "storage": {
      "workspace": "~/.openclaw/workspace",
      "episodic_ttl_days": 30
    },
    "security": {
      "enable_validation": true,
      "enable_checkpoint": true,
      "enable_audit_log": true
    },
    "retrieval": {
      "max_results": 10,
      "enable_semantic_search": false
    }
  }
}

🔧 API

Python API

from claw_mem import MemoryManager

# Initialize
memory = MemoryManager(workspace="~/.openclaw/workspace")

# Start session
memory.start_session("session_001")

# Store memory
memory.store("User prefers DD/MM/YYYY date format", type="semantic")

# Retrieve memory
results = memory.search("date format", type="semantic")

# End session
memory.end_session()

OpenClaw Skill API

claw-mem automatically injects into OpenClaw sessions:

# Automatically available in OpenClaw conversations
System: Loaded 5 relevant memories
User: Did I say anything about dates before?
Agent: Yes, you prefer DD/MM/YYYY date format.

📊 Performance Targets

MVP version, data to be populated

🤝 Contributing

Community contributions are welcome!

Development Environment

git clone https://github.com/opensourceclaw/claw-mem/claw-mem.git
cd claw-mem
pip3 install -e ".[dev]"
pytest

Submit PR

1. Fork the project
2. Create feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'feat: add amazing feature')
4. Push to remote (git push origin feature/amazing-feature)
5. Create Pull Request

📄 License

Apache License 2.0

🙏 Acknowledgments

• OpenClaw Community
• All Contributors

Make OpenClaw Truly Remember. 🧠