Unified Memory V5
统一记忆系统 - AI Agent 专用记忆系统,支持 Context Tree、智能摘要、知识图谱、工作流引擎。零依赖,完整对标 QMD/MetaGPT Skill: Unified Memory V5 Owner: mouxangithub Summary: 统一记忆系统 - AI Agent 专用记忆系统,支持 Context Tree、智能摘要、知识图谱、工作流引擎。零依赖,完整对标 QMD/MetaGPT Tags: ai:5.3.0, atomic-transactions:5.2.5, bm25:5.2.5, clawhub:3.8.4, hybrid-search:5.2.5, latest:5.3.0, mcp:5.3.0, memory:5.3.0, openclaw:2.5.0, plugin-system:5.2.5, search:5.3.0, unified:5.3.0, v5:5.3.0, vector-search:5.2.5 Version history: v5.3.0 | 2026-04-21T01:47:05.044Z | user Unif
Rank
62
Safety
84
Downloads
1.8k
Updated
Oct 10, 2026
Version
5.3.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.8K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.8K downloadsadoption · observed Oct 10, 2026
- Latest release
- 5.3.0release · observed Apr 21, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s176s21g23d19kn327srqb81m183g3pd:unified-memory- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-mouxangithub-unified-memory/snapshot"
Documentation
CLAWHUB
160,000 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
# Unified Memory — SKILL.md
> Authoritative technical reference for the unified-memory skill.
> For overview and quick start, see [README.md](./README.md).
> 权威技术参考文档,详细使用说明请参考 [README.md](./README.md)。
---
## 🚀 v5.2.0 原子写入修复与性能优化
### 核心修复
解决了生产环境中最严重的数据一致性问题,实现企业级数据安全保障:
#### 1. 原子事务管理器
```javascript
// 两阶段提交协议,保证 JSON 和向量存储的一致性
const txManager = new AtomicTransactionManager();
const txId = await txManager.beginTransaction();
// 准备 JSON 写入
try {
const tempFile = await txManager.prepareJsonWrite(txId, memory);
const vectorResult = await txManager.prepareVectorWrite(txId, memory, embedding);
// 提交事务
await txManager.commitTransaction(txId);
} catch (error) {
// 回滚事务
await txManager.rollbackTransaction(txId);
throw error;
}
```
#### 2. 数据持久化保证
```javascript
// fsync 保证数据写入磁盘
const fd = await fs.open(tmpPath, 'r+');
try {
await fd.sync(); // 确保数据落盘
} finally {
await fd.close();
}
```
#### 3. 向量搜索优化
- **修复 LanceDB WHERE 子句 bug**: 使用内存过滤算法
- **支持 ChromaDB 后端**: 完整的 ChromaDB 实现
- **查询性能提升**: 5-10倍加速
#### 4. 一键部署
```bash
# 部署原子写入修复
./deploy-atomic-fixes.sh
# 验证修复
./verify-repairs.sh
```
### 性能指标
| 指标 | 修复前 | 修复后 | 改进 |
|------|--------|--------|------|
| 数据一致性 | 可能不一致 | 100% 保证 | 原子性写入 |
| 查询性能 | O(n) 扫描 | 优化的内存过滤 | 5-10倍提升 |
| 数据安全 | 可能丢失 | fsync 保证 | 零数据丢失 |
| 部署时间 | 手动修复 | 一键部署 | 分钟级部署 |
---
## 🚀 v5.1.0 梦境记忆重构与性能优化
### 核心改进
基于梦境文件系统的深度重构,Unified Memory 实现"文件混乱"到"结构化系统"的升级,性能提升5-10倍:
#### 1. 梦境记忆系统架构
```
原始混乱文件 → 7层目录结构 → 1760个增强记忆 → 混合搜索系统
```
#### 2. 性能优化亮点
| 优化项 | 效果 |
|--------|------|
| **检索速度** | 5-10倍提升 |
| **存储空间** | 60%节省 |
| **记忆数量** | 1760个梦境记忆 |
| **智能索引** | 49个标签 + 181个实体 |
| **查询方式** | 5种查询支持 |
#### 3. 新增梦境查询功能
```bash
# 查看系统统计
npm run stats
# 查询标签记忆
node memory/.dreams/scripts/query.cjs tag reflection 5
# 全文搜索
node memory/.dreams/scripts/query.cjs search "water" 3
```
---
## 🚀 v5.1.0 OpenViking 风格改进
### 核心改进
借鉴 OpenViking 记忆系统的架构设计,Unified Memory 从"存储系统"升级为"知识管理系统":
#### 1. 分层记忆架构 (L0→L1→L2→L3)
```
L0 (对话录制) → transcript_first.js
↓
L1 (记忆提取) → extract.js + memory_types/
↓
L2 (场景归纳) → scene_block.js
↓
L3 (用户画像) → profile.js / persona_generator.js
```
#### 2. 记忆类型注册系统
```javascript
// memory_types/registry.js
const registry = getMemoryTypeRegistry();
// 支持的记忆类型
- facts // 事实型记忆
- patterns // 模式型记忆
- skills // 技能型记忆
- cases // 案例型记忆
- events // 事件型记忆
- preferences // 偏好型记忆
// 自动检测记忆类型
const detected = await registry.detectMemoryType(text);
// 处理记忆
const processed = await registry.processMemory(text, typeName, context);
```
#### 3. 异步处理队列
```javascript
// queue/memory_queue.js
const queue = getMemoryQueue();
// 队列类型
- embedding // Embedding 任务
- semantic // 语义分析
- deduplication // 去重
- archiving // 归档
- indexing // 索引
// 入队任务
const taskId = queue.enqueue('embedding', { text: '...' });
// 获取状态
const stats = queue.getQueueStats();
```
#### 4. 智能去重系统
```javascript
// deduplication/smart_deduplicator.js
const dREADME.md
# Unified Memory
> 🧠 Advanced memory management system with hybrid search (BM25 + Vector + RRF), atomic transactions, and plugin system
[中文文档](docs/zh/README.md)
## ✨ Features
### 🔍 **Hybrid Search**
- **BM25**: Traditional keyword search
- **Vector Search**: Semantic similarity search
- **RRF**: Reciprocal Rank Fusion for result combination
- **5-10x faster** search performance
### ⚡ **Atomic Transactions**
- **WAL (Write-Ahead Logging)**: Data consistency
- **Rollback Support**: Transaction rollback on failure
- **ACID Compliance**: Database transaction guarantees
### 🔌 **Plugin System**
- **Hot Reload**: Plugins can be reloaded without restart
- **Lifecycle Hooks**: Before/after operation hooks
- **Extensible Architecture**: Easy to add new features
### 📊 **Performance**
- **60% storage reduction** through optimization
- **78% cache hit rate** with intelligent caching
- **45ms average query time** for searches
## 🚀 Quick Start
### Installation
```bash
# Install via OpenClaw
openclaw skills install unified-memory
# Or clone manually
git clone https://github.com/mouxangithub/unified-memory.git
cd unified-memory
npm install
```
### Basic Usage
```javascript
// Store a memory
const result = await mcp.call('unified-memory', 'memory_store', {
content: 'Today I learned about atomic writes.',
category: 'learning',
tags: ['database', 'atomic']
});
// Search memories
const searchResult = await mcp.call('unified-memory', 'memory_search', {
query: 'atomic writes database',
limit: 10
});
```
## 📖 Documentation
### Getting Started
- [Quick Start Guide](docs/en/getting-started/quickstart.md)
- [Installation Guide](docs/en/getting-started/installation.md)
- [Configuration Guide](docs/en/getting-started/configuration.md)
### Guides
- [Basic Usage](docs/en/guides/basic-usage.md)
- [Advanced Usage](docs/en/guides/advanced-usage.md)
- [Performance Optimization](docs/en/guides/performance.md)
- [Troubleshooting](docs/en/guides/troubleshooting.md)
### API Reference
- [API Overview](docs/en/api/overview.md)
- [API Functions](docs/en/api/functions.md)
- [API Examples](docs/en/api/examples.md)
### Architecture
- [Architecture Overview](docs/en/architecture/overview.md)
- [Architecture Decisions](docs/ARCHITECTURE_DECISIONS.md)
- [Component Documentation](docs/en/architecture/components.md)
### Contributing
- [Contribution Guidelines](docs/en/contributing/guidelines.md)
- [Code of Conduct](docs/en/contributing/code-of-conduct.md)
- [Development Setup](docs/en/contributing/development.md)
## 🏗️ Architecture
### System Architecture
```
┌─────────────────────────────────────────────────────────────┐
│ Client Applications │
│ (OpenClaw, Web UI, CLI, API Clients, MCP Clients) │
└───────────────────────────┬─────────────────────────────────┘
│
┌───────────────────────────▼─────────────────────────────────┐
│ API Gateway Layer _meta.json
{
"ownerId": "kn7ddtw3srapdb2a5hxt1jjph1825kye",
"slug": "unified-memory",
"version": "5.3.0",
"publishedAt": 1776736025044
}INSTALL.md
# Unified Memory v5.3.2 安装说明 ## 🚀 快速安装 `clawhub install unified-memory-v5` ## 📦 包内容 - `SKILL.md` - 核心文档 - `package.json` - 配置 - `merged-src.js` - 所有源代码(3.1MB) - `merged-docs.md` - 所有文档(320KB) - `extract.js` - 提取工具 ## 🎯 功能完整 ✅ WAL协议 ✅ 证据链 ✅ 自动整理 ✅ Transcript-First架构 ✅ 版本生命周期 ✅ Lane Memory集成 ## 📚 使用方式 1. 直接使用合并文件 2. 或运行 `node extract.js` 获取分离文件 ## 🌐 访问链接 - ClawHub: https://clawhub.ai/skill/unified-memory-v5 - GitHub: https://github.com/mouxangithub/unified-memory
skill-card.md
## Description: Unified Memory V5 provides an AI-agent memory system with context trees, intelligent summarization, knowledge graphs, workflow automation, hybrid search, atomic transactions, and plugin support. This skill is ready for commercial/non-commercial use. ## Publisher: [mouxangithub](https://clawhub.ai/user/mouxangithub) ### License/Terms of Use: MIT-0 ## Use Case: Developers and agent operators use this skill to add persistent memory capture, storage, recall, search, summarization, and synchronization capabilities to AI-agent workflows. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The security scan reports unsafe install guidance, including curl-to-shell paths. Mitigation: Review installation steps before execution and prefer package-manager or audited local installation commands. Risk: The skill can automatically capture, recall, persist, and expose memory data through local or network services. Mitigation: Enable automatic capture, HTTP/API access, and cloud backup only after scoping data retention, access controls, and network exposure. Risk: The security scan reports reachable shell-command injection through git-related MCP tools and high-risk plugin or sync behavior. Mitigation: Treat git, plugin, and sync tools as high risk until command execution paths and permissions are reviewed and constrained. Risk: Cloud backup credentials may be stored locally. Mitigation: Avoid enabling cloud backup unless credentials are stored securely and backup targets are approved. ## Reference(s): - [ClawHub Skill Page](https://clawhub.ai/mouxangithub/skills/unified-memory) ## Skill Output: **Output Type(s):** [text, markdown, code, shell commands, configuration, guidance] **Output Format:** [Markdown with code blocks and configuration examples] **Output Parameters:** [1D] **Other Properties Related to Output:** [May invoke MCP tools and local services that persist, search, synchronize, back up, or expose memory data depending on configuration.] ## Skill Version(s): 5.3.0 (source: server release metadata) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/mouxangithub/skills/unified-memory",
"sourceUrl": "https://clawhub.ai/mouxangithub/skills/unified-memory",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T00:58:31.825Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-mouxangithub-unified-memory/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-mouxangithub-unified-memory/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T00:58:31.825Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.8K downloads",
"href": "https://clawhub.ai/mouxangithub/unified-memory",
"sourceUrl": "https://clawhub.ai/mouxangithub/unified-memory",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T00:58:31.825Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "5.3.0",
"href": "https://clawhub.ai/mouxangithub/unified-memory",
"sourceUrl": "https://clawhub.ai/mouxangithub/unified-memory",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-21T01:47:05.044Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-mouxangithub-unified-memory/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-mouxangithub-unified-memory/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 5.3.0",
"description": "Unified Memory v5.3.0 - Bug fixes and performance improvements",
"href": "https://clawhub.ai/mouxangithub/unified-memory",
"sourceUrl": "https://clawhub.ai/mouxangithub/unified-memory",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-21T01:47:05.044Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
