@mnemosyne/openclaw-memory

OpenClaw plugin that replaces the built-in memory system with Mnemosyne Memory Engine — biologically-inspired cognitive memory with forgetting curves, spaced repetition (FSRS), and MnemoCoin tokenomics.

Claims the exclusive memory slot — when installed, OpenClaw routes all memory operations through Mnemosyne instead of its default system.

Features

• Exclusive memory slot — auto-recall at conversation start, auto-retain at end
• 8 tools — store, search, recall, review, consolidate, associate, soul_store, engine_stats
• Slash commands — /remember, /recall, /forget, /dream, /soul, /mnemo-stats
• Auto-retain — important memories detected and stored automatically on conversation end
• All outputs scrubbed — secret redaction on every tool response

Installation

1. Disable built-in memory

Edit your openclaw.json:

{
  "memory": "none"
}

2. Install the plugin

cd integrations/openclaw-plugin
npm install
npm run build

Then register in your OpenClaw config:

{
  "plugins": [
    {
      "name": "@mnemosyne/openclaw-memory",
      "path": "./integrations/openclaw-plugin/dist/index.js"
    }
  ]
}

3. Set environment

export MNEMOSYNE_API_URL=http://localhost:8000

How It Works

1. Conversation starts → plugin auto-recalls relevant memories from Mnemosyne
2. During conversation → agent uses search, store, review tools naturally
3. Conversation ends → plugin auto-retains important new information
4. Background → Mnemosyne runs forgetting curves, consolidation, and MnemoCoin valuation

Environment Variables

Build

npm install
npm run build   # → dist/

Compatibility

While designed for OpenClaw's plugin system, the core module exports standard functions usable by any agent framework. The MCP server (@mnemosyne/mcp-server) provides the universal protocol interface.

License

MIT — J&B Enterprise LLC