菜单
Intelligent memory management system for AI agents - 8 modules + OpenClaw Plugin integration, with heartbeat deduplication, CLI interface, and full CJK support.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/johnalbertini14-glitch/openclaw-skills --skill soul-memory命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | soul-memory |
| version | 3.2.2 |
| description | Intelligent memory management system for AI agents - 8 modules + OpenClaw Plugin integration, with heartbeat deduplication, CLI interface, and full CJK support. |
| license | MIT |
| author | kingofqin2026 |
| homepage | https://github.com/kingofqin2026/Soul-Memory- |
| repository | https://github.com/kingofqin2026/Soul-Memory- |
| keywords | ["memory","ai","assistant","vector-search","openclaw","plugin","heartbeat","cli","cjk","cantonese"] |
| tags | ["Productivity","AI","Utilities","Developer-Tools"] |
Long-term memory framework for AI agents with full OpenClaw integration. Now with v3.2.2 - Heartbeat deduplication + OpenClaw Plugin v0.2.1-beta.
8 Powerful Modules + OpenClaw Plugin Integration
| Module | Function | Description |
|---|---|---|
| A | Priority Parser | [C]/[I]/[N] tag parsing + semantic auto-detection |
| B | Vector Search | Keyword indexing + CJK segmentation + semantic expansion |
| C | Dynamic Classifier | Auto-learn categories from memory |
| D | Version Control | Git integration + version rollback |
| E | Memory Decay | Time-based decay + cleanup suggestions |
| F | Auto-Trigger | Pre-response search + Post-response auto-save |
| G | Cantonese Branch | 🆕 語氣詞分級 + 語境映射 + 粵語檢測 |
| H | CLI Interface | 🆕 Pure JSON output for external integration |
| Plugin | OpenClaw Hook | 🆕 before_prompt_build Hook for automatic context injection |
| Web | Web UI | FastAPI dashboard with real-time stats |
| Feature | Description |
|---|
| Heartbeat Deduplication | MD5 hash tracking, automatically skips duplicate content |
| CLI Interface | Pure JSON output for external system integration |
| OpenClaw Plugin | Automatically injects relevant memories before responses (v0.2.1-beta) |
| Lenient Mode | Lower recognition thresholds, saves more conversation content |
event.prompt instead of messages history# Clone and install
git clone https://github.com/kingofqin2026/Soul-Memory-.git
cd Soul-Memory-
bash install.sh
# Clean install (uninstall first if needed)
bash install.sh --clean
from soul_memory.core import SoulMemorySystem
# Initialize system
system = SoulMemorySystem()
system.initialize()
# Search memories
results = system.search("user preferences", top_k=5)
# Add memory
memory_id = system.add_memory("[C] User likes dark mode")
# Pre-response trigger (auto-search before answering)
context = system.pre_response_trigger("What are user preferences?")
# Pure JSON output
python3 cli.py search "QST physics" --format json
# Get stats
python3 cli.py stats --format json
# Plugin is automatically installed to ~/.openclaw/extensions/soul-memory
# Restart Gateway to enable
openclaw gateway restart
Automatic Trigger: Executes before each response
event.prompt (current input, not history)prependContextEdit ~/.openclaw/openclaw.json:
{
"plugins": {
"entries": {
"soul-memory": {
"enabled": true,
"config": {
"topK": 5,
"minScore": 0.0
}
}
}
}
}
# Run full test suite
python3 test_all_modules.py
# Expected output:
# 📊 Results: 8 passed, 0 failed
# ✅ All tests passed!
Localized implementation:
Default categories (customizable):
soul-memory/
├── core.py # Core system
├── cli.py # CLI interface
├── install.sh # Auto-install script
├── uninstall.sh # Complete uninstall script
├── test_all_modules.py # Test suite
├── SKILL.md # ClawHub manifest (this file)
├── README.md # Documentation
├── modules/ # 6 functional modules
│ ├── priority_parser.py
│ ├── vector_search.py
│ ├── dynamic_classifier.py
│ ├── version_control.py
│ ├── memory_decay.py
│ └── auto_trigger.py
├── plugin/ # OpenClaw Plugin
│ ├── index.ts # Plugin source
│ └── openclaw.plugin.json
├── cache/ # Cache directory (auto-generated)
└── web/ # Web UI (optional)
Complete removal of all integration configs:
# Basic uninstall (will prompt for confirmation)
bash uninstall.sh
# Create backup before uninstall (recommended)
bash uninstall.sh --backup
# Auto-confirm (no manual confirmation)
bash uninstall.sh --backup --confirm
Removed Items:
~/.openclaw/openclaw.json)HEARTBEAT.md)MIT License - see LICENSE for details
Soul Memory System v3.2 is a personal AI assistant memory management tool, designed for personal use. Not affiliated with OpenClaw project.
© 2026 Soul Memory System