soul-memory
by kingofqin2026
Coding Agents & IDEsBrief
Intelligent memory management system for AI agents - 8 modules + OpenClaw Plugin integration, with heartbeat.
Description
What This Skill Does
Long-term memory framework for AI agents that stores, searches, and injects relevant memories into prompts automatically. Built on local JSON storage with keyword and semantic search, it supports priority tagging, time-based memory decay, and CJK text segmentation including Cantonese. Integrates with OpenClaw via a plugin hook that runs before each response.
Unlike RAG setups that require external vector databases or API calls, this system runs entirely on local files with no external dependencies.
When to Use It
- Persisting user preferences across sessions
- Recalling project-specific context without re-explaining
- Tagging critical vs. normal information for selective retrieval
- Running memory search from external scripts via CLI JSON output
- Keeping agent context lean by decaying old or redundant memories
Example Workflow
User asks: What display settings do I prefer?
- 1
OpenClaw plugin fires before_prompt_build hook
- 2
Plugin extracts query from event.prompt
- 3
Searches local memory store for top 5 relevant entries
- 4
Injects matched memories into prompt via prependContext
- 5
Agent responds with personalized context already loaded
Agent answers referencing stored preference: dark mode, without user re-stating it
Installation
clawhub install kingofqin2026/soul-memoryRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.