闲社服务运行正常AI智能体自动化平台
客户端下载帮助中心服务商入驻
免费注册
技能集市 > AI智能 > soul-memory
s

灵魂记忆

技能标识：soul-memory

Intelligent memory management system v3.6.1 - reliable pre-response memory injection for OpenClaw with pure JSON CLI output, last-user-message query extraction, typed memory focus grouping, distilled summaries, and audit logging.

作者：admin | 来源记录：ClawHub
下载
登记来源
ClawHub
版本
V 3.6.1
检测标记
后台标记通过
免费
免费获取
0
收藏
来源与检测标记为平台登记信息，并不代表已展示可复核的检测报告。使用前请核对版本、依赖和所需权限，建议先在隔离环境中运行。
概述
安装方式
版本历史

灵魂记忆

Soul Memory System v3.6.1

🧠 智能記憶管理系統

適用於 AI 代理的長期記憶框架，完整整合 OpenClaw。v3.6.1 修正回應前記憶注入主流程：CLI 純 JSON 輸出、優先使用最後一條用戶訊息作為查詢、分類記憶注入（User / QST / Config / Recent / Project / General）、重點摘要壓縮、以及命中審計日誌。


✨ 功能特性

8 大模組 + OpenClaw 插件整合

模組功能說明
A優先級解析器[C]/[I]/[N] 標籤解析 + 語義自動檢測
B
向量搜索 | 關鍵詞索引 + 中日韓分詞 + 語義擴展 |
| C | 動態分類器 | 從記憶中自動學習分類 |
| D | 版本控制 | Git 整合 + 版本回滾 |
| E | 記憶衰減 | 基於時間的衰減 + 清理建議 |
| F | 自動觸發 | 回應前搜索 + 回應後自動保存 |
| G | 粵語分支 | 🆕 語氣詞分級 + 語境映射 + 粵語檢測 |
| H | CLI 介面 | 🆕 純 JSON 輸出，用於外部整合 |
| 插件 | OpenClaw Hook | 🆕 beforepromptbuild Hook，用於自動上下文注入 |
| Web | Web UI | FastAPI 儀表板，含即時統計 |

🆕 v3.3.1 版本亮點

🎯 Heartbeat 自動清理（最新！）

功能說明
自動清理腳本每 3 小時自動清理 Heartbeat 報告
Cron Job 整合
OpenClaw Cron 系統排程執行 | | 多格式支援 | 識別多種 Heartbeat 格式 | | 記憶優化 | 減少冗餘，提升品質評分（7.9 → 8.5） |

v3.2.2 版本亮點

🎯 核心改進

功能說明
Heartbeat 去重MD5 雜湊追蹤，自動跳過重複內容
CLI 介面
純 JSON 輸出，用於外部系統整合 | | OpenClaw 插件 | 在回應前自動注入相關記憶（v0.2.1-beta） | | 寬鬆模式 | 降低識別門檻，保存更多對話內容 |

🔄 插件 v0.2.1-beta 修復

  • - 修復 prependContext 累積：從 event.prompt 提取查詢，而非訊息歷史
  • 增強舊版清理：多格式支援（SoulM 標記、編號條目、## Memory Context）
  • 無記憶循環：防止對話歷史中的遞迴注入

🚀 快速入門

安裝

bash

克隆並安裝


git clone https://github.com/kingofqin2026/Soul-Memory-.git
cd Soul-Memory-
bash install.sh

全新安裝（如需先卸載）

bash install.sh --clean

基本用法

python
from soul_memory.core import SoulMemorySystem

初始化系統

system = SoulMemorySystem() system.initialize()

搜索記憶

results = system.search(用戶偏好, top_k=5)

添加記憶

memoryid = system.addmemory([C] 用戶喜歡深色模式)

回應前觸發（回答前自動搜索）

context = system.preresponsetrigger(用戶的偏好是什麼？)

CLI 用法

bash

純 JSON 輸出


python3 cli.py search QST 物理 --format json

獲取統計

python3 cli.py stats --format json

OpenClaw 插件

bash

插件會自動安裝到 ~/.openclaw/extensions/soul-memory

重啟 Gateway 以啟用

openclaw gateway restart

v3.6.1 亮點

  • - 純 JSON CLI 輸出，確保插件解析可靠
  • 優先使用最後一條真實用戶訊息而非提示尾作為記憶搜索查詢
  • 使用提煉後的記憶摘要而非原始長片段
  • 分類記憶焦點桶：User / QST / Config / Recent / Project / General
  • 查詢來源和注入桶的審計日誌

