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_memories tool to save important conversations, decisions, and discoveries
• Memory search — retrieve_memories tool 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

小爪 🐾