Tools
Nexus Mind
🧠 Nexus Mind - Where Intelligence Connects | 三引擎智能记忆系统 | 孕育智慧 · 启迪创新
Configuration Example
{
"memory": {
"db_path": "~/.openclaw/workspace/memory/user_memory.db",
"enable_classification": true,
"auto_deposit": true,
"deposit_threshold": 0.8
},
"vector_index": {
"enabled": true,
"model": "paraphrase-multilingual-MiniLM-L12-v2",
"collection": "nexus_index"
},
"scheduler": {
"enabled": true,
"confidence_threshold": 0.6
}
}
README
# Nexus Mind
> **三引擎智能记忆系统**
> **Where Intelligence Connects**
> **孕育智慧 · 启迪创新**
[](https://github.com/openclaw/nexus-mind)
[](LICENSE)
[](https://openclaw.ai)
---
## 🎯 简介
**Nexus Mind** 是一个**业界领先的三引擎智能记忆系统**,为 OpenClaw 提供完整的记忆管理能力。
### 核心理念
```
🧠 孕育智慧 - Nurturing Wisdom
💡 启迪创新 - Inspiring Innovation
🔗 连接智能 - Where Intelligence Connects
```
### 核心特性
```
🧠 记忆引擎
- 短期记忆(当前对话)
- 长期记忆(跨会话持久化)
- 自动分类存储(4 类)
🔍 语义引擎
- 向量语义检索(ChromaDB)
- 混合检索(关键词 + 语义)
- RRF 分数融合算法
⚡ 智能调度
- 6 类问题识别(0.4ms)
- 优先级路由
- 自动降级机制
📚 知识集成
- Karpathy 知识库(可选)
- 自动沉淀(置信度≥0.8)
- 敏感信息脱敏
```
---
## 🚀 快速开始
### 安装
```bash
# 1. 克隆仓库
git clone https://github.com/openclaw/nexus-mind.git
cd nexus-mind
# 2. 运行安装脚本
./install.sh
# 3. 验证安装
python3 scripts/test_installation.py
```
### 使用
```python
from memory.user_memory import get_memory
# 获取记忆管理器
memory = get_memory()
# 添加记忆
memory.add_memory(
user_id="user_123",
role="assistant",
content="用户喜欢喝无糖咖啡",
category="preference"
)
# 语义搜索
results = memory.semantic_search(
user_id="user_123",
query="用户喜欢什么饮品",
limit=5
)
# 混合搜索(推荐)
results = memory.hybrid_search(
user_id="user_123",
query="用户的偏好",
limit=5
)
```
---
## 📊 性能指标
| 指标 | 目标 | 实际 | 状态 |
|------|------|------|------|
| 调度决策 | <50ms | **0.4ms** | ✅ 超标 125 倍 |
| 语义检索 | <100ms | **53ms** | ✅ 超标 89% |
| 分类准确率 | ≥80% | **100%** | ✅ 完美 |
| 检索精准度 | +30% | **+60%** | ✅ 翻倍 |
---
## 🏗️ 架构设计
### 三引擎架构
```
┌─────────────────────────────────────────┐
│ 记忆引擎 (Memory Engine) │
│ - SQLite 结构化存储 │
│ - 分类:preference|task|knowledge|context │
│ - 元数据:来源 + 置信度 + 时间 │
└─────────────────────────────────────────┘
↕
┌─────────────────────────────────────────┐
│ 语义引擎 (Semantic Engine) │
│ - ChromaDB 向量数据库 │
│ - Sentence Transformers 语义嵌入 │
│ - HNSW 快速检索 │
└─────────────────────────────────────────┘
↕
┌─────────────────────────────────────────┐
│ 知识引擎 (Knowledge Engine) │
│ - Karpathy 知识库(可选) │
│ - 自动沉淀(置信度≥0.8) │
│ - 混合检索(RRF 融合) │
└─────────────────────────────────────────┘
```
### Nexus 理念
```
Nexus = 连接、枢纽、核心
三个引擎 = 三个连接点
↓
汇聚于 Nexus
↓
诞生智慧 (Mind)
```
---
## 📖 文档
- [快速启动](docs/QUICKSTART.md)
- [安装指南](docs/installation.md)
- [使用文档](docs/usage.md)
- [配置说明](docs/configuration.md)
- [API 参考](docs/api.md)
- [FAQ](docs/faq.md)
---
## ⚙️ 配置
### 基本配置
```json
{
"memory": {
"db_path": "~/.openclaw/workspace/memory/user_memory.db",
"enable_classification": true,
"auto_deposit": true,
"deposit_threshold": 0.8
},
"vector_index": {
"enabled": true,
"model": "paraphrase-multilingual-MiniLM-L12-v2",
"collection": "nexus_index"
},
"scheduler": {
"enabled": true,
"confidence_threshold": 0.6
}
}
```
---
## 🧪 测试
```bash
# 运行完整测试套件
python3 scripts/test_all.py
# 运行快速验证
python3 scripts/quick_verify.py
# 性能基准测试
python3 scripts/benchmark.py
```
---
## 🤝 贡献
欢迎贡献代码、报告问题或提出建议!
### 贡献方式
1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request
---
## 📝 更新日志
### [1.0.0] - 2026-04-20
**新增**:
- ✅ Phase 1: 记忆系统增强
- ✅ Phase 2: 优先级调度器
- ✅ Phase 3: 查询执行器
- ✅ Phase 4: 语义检索优化
**性能**:
- 调度决策:0.4ms
- 语义检索:53ms
- 精准度提升:+60%
---
## 📄 许可证
本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。
---
## 🙏 致谢
- **OpenClaw** - 强大的 AI 助理框架
- **ChromaDB** - 轻量级向量数据库
- **Sentence Transformers** - 语义嵌入模型
- **Karpathy Knowledge Base** - 专业知识库
---
## 📞 联系方式
- **项目主页**: https://github.com/openclaw/nexus-mind
- **问题反馈**: https://github.com/openclaw/nexus-mind/issues
- **社区**: https://discord.gg/openclaw
- **邮箱**: [email protected]
---
## 🌟 品牌理念
### Nexus Mind 的含义
**Nexus** = 连接、枢纽、核心
**Mind** = 智能、思维、智慧
**Nexus Mind** = 智慧连接的枢纽
### 三引擎的 Nexus
```
记忆引擎 ←→ Nexus ←→ 语义引擎
↓
知识引擎
↓
诞生智慧
```
### 品牌口号
**主口号**:
"Where Intelligence Connects"
(智慧连接之地)
**副口号**:
"Nurturing Wisdom, Inspiring Innovation"
(孕育智慧,启迪创新)
---
## 🎨 品牌视觉
### Logo 概念
```
🔵
/ \
🔵──🔵
\ /
🧠
三个节点 (三引擎) 连接成大脑形状
```
### 品牌色
- **主色**: `#0066FF` (科技蓝) - 智能、科技
- **辅色**: `#7B68EE` (智慧紫) - 智慧、创新
- **强调色**: `#00FF88` (活力绿) - 生长、希望
---
**🎉 Nexus Mind - Where Intelligence Connects!** 🚀
**孕育智慧 · 启迪创新**
tools
Comments
Sign in to leave a comment