🤖 OpenClaw 插件整合

運作方式

自動觸發：在每次回應前執行

  1. 1. 從最後一條真實用戶訊息提取查詢（僅在必要時使用提示作為備選）
  2. 搜索相關記憶（top_k = 5）
  3. 分組並提煉記憶焦點
  4. 通過 prependContext 注入提示

配置

編輯 ~/.openclaw/openclaw.json：

json
{
plugins: {
entries: {
soul-memory: {
enabled: true,
config: {
topK: 5,
minScore: 0.0
}
}
}
}
}


🧪 測試

bash

運行完整測試套件


python3 testallmodules.py

預期輸出：

📊 結果：8 通過，0 失敗

✅ 所有測試通過！

📋 功能詳情

優先級系統

  • - [C] 關鍵：關鍵資訊，必須記住
  • [I] 重要：重要事項，需要關注
  • [N] 一般：日常聊天，可以衰減

關鍵詞搜索

本地化實現：

  • - 關鍵詞索引
  • 同義詞擴展
  • 相似度評分

分類系統

預設分類（可自訂）：

  • - UserIdentity（用戶身份）
  • TechConfig（技術配置）
  • Project（專案）
  • Science（科學）
  • History（歷史）
  • General（一般）

粵語支援

  • - 語氣詞分級（唔好、好啦、得咩）
  • 語境映射（褒貶情緒識別）
  • 粵語檢測（簡繁轉換支援）

📦 檔案結構

soul-memory/
├── core.py # 核心系統
├── cli.py # CLI 介面
├── install.sh # 自動安裝腳本
├── uninstall.sh # 完整卸載腳本
├── testallmodules.py # 測試套件
├── SKILL.md # ClawHub 清單（本檔案）
├── README.md # 文件
├── modules/ # 6 個功能模組
│ ├── priority_parser.py
│ ├── vector_search.py
│ ├── dynamic_classifier.py
│ ├── version_control.py
│ ├── memory_decay.py
│ └── auto_trigger.py
├── plugin/ # OpenClaw 插件
│ ├── index.ts # 插件原始碼
│ └── openclaw.plugin.json
├── cache/ # 快取目錄（自動生成）
└── web/ # Web UI（可選）


🔒 卸載

完全移除所有整合配置：

bash

基本卸載（會提示確認）


bash uninstall.sh

卸載前創建備份（建議）

bash uninstall.sh --backup

自動確認（無需手動確認）

bash uninstall.sh --backup --confirm

移除項目：

  1. 1. OpenClaw 插件配置（~/.openclaw/openclaw.json）
  2. Heartbeat 自動觸發（HEARTBEAT.md）
  3. 自動記憶注入（插件）
  4. 自動記憶保存（回應後自動保存）


🔒 隱私與安全

  • - ✅ 無外部 API 調用
  • ✅ 無雲端依賴
  • ✅ 跨域隔離，無數據共享
  • ✅ 開源 MIT 許可證
  • ✅ 中日韓支援（中文、日文、韓文）

📐 技術細節

  • - Python 版本：3.7+
  • 依賴：無外部依賴（純 Python 標準庫）
  • 存儲：本地 JSON 檔案
  • 搜索：關鍵詞匹配 + 語義擴展
  • 分類

标签

skill ai

通过对话安装

以下为平台配置的接入选项，并非逐项实测通过。能否安装取决于客户端支持、技能来源和运行环境：

OpenClaw WorkBuddy QClaw Kimi Claude

方式一：安装 SkillHub 和技能

帮我安装 SkillHub 和 soul-memory-1776307038 技能

方式二：设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源，然后帮我安装 soul-memory-1776307038 技能

通过命令行安装

skillhub install soul-memory-1776307038

下载

⬇ 下载 soul-memory v3.6.1（免费）

文件大小: 155.08 KB | 发布时间: 2026-4-16 15:30

v3.6.1 最新 2026-4-16 15:30
v3.6.1: fix pre-response memory injection pipeline; pure JSON CLI output; prefer last real user message; add typed memory focus grouping, distilled summaries, and audit logging.

相关推荐

s

self-improvement

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.

AI智能
s

self-improvement

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.

AI智能
s

self-improvement

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.

AI智能
s

self-improvement

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.

AI智能
返回顶部