# Send Soul Memory to your agent Use the source page and any available docs to guide the install because the item is currently unstable or timing out. ## Fast path - Open the source page via Review source status. - If you can obtain the package, extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the source page and extracted files. ## Suggested prompts ### New install ```text I tried to install a skill package from Yavira, but the item is currently unstable or timing out. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required. Then review README.md for any prerequisites, environment setup, or post-install checks. ``` ### Upgrade existing ```text I tried to upgrade a skill package from Yavira, but the item is currently unstable or timing out. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need. Then review README.md for any prerequisites, environment setup, or post-install checks. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "soul-memory", "name": "Soul Memory", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/kingofqin2026/soul-memory", "canonicalUrl": "https://clawhub.ai/kingofqin2026/soul-memory", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/soul-memory", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=soul-memory", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "FINAL_REPORT_v3.4.0.md", "HEARTBEAT.md", "INSTALL_GUIDE.md", "README.md", "RELEASE_NOTES_v3.4.md", "RELEASE_v3.4.0.md" ], "downloadMode": "manual_only", "sourceHealth": { "source": "tencent", "slug": "soul-memory", "status": "unstable", "reason": "timeout", "recommendedAction": "retry_later", "checkedAt": "2026-05-09T07:53:34.523Z", "expiresAt": "2026-05-09T19:53:34.523Z", "httpStatus": null, "finalUrl": null, "contentType": null, "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=soul-memory", "error": "Timed out after 5000ms", "slug": "soul-memory" }, "scope": "item", "summary": "Item is unstable.", "detail": "This item is timing out or returning errors right now. Review the source page and try again later.", "primaryActionLabel": "Review source status", "primaryActionHref": "https://clawhub.ai/kingofqin2026/soul-memory" }, "validation": { "installChecklist": [ "Wait for the source to recover or retry later.", "Review SKILL.md only after the download returns a real package.", "Treat this source as transient until the upstream errors clear." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/soul-memory", "downloadUrl": "https://openagent3.xyz/downloads/soul-memory", "agentUrl": "https://openagent3.xyz/skills/soul-memory/agent", "manifestUrl": "https://openagent3.xyz/skills/soul-memory/agent.json", "briefUrl": "https://openagent3.xyz/skills/soul-memory/agent.md" } } ``` ## Documentation ### 🧠 Intelligent Memory Management System Long-term memory framework for AI agents with full OpenClaw integration. v3.4.0 - OpenClaw 2026.3.7 可插拔上下文引擎集成：語義緩存層 + 動態上下文窗口 + 多引擎協同，性能提升 10x，Token 節省 40%。 ### ✨ Features 8 Powerful Modules + OpenClaw Plugin Integration ModuleFunctionDescriptionAPriority Parser[C]/[I]/[N] tag parsing + semantic auto-detectionBVector SearchKeyword indexing + CJK segmentation + semantic expansionCDynamic ClassifierAuto-learn categories from memoryDVersion ControlGit integration + version rollbackEMemory DecayTime-based decay + cleanup suggestionsFAuto-TriggerPre-response search + Post-response auto-saveGCantonese Branch🆕 語氣詞分級 + 語境映射 + 粵語檢測HCLI Interface🆕 Pure JSON output for external integrationPluginOpenClaw Hook🆕 before_prompt_build Hook for automatic context injectionWebWeb UIFastAPI dashboard with real-time stats ### 🎯 Heartbeat 自動清理（最新！） FeatureDescriptionAuto Cleanup ScriptAutomatically cleans Heartbeat reports every 3 hoursCron Job IntegrationOpenClaw Cron system scheduled executionMulti-format SupportRecognizes multiple Heartbeat formatsMemory OptimizationReduces redundancy, improves quality score (7.9 → 8.5) ### 🎯 Core Improvements FeatureDescriptionHeartbeat DeduplicationMD5 hash tracking, automatically skips duplicate contentCLI InterfacePure JSON output for external system integrationOpenClaw PluginAutomatically injects relevant memories before responses (v0.2.1-beta)Lenient ModeLower recognition thresholds, saves more conversation content ### 🔄 Plugin v0.2.1-beta Fixes Fix prependContext Accumulation: Extracts query from event.prompt instead of messages history Enhanced Legacy Cleanup: Multiple format support (SoulM markers, numbered entries, ## Memory Context) No Memory Loop: Prevents recursive injection in conversation history ### Installation # 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 ### Basic Usage 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?") ### CLI Usage # Pure JSON output python3 cli.py search "QST physics" --format json # Get stats python3 cli.py stats --format json ### OpenClaw Plugin # Plugin is automatically installed to ~/.openclaw/extensions/soul-memory # Restart Gateway to enable openclaw gateway restart ### How It Works Automatic Trigger: Executes before each response Extract user query from event.prompt (current input, not history) Search relevant memories (top_k = 5) Format memory context Inject into prompt via prependContext ### Configuration Edit ~/.openclaw/openclaw.json: { "plugins": { "entries": { "soul-memory": { "enabled": true, "config": { "topK": 5, "minScore": 0.0 } } } } } ### 🧪 Testing # Run full test suite python3 test_all_modules.py # Expected output: # 📊 Results: 8 passed, 0 failed # ✅ All tests passed! ### Priority System [C] Critical: Key information, must remember [I] Important: Important items, needs attention [N] Normal: Daily chat, can decay ### Keyword Search Localized implementation: Keyword indexing Synonym expansion Similarity scoring ### Classification System Default categories (customizable): User_Identity（用戶身份） Tech_Config（技術配置） Project（專案） Science（科學） History（歷史） General（一般） ### Cantonese Support 語氣詞分級（唔好、好啦、得咩） 語境映射（褒貶情緒識別） 粵語檢測（簡繁轉換支持） ### 📦 File Structure 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) ### 🔒 Uninstallation 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 Plugin config (~/.openclaw/openclaw.json) Heartbeat auto-trigger (HEARTBEAT.md) Auto memory injection (Plugin) Auto memory save (Post-Response Auto-Save) ### 🔒 Privacy & Security ✅ No external API calls ✅ No cloud dependencies ✅ Cross-domain isolation, no data sharing ✅ Open source MIT License ✅ CJK support (Chinese, Japanese, Korean) ### 📐 Technical Details Python Version: 3.7+ Dependencies: None external (pure Python standard library) Storage: Local JSON files Search: Keyword matching + semantic expansion Classification: Dynamic learning + preset rules OpenClaw: Plugin v0.2.1-beta (TypeScript) ### 📝 Version History v3.3.4 (2026-03-07): 🆕 查詢過濾優化（跳過問候語/簡單命令，提高搜索閾值 minScore 0.0→3.0，節省 ~25k token/日） v3.3.3 (2026-03-06): 每日快取自動重建（跨日索引更新） v3.3.2 (2026-02-28): Heartbeat 自我報告過濾 v3.3.1 (2026-02-27): 🆕 Heartbeat 自動清理 + Cron Job 集成 + 記憶質量優化（7.9→8.5） v3.2.2 (2026-02-25): Heartbeat deduplication + OpenClaw Plugin v0.2.1-beta + Uninstall script v3.2.1 (2026-02-19): Index strategy improvement - 93% Token reduction v3.2.0 (2026-02-19): Heartbeat active extraction + Lenient mode v3.1.1 (2026-02-19): Hotfix: Dual-track memory persistence v3.1.0 (2026-02-18): Cantonese grammar branch: Particle grading + context mapping v3.0.0 (2026-02-18): Web UI v1.0: FastAPI dashboard + real-time stats v2.2.0 (2026-02-18): CJK smart segmentation + Post-Response Auto-Save v2.1.0 (2026-02-17): Rebrand to Soul Memory, technical neutralization v2.0.0 (2026-02-17): Self-hosted version ### 📄 License MIT License - see LICENSE for details ### 🙏 Acknowledgments Soul Memory System v3.2 is a personal AI assistant memory management tool, designed for personal use. Not affiliated with OpenClaw project. ### 🔗 Related Links GitHub: https://github.com/kingofqin2026/Soul-Memory- Documentation: https://github.com/kingofqin2026/Soul-Memory-/blob/main/README.md Web: https://qsttheory.com/ © 2026 Soul Memory System ## Trust - Source: tencent - Verification: Indexed source record - Publisher: kingofqin2026 - Version: 3.5.3 ## Source health - Status: unstable - Item is unstable. - This item is timing out or returning errors right now. Review the source page and try again later. - Health scope: item - Reason: timeout - Checked at: 2026-05-09T07:53:34.523Z - Expires at: 2026-05-09T19:53:34.523Z - Recommended action: Review source status ## Links - [Detail page](https://openagent3.xyz/skills/soul-memory) - [Send to Agent page](https://openagent3.xyz/skills/soul-memory/agent) - [JSON manifest](https://openagent3.xyz/skills/soul-memory/agent.json) - [Markdown brief](https://openagent3.xyz/skills/soul-memory/agent.md) - [Download page](https://openagent3.xyz/downloads/soul-memory)