Memory Enhancement Plugin
BGE-M3 based long-term memory enhancement plugin for OpenClaw.
Automatically retrieves relevant historical memories and injects them into conversation context.
Features
- Automatic memory retrieval — On each session start, queries the BGE-M3 API server for memories relevant to the current context, injects them into
before_prompt_build - Long-term memory storage —
add_memoriestool to save important conversations, decisions, and discoveries - Memory search —
retrieve_memoriestool to query stored memories on demand - Configurable — threshold, topK, cache, debug logging, all tunable via OpenClaw plugin config
How it works
Session Start
│
▼
before_prompt_build hook
│
├── Extract recent conversation text
├── Query BGE-M3 API (POST /retrieve)
├── Inject top-K relevant memories into prompt
│
▼
Agent response with memory context
Installation
openclaw plugins install @cv/memory-enhancement
openclaw gateway restart
Configuration
| Field | Default | Description |
|---|---|---|
| enabled | true | Enable/disable the plugin |
| apiHost | 127.0.0.1 | BGE-M3 API server host |
| apiPort | 8080 | BGE-M3 API server port |
| threshold | 0.5 | Similarity threshold (0.0–1.0) |
| topK | 3 | Max memories to inject |
| timeout | 15000 | API call timeout (ms) |
| maxRetries | 2 | Max retries on failure |
| cacheEnabled | true | Enable query cache |
| cacheTTL | 300 | Cache TTL (seconds) |
| debug | false | Verbose debug logging |
Prerequisites
- BGE-M3 API server running on the configured host:port
- OpenClaw >= 2026.4.0
Version
1.0.0 — Initial stable release
Author
小爪 🐾