{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/soul-memory",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=soul-memory",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "FINAL_REPORT_v3.4.0.md",
      "HEARTBEAT.md",
      "INSTALL_GUIDE.md",
      "README.md",
      "RELEASE_NOTES_v3.4.md",
      "RELEASE_v3.4.0.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/soul-memory"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/soul-memory",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "🧠 Intelligent Memory Management System",
        "body": "Long-term memory framework for AI agents with full OpenClaw integration. v3.4.0 - OpenClaw 2026.3.7 可插拔上下文引擎集成：語義緩存層 + 動態上下文窗口 + 多引擎協同，性能提升 10x，Token 節省 40%。"
      },
      {
        "title": "✨ Features",
        "body": "8 Powerful Modules + OpenClaw Plugin Integration\n\nModuleFunctionDescriptionAPriority 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"
      },
      {
        "title": "🎯 Heartbeat 自動清理（最新！）",
        "body": "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)"
      },
      {
        "title": "🎯 Core Improvements",
        "body": "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"
      },
      {
        "title": "🔄 Plugin v0.2.1-beta Fixes",
        "body": "Fix prependContext Accumulation: Extracts query from event.prompt instead of messages history\nEnhanced Legacy Cleanup: Multiple format support (SoulM markers, numbered entries, ## Memory Context)\nNo Memory Loop: Prevents recursive injection in conversation history"
      },
      {
        "title": "Installation",
        "body": "# Clone and install\ngit clone https://github.com/kingofqin2026/Soul-Memory-.git\ncd Soul-Memory-\nbash install.sh\n\n# Clean install (uninstall first if needed)\nbash install.sh --clean"
      },
      {
        "title": "Basic Usage",
        "body": "from soul_memory.core import SoulMemorySystem\n\n# Initialize system\nsystem = SoulMemorySystem()\nsystem.initialize()\n\n# Search memories\nresults = system.search(\"user preferences\", top_k=5)\n\n# Add memory\nmemory_id = system.add_memory(\"[C] User likes dark mode\")\n\n# Pre-response trigger (auto-search before answering)\ncontext = system.pre_response_trigger(\"What are user preferences?\")"
      },
      {
        "title": "CLI Usage",
        "body": "# Pure JSON output\npython3 cli.py search \"QST physics\" --format json\n\n# Get stats\npython3 cli.py stats --format json"
      },
      {
        "title": "OpenClaw Plugin",
        "body": "# Plugin is automatically installed to ~/.openclaw/extensions/soul-memory\n\n# Restart Gateway to enable\nopenclaw gateway restart"
      },
      {
        "title": "How It Works",
        "body": "Automatic Trigger: Executes before each response\n\nExtract user query from event.prompt (current input, not history)\nSearch relevant memories (top_k = 5)\nFormat memory context\nInject into prompt via prependContext"
      },
      {
        "title": "Configuration",
        "body": "Edit ~/.openclaw/openclaw.json:\n\n{\n  \"plugins\": {\n    \"entries\": {\n      \"soul-memory\": {\n        \"enabled\": true,\n        \"config\": {\n          \"topK\": 5,\n          \"minScore\": 0.0\n        }\n      }\n    }\n  }\n}"
      },
      {
        "title": "🧪 Testing",
        "body": "# Run full test suite\npython3 test_all_modules.py\n\n# Expected output:\n# 📊 Results: 8 passed, 0 failed\n# ✅ All tests passed!"
      },
      {
        "title": "Priority System",
        "body": "[C] Critical: Key information, must remember\n[I] Important: Important items, needs attention\n[N] Normal: Daily chat, can decay"
      },
      {
        "title": "Keyword Search",
        "body": "Localized implementation:\n\nKeyword indexing\nSynonym expansion\nSimilarity scoring"
      },
      {
        "title": "Classification System",
        "body": "Default categories (customizable):\n\nUser_Identity（用戶身份）\nTech_Config（技術配置）\nProject（專案）\nScience（科學）\nHistory（歷史）\nGeneral（一般）"
      },
      {
        "title": "Cantonese Support",
        "body": "語氣詞分級（唔好、好啦、得咩）\n語境映射（褒貶情緒識別）\n粵語檢測（簡繁轉換支持）"
      },
      {
        "title": "📦 File Structure",
        "body": "soul-memory/\n├── core.py              # Core system\n├── cli.py               # CLI interface\n├── install.sh           # Auto-install script\n├── uninstall.sh         # Complete uninstall script\n├── test_all_modules.py  # Test suite\n├── SKILL.md             # ClawHub manifest (this file)\n├── README.md            # Documentation\n├── modules/             # 6 functional modules\n│   ├── priority_parser.py\n│   ├── vector_search.py\n│   ├── dynamic_classifier.py\n│   ├── version_control.py\n│   ├── memory_decay.py\n│   └── auto_trigger.py\n├── plugin/              # OpenClaw Plugin\n│   ├── index.ts         # Plugin source\n│   └── openclaw.plugin.json\n├── cache/               # Cache directory (auto-generated)\n└── web/                 # Web UI (optional)"
      },
      {
        "title": "🔒 Uninstallation",
        "body": "Complete removal of all integration configs:\n\n# Basic uninstall (will prompt for confirmation)\nbash uninstall.sh\n\n# Create backup before uninstall (recommended)\nbash uninstall.sh --backup\n\n# Auto-confirm (no manual confirmation)\nbash uninstall.sh --backup --confirm\n\nRemoved Items:\n\nOpenClaw Plugin config (~/.openclaw/openclaw.json)\nHeartbeat auto-trigger (HEARTBEAT.md)\nAuto memory injection (Plugin)\nAuto memory save (Post-Response Auto-Save)"
      },
      {
        "title": "🔒 Privacy & Security",
        "body": "✅ No external API calls\n✅ No cloud dependencies\n✅ Cross-domain isolation, no data sharing\n✅ Open source MIT License\n✅ CJK support (Chinese, Japanese, Korean)"
      },
      {
        "title": "📐 Technical Details",
        "body": "Python Version: 3.7+\nDependencies: None external (pure Python standard library)\nStorage: Local JSON files\nSearch: Keyword matching + semantic expansion\nClassification: Dynamic learning + preset rules\nOpenClaw: Plugin v0.2.1-beta (TypeScript)"
      },
      {
        "title": "📝 Version History",
        "body": "v3.3.4 (2026-03-07): 🆕 查詢過濾優化（跳過問候語/簡單命令，提高搜索閾值 minScore 0.0→3.0，節省 ~25k token/日）\nv3.3.3 (2026-03-06): 每日快取自動重建（跨日索引更新）\nv3.3.2 (2026-02-28): Heartbeat 自我報告過濾\nv3.3.1 (2026-02-27): 🆕 Heartbeat 自動清理 + Cron Job 集成 + 記憶質量優化（7.9→8.5）\nv3.2.2 (2026-02-25): Heartbeat deduplication + OpenClaw Plugin v0.2.1-beta + Uninstall script\nv3.2.1 (2026-02-19): Index strategy improvement - 93% Token reduction\nv3.2.0 (2026-02-19): Heartbeat active extraction + Lenient mode\nv3.1.1 (2026-02-19): Hotfix: Dual-track memory persistence\nv3.1.0 (2026-02-18): Cantonese grammar branch: Particle grading + context mapping\nv3.0.0 (2026-02-18): Web UI v1.0: FastAPI dashboard + real-time stats\nv2.2.0 (2026-02-18): CJK smart segmentation + Post-Response Auto-Save\nv2.1.0 (2026-02-17): Rebrand to Soul Memory, technical neutralization\nv2.0.0 (2026-02-17): Self-hosted version"
      },
      {
        "title": "📄 License",
        "body": "MIT License - see LICENSE for details"
      },
      {
        "title": "🙏 Acknowledgments",
        "body": "Soul Memory System v3.2 is a personal AI assistant memory management tool, designed for personal use. Not affiliated with OpenClaw project."
      },
      {
        "title": "🔗 Related Links",
        "body": "GitHub: https://github.com/kingofqin2026/Soul-Memory-\nDocumentation: https://github.com/kingofqin2026/Soul-Memory-/blob/main/README.md\nWeb: https://qsttheory.com/\n\n© 2026 Soul Memory System"
      }
    ],
    "body": "Soul Memory System v3.4.0\n🧠 Intelligent Memory Management System\n\nLong-term memory framework for AI agents with full OpenClaw integration. v3.4.0 - OpenClaw 2026.3.7 可插拔上下文引擎集成：語義緩存層 + 動態上下文窗口 + 多引擎協同，性能提升 10x，Token 節省 40%。\n\n✨ Features\n\n8 Powerful Modules + OpenClaw Plugin Integration\n\nModule\tFunction\tDescription\nA\tPriority Parser\t[C]/[I]/[N] tag parsing + semantic auto-detection\nB\tVector Search\tKeyword indexing + CJK segmentation + semantic expansion\nC\tDynamic Classifier\tAuto-learn categories from memory\nD\tVersion Control\tGit integration + version rollback\nE\tMemory Decay\tTime-based decay + cleanup suggestions\nF\tAuto-Trigger\tPre-response search + Post-response auto-save\nG\tCantonese Branch\t🆕 語氣詞分級 + 語境映射 + 粵語檢測\nH\tCLI Interface\t🆕 Pure JSON output for external integration\nPlugin\tOpenClaw Hook\t🆕 before_prompt_build Hook for automatic context injection\nWeb\tWeb UI\tFastAPI dashboard with real-time stats\n🆕 v3.3.1 Release Highlights\n🎯 Heartbeat 自動清理（最新！）\nFeature\tDescription\nAuto Cleanup Script\tAutomatically cleans Heartbeat reports every 3 hours\nCron Job Integration\tOpenClaw Cron system scheduled execution\nMulti-format Support\tRecognizes multiple Heartbeat formats\nMemory Optimization\tReduces redundancy, improves quality score (7.9 → 8.5)\nv3.2.2 Release Highlights\n🎯 Core Improvements\nFeature\tDescription\nHeartbeat Deduplication\tMD5 hash tracking, automatically skips duplicate content\nCLI Interface\tPure JSON output for external system integration\nOpenClaw Plugin\tAutomatically injects relevant memories before responses (v0.2.1-beta)\nLenient Mode\tLower recognition thresholds, saves more conversation content\n🔄 Plugin v0.2.1-beta Fixes\nFix prependContext Accumulation: Extracts query from event.prompt instead of messages history\nEnhanced Legacy Cleanup: Multiple format support (SoulM markers, numbered entries, ## Memory Context)\nNo Memory Loop: Prevents recursive injection in conversation history\n🚀 Quick Start\nInstallation\n# Clone and install\ngit clone https://github.com/kingofqin2026/Soul-Memory-.git\ncd Soul-Memory-\nbash install.sh\n\n# Clean install (uninstall first if needed)\nbash install.sh --clean\n\nBasic Usage\nfrom soul_memory.core import SoulMemorySystem\n\n# Initialize system\nsystem = SoulMemorySystem()\nsystem.initialize()\n\n# Search memories\nresults = system.search(\"user preferences\", top_k=5)\n\n# Add memory\nmemory_id = system.add_memory(\"[C] User likes dark mode\")\n\n# Pre-response trigger (auto-search before answering)\ncontext = system.pre_response_trigger(\"What are user preferences?\")\n\nCLI Usage\n# Pure JSON output\npython3 cli.py search \"QST physics\" --format json\n\n# Get stats\npython3 cli.py stats --format json\n\nOpenClaw Plugin\n# Plugin is automatically installed to ~/.openclaw/extensions/soul-memory\n\n# Restart Gateway to enable\nopenclaw gateway restart\n\n🤖 OpenClaw Plugin Integration\nHow It Works\n\nAutomatic Trigger: Executes before each response\n\nExtract user query from event.prompt (current input, not history)\nSearch relevant memories (top_k = 5)\nFormat memory context\nInject into prompt via prependContext\nConfiguration\n\nEdit ~/.openclaw/openclaw.json:\n\n{\n  \"plugins\": {\n    \"entries\": {\n      \"soul-memory\": {\n        \"enabled\": true,\n        \"config\": {\n          \"topK\": 5,\n          \"minScore\": 0.0\n        }\n      }\n    }\n  }\n}\n\n🧪 Testing\n# Run full test suite\npython3 test_all_modules.py\n\n# Expected output:\n# 📊 Results: 8 passed, 0 failed\n# ✅ All tests passed!\n\n📋 Feature Details\nPriority System\n[C] Critical: Key information, must remember\n[I] Important: Important items, needs attention\n[N] Normal: Daily chat, can decay\nKeyword Search\n\nLocalized implementation:\n\nKeyword indexing\nSynonym expansion\nSimilarity scoring\nClassification System\n\nDefault categories (customizable):\n\nUser_Identity（用戶身份）\nTech_Config（技術配置）\nProject（專案）\nScience（科學）\nHistory（歷史）\nGeneral（一般）\nCantonese Support\n語氣詞分級（唔好、好啦、得咩）\n語境映射（褒貶情緒識別）\n粵語檢測（簡繁轉換支持）\n📦 File Structure\nsoul-memory/\n├── core.py              # Core system\n├── cli.py               # CLI interface\n├── install.sh           # Auto-install script\n├── uninstall.sh         # Complete uninstall script\n├── test_all_modules.py  # Test suite\n├── SKILL.md             # ClawHub manifest (this file)\n├── README.md            # Documentation\n├── modules/             # 6 functional modules\n│   ├── priority_parser.py\n│   ├── vector_search.py\n│   ├── dynamic_classifier.py\n│   ├── version_control.py\n│   ├── memory_decay.py\n│   └── auto_trigger.py\n├── plugin/              # OpenClaw Plugin\n│   ├── index.ts         # Plugin source\n│   └── openclaw.plugin.json\n├── cache/               # Cache directory (auto-generated)\n└── web/                 # Web UI (optional)\n\n🔒 Uninstallation\n\nComplete removal of all integration configs:\n\n# Basic uninstall (will prompt for confirmation)\nbash uninstall.sh\n\n# Create backup before uninstall (recommended)\nbash uninstall.sh --backup\n\n# Auto-confirm (no manual confirmation)\nbash uninstall.sh --backup --confirm\n\n\nRemoved Items:\n\nOpenClaw Plugin config (~/.openclaw/openclaw.json)\nHeartbeat auto-trigger (HEARTBEAT.md)\nAuto memory injection (Plugin)\nAuto memory save (Post-Response Auto-Save)\n🔒 Privacy & Security\n✅ No external API calls\n✅ No cloud dependencies\n✅ Cross-domain isolation, no data sharing\n✅ Open source MIT License\n✅ CJK support (Chinese, Japanese, Korean)\n📐 Technical Details\nPython Version: 3.7+\nDependencies: None external (pure Python standard library)\nStorage: Local JSON files\nSearch: Keyword matching + semantic expansion\nClassification: Dynamic learning + preset rules\nOpenClaw: Plugin v0.2.1-beta (TypeScript)\n📝 Version History\nv3.3.4 (2026-03-07): 🆕 查詢過濾優化（跳過問候語/簡單命令，提高搜索閾值 minScore 0.0→3.0，節省 ~25k token/日）\nv3.3.3 (2026-03-06): 每日快取自動重建（跨日索引更新）\nv3.3.2 (2026-02-28): Heartbeat 自我報告過濾\nv3.3.1 (2026-02-27): 🆕 Heartbeat 自動清理 + Cron Job 集成 + 記憶質量優化（7.9→8.5）\nv3.2.2 (2026-02-25): Heartbeat deduplication + OpenClaw Plugin v0.2.1-beta + Uninstall script\nv3.2.1 (2026-02-19): Index strategy improvement - 93% Token reduction\nv3.2.0 (2026-02-19): Heartbeat active extraction + Lenient mode\nv3.1.1 (2026-02-19): Hotfix: Dual-track memory persistence\nv3.1.0 (2026-02-18): Cantonese grammar branch: Particle grading + context mapping\nv3.0.0 (2026-02-18): Web UI v1.0: FastAPI dashboard + real-time stats\nv2.2.0 (2026-02-18): CJK smart segmentation + Post-Response Auto-Save\nv2.1.0 (2026-02-17): Rebrand to Soul Memory, technical neutralization\nv2.0.0 (2026-02-17): Self-hosted version\n📄 License\n\nMIT License - see LICENSE for details\n\n🙏 Acknowledgments\n\nSoul Memory System v3.2 is a personal AI assistant memory management tool, designed for personal use. Not affiliated with OpenClaw project.\n\n🔗 Related Links\nGitHub: https://github.com/kingofqin2026/Soul-Memory-\nDocumentation: https://github.com/kingofqin2026/Soul-Memory-/blob/main/README.md\nWeb: https://qsttheory.com/\n\n© 2026 Soul Memory System"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/kingofqin2026/soul-memory",
    "publisherUrl": "https://clawhub.ai/kingofqin2026/soul-memory",
    "owner": "kingofqin2026",
    "version": "3.5.3",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}