Tencent SkillHub · Developer Tools

Soul Memory

Intelligent memory management system for AI agents - 8 modules + OpenClaw Plugin integration, with heartbeat deduplication, CLI interface, and full CJK support.

skill openclawclawhub Free

0 Downloads

0 Stars

0 Installs

0 Score

High Signal

Intelligent memory management system for AI agents - 8 modules + OpenClaw Plugin integration, with heartbeat deduplication, CLI interface, and full CJK support.

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Item is unstable.

This item is timing out or returning errors right now. Review the source page and try again later.

Quick setup

Wait for the source to recover or retry later.
Review SKILL.md only after the source returns a real package.
Do not rely on this source for automated install yet.

Requirements

Target platform: OpenClaw
Install method: Manual import
Extraction: Extract archive
Prerequisites: OpenClaw
Primary doc: SKILL.md

Package facts

Download mode: Manual review
Package format: ZIP package
Source platform: Tencent SkillHub
What's included: FINAL_REPORT_v3.4.0.md, HEARTBEAT.md, INSTALL_GUIDE.md, README.md, RELEASE_NOTES_v3.4.md, RELEASE_v3.4.0.md

Validation

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.

Install with your agent

Agent handoff

Use the source page and any available docs to guide the install because the item is currently unstable or timing out.

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.

New install

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

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.

Open Send to Agent page Open JSON manifest Open Markdown brief

Trust & source

Release facts

Source: Tencent SkillHub
Verification: Indexed source record
Version: 3.5.3

Provenance

Publisher: kingofqin2026
Source page: View original listing
Canonical URL: Open canonical page

Documentation

ClawHub primary doc Primary doc: SKILL.md 24 sections Open source page

🧠 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

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package

6 Docs

FINAL_REPORT_v3.4.0.md Docs
HEARTBEAT.md Docs
INSTALL_GUIDE.md Docs
README.md Docs
RELEASE_NOTES_v3.4.md Docs
RELEASE_v3.4.0.md Docs