NIMA Core 2.3

神经集成记忆架构— 一个为具备情商的AI智能体设计的完整记忆系统。

网站： https://nima-core.ai GitHub： https://github.com/lilubot/nima-core

🚀 快速开始

# Install
pip install nima-core

# Or with LadybugDB (recommended for production)
pip install nima-core[vector]

# Set embedding provider
export NIMA_EMBEDDER=voyage
export VOYAGE_API_KEY=your-key

# Install hooks
./install.sh --with-ladybug

# Restart OpenClaw
openclaw restart

🔒 隐私与权限

数据访问：

• ✅ 从以下位置读取会话记录~/.openclaw/agents/*/sessions/*.jsonl
• ✅ 写入本地存储至~/.nima/（数据库、情感历史记录、嵌入向量）

网络调用（取决于嵌入器选择）：

• 🌐Voyage API— 仅当NIMA_EMBEDDER=voyage时（发送文本以生成嵌入向量）
• 🌐OpenAI API— 仅当NIMA_EMBEDDER=openai（发送文本以生成嵌入向量）
• 🔒本地嵌入向量— 默认设置 (NIMA_EMBEDDER=local)，无需调用外部 API

选择性控制项：

// openclaw.json
{
  "plugins": {
    "entries": {
      "nima-memory": {
        "enabled": true,
        "skip_subagents": true,      // Exclude subagent sessions (default)
        "skip_heartbeats": true,      // Exclude heartbeat checks (default)
        "noise_filtering": {
          "filter_heartbeat_mechanics": true,
          "filter_system_noise": true
        }
      }
    }
  }
}

隐私默认设置：

• 子代理会话已排除
• 心跳/系统噪音已过滤
• 本地嵌入向量（无外部调用）
• 所有数据本地存储

如需禁用：从openclaw.json文件的plugins.allow列表中移除nima-memory

2.1 版本更新内容

VADER 情感分析器

• 上下文分析大写增强（1.5倍），标点强调！！！），否定处理，程度修饰语
• 30+ 习语识别：理解如"不错"、"有点"、"稍微"等短语
• 潘克塞普七种情感映射：从VADER情感分析直接映射到寻求、愤怒、恐惧、欲望、关怀、恐慌、玩耍
• 守护者原型转换：用户愤怒 → 代理关切/关怀的响应调节
• 取代了之前基于词典的情绪检测

噪声修复（四阶段）

1. 空值验证— 过滤掉空/无效消息
2. 心跳过滤器— 排除系统噪声（心跳正常、轮询消息）
3. 去重— 移除会话内的重复内容
4. 指标收集— 追踪捕获质量和过滤器效果

性能改进

• LadybugDB 循环导入修复: 已解决 LadybugDB 后端的导入问题
• 令牌预算提升: 召回预算从 500 令牌提升至 3000 令牌
• 连接池: 改进了 LadybugDB 后端的连接管理

2.0 版本的新特性

LadybugDB 后端

• 速度提升 3.4 倍文本搜索（9毫秒 vs 31毫秒）
• 原生向量搜索采用 HNSW（18毫秒）
• 体积缩小 44%数据库（50MB vs 91MB）
• 图遍历支持 Cypher 查询

安全性增强

• 查询净化（FTS5，SQL 注入防护）
• 路径遍历防护
• 临时文件清理
• 全面的错误处理

线程安全

• 使用双重检查锁定的单例模式
• API超时设置（Voyage: 30秒, LadybugDB: 10秒）
• 连接池就绪

348个测试用例

• 完整的单元测试覆盖
• 线程安全性已验证
• 边界情况已覆盖

架构

OPENCLAW HOOKS
├── nima-memory      — Three-layer capture with 4-phase noise remediation
├── nima-recall-live — Lazy recall injection (before_agent_start)
└── nima-affect      — VADER-based real-time affect analysis

PYTHON CORE
├── nima_core/cognition/
│   ├── dynamic_affect.py       — Panksepp 7-affect system
│   ├── personality_profiles.py — JSON personality configs
│   ├── vader_affect.py         — VADER sentiment analyzer (NEW v2.1)
│   └── archetypes.py           — Baseline affect profiles
└── scripts/
    ├── nima_ladybug_backend.py — LadybugDB CLI
    └── ladybug_parallel.py     — Parallel migration

DATABASE (SQLite or LadybugDB)
├── memory_nodes   — Messages with embeddings
├── memory_edges   — Graph relationships
└── memory_turns   — Conversation turns

性能

API

from nima_core import DynamicAffectSystem, get_affect_system
from nima_core.cognition.vader_affect import VaderAffectAnalyzer

# Get singleton instance (thread-safe)
affect = get_affect_system(identity_name="lilu")

# Process input and get affect state
state = affect.process_input("I'm so excited about this project!")
print(state.current)  # {"SEEKING": 0.72, "PLAY": 0.65, ...}

# Use VADER analyzer directly
analyzer = VaderAffectAnalyzer()
result = analyzer.analyze("This is AMAZING!!!")
print(result.affects)  # {'PLAY': 0.78, 'SEEKING': 0.71, ...}

# Recall memories (via hooks - automatic)
# Or manually via CLI:
# nima-query who_search "David" --limit 5
# nima-query text_search "project" --limit 5

配置

钩子

nima-memory（捕获）

• 捕获每一轮的用户输入、思考过程和输出
• 四阶段噪声处理（空值验证、心跳过滤器、去重、指标分析）
• 存储至SQLite或LadybugDB
• 计算并存储嵌入向量

nima-recall-live（召回）

• 在智能体启动前注入相关记忆
• 惰性加载——仅加载前N个结果
• 与注入上下文进行去重处理
• 令牌预算：3000（从v2.1版本的500提升）

nima-affect（情感分析）

• 基于VADER的文本实时情感分析
• 上下文分析（大写、标点、否定、程度修饰词）
• 支持30+种习语识别
• 维持潘克塞普七维情感状态
• 守护者原型转换（用户愤怒 → 智能体关怀）

安装选项

SQLite（开发环境）

pip install nima-core
./install.sh

LadybugDB（生产环境）

pip install nima-core[vector]
./install.sh --with-ladybug

文档说明

安全与隐私

数据访问

此插件访问：

• ~/.openclaw/agents/.../*.jsonl— 会话记录（用于记忆捕获）
• ~/.nima/— 本地记忆数据库（SQLite 或 LadybugDB）
• ~/.openclaw/extensions/— 钩子安装

网络调用

嵌入向量被发送到外部API：

• Voyage AI(api.voyageai.com) — 默认的嵌入向量提供商
• OpenAI(api.openai.com) — 可选的嵌入向量提供商
• 本地— 使用sentence-transformers时不进行外部调用

所需环境变量

安装脚本

该install.sh脚本：

1. 检查 Python 3 和 Node.js
2. 创建~/.nima/目录
3. 通过 pip 安装 Python 包
4. 将钩子复制到~/.openclaw/extensions/

无外部下载。所有包均来自 PyPI。

更新日志

v2.1.0 — VADER 情感分析器（2026年2月17日）

• 新增：基于VADER的情感分析器取代基于词典的检测
  • 上下文分析：大写增强（1.5倍）、标点符号（!!!）、否定、程度修饰词
  • 30+ 习语识别
  • 潘克塞普七种情感映射（探索、愤怒、恐惧、欲望、关怀、恐慌、玩耍）
  • 守护者原型转换（用户愤怒 → 代理关切/关怀）
• 新增：四阶段噪音修复（空值验证、心跳过滤器、去重、指标）
• 已修复：LadybugDB循环导入问题
• 已更改：记忆令牌预算从500增加至3000
• 已改进：LadybugDB后端的连接池

v2.0.3 — 安全加固（2026年2月15日）

• 安全：修复了affect_history.py中的路径遍历漏洞（严重）
• 安全：修复了3个文件中的临时文件资源泄漏问题（高危）
• 已修复：修正了不存在的json.JSONEncodeError → TypeError/ValueError
• 改进：异常处理 - 将5个通用捕获替换为特定类型
• 质量：全面提升错误可见性与调试能力

v2.0.1 — 线程安全 + 元数据

• 修复：采用双重检查锁定实现线程安全的单例模式
• 安全性：明确元数据要求（Node.js环境变量）
• 文档：新增API密钥使用的安全披露说明

v2.0.0 — LadybugDB + 安全性

• 新增：集成LadybugDB后端，支持HNSW向量搜索
• 新增：支持Cypher原生图遍历查询
• 新增：nima-query CLI工具支持统一查询
• 安全性：预防SQL/FTS5注入攻击
• 安全性：路径遍历保护
• 安全性：临时文件清理
• 已修复：线程安全的单例初始化
• 已修复：API超时设置（Voyage 30秒，LadybugDB 10秒）
• 测试：348项测试通过
• 性能：文本搜索速度提升3.4倍，数据库体积减少44%

v1.2.1 — 意识架构

• 新增：8个意识系统（Φ、全局工作空间、自我意识）
• 新增：稀疏块VSA内存
• 新增：ConsciousnessCore统一接口

v1.1.9 — 钩子效率修复

• 已修复：nima-recall钩子每次引导时生成新Python进程的问题
• 性能：钩子召回速度提升约50-250倍

v1.2.0 — 情感响应引擎

• 新增：4个Layer-2复合情感引擎
• 新增：异步情感处理
• 新增：Voyage AI嵌入支持