Lilu

Nima Core

AI 智能体v3.1.5
作者:Lilu更新于 2026-05-11共 49 个版本 · 最新版本发布于 2026-03-21nima-core@clawhub_dmdorta1111/nima-core
上下文管理记忆增强

据 AlphaMoat 统计,截至 2026-10,Nima Core 累计下载 7,228 次、获 5 个星标,按累计下载量在本次参与排名的 10,914 个 AI 技能中排名第 3,884 位,在「AI 智能体」分类(1,632 个)中排名第 524 位。

列表默认按累计下载量排序,也可按星标排序;详情页排名按累计下载量计算。

累计下载
7,228
星标
5
全站下载量排名
#3,884
全站前 36% · 「AI 智能体」前 33%
平台累计下载星标评论
ClawHub ↗3,86742
SkillHub ↗7,2285—

各平台的计数口径不同,统计时间不一致。

这个技能是做什么的

可读会话记录、把记忆与影响历史写到本地目录,并用向量做语义召回;嵌入可选本地模型或外部服务。安装用 pip install nima-core,需要 python3 与 node。 会话记录可能包含敏感信息;检查留存内容,需留在设备内的数据应选用本地嵌入。

资料发布于 2026-10-27

可以用来做什么

  • 给长期运行的 Agent 加一层可检索的记忆
  • 按情绪线索回看历史对话

什么时候用

  • Agent 需要跨会话记住上下文时
  • 要在本地保存记忆而不走外部服务时

示例提示词

以下是根据技能文档生成的示例,不代表实际运行结果。

把这周的会话记忆整理一下,按主题做召回
找出之前情绪波动较大的几段对话

月度数据趋势

累计下载7,228
3,2495,3867,5232026-03 · 累计下载 3,5442026-05 · 累计下载 4,1062026-06 · 累计下载 4,2902026-07 · 累计下载 4,5442026-08 · 累计下载 4,6612026-09 · 累计下载 5,2372026-10 · 累计下载 7,22826-0326-0926-10
星标5
4552026-03 · 星标 42026-05 · 星标 52026-06 · 星标 52026-07 · 星标 52026-08 · 星标 52026-09 · 星标 52026-10 · 星标 526-0326-0926-10

2026-09 起统计方法调整:同名技能按作者分别统计,并覆盖全部技能。图中虚线为调整前的月份,与之后的数据不直接比较,也不计算跨越调整的增长。

月份累计下载环比星标
2026-107,228—5
2026-095,237—5
2026-084,661+2.6%5
2026-074,544+5.9%5
2026-064,290+4.5%5
2026-054,106—5
2026-033,544—4

SKILL.md 原文

以下是作者发布的原始文件,按纯文本显示,本站未做修改或审核;其中的链接不可点击,命令请核实后再运行。抓取于 2026-10-23。

11 KB · ClawHub v3.1.5
---
name: nima-core
description: Neural Integrated Memory Architecture — Persistent memory, emotional intelligence, and semantic recall for AI agents. Memory pruner, VADER affect, 5 embedding providers, zero-config install. Learn more at nima-core.ai
version: 3.1.5
metadata: {"clawdbot":{"emoji":"🧠","requires":{"bins":["python3","node"],"env":["NIMA_DATA_DIR"]},"optional_env":{"NIMA_EMBEDDER":"voyage|openai|local (default: local)","VOYAGE_API_KEY":"Required when NIMA_EMBEDDER=voyage","OPENAI_API_KEY":"Required when NIMA_EMBEDDER=openai"},"permissions":{"reads":["~/.openclaw/agents/*/sessions/*.jsonl"],"writes":["~/.nima/"],"network":["voyage.ai (conditional)","openai.com (conditional)"]}}}
---

# NIMA Core 2.3

**Neural Integrated Memory Architecture** — A complete memory system for AI agents with emotional intelligence.
展开全部(共 315 行)

**Website:** https://nima-core.ai
**GitHub:** https://github.com/lilubot/nima-core

## 🚀 Quick Start

```bash
# 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
```

## 🔒 Privacy & Permissions

**Data Access:**
- ✅ Reads session transcripts from `~/.openclaw/agents/*/sessions/*.jsonl`
- ✅ Writes to local storage at `~/.nima/` (databases, affect history, embeddings)

**Network Calls (conditional on embedder choice):**
- 🌐 **Voyage API** — Only when `NIMA_EMBEDDER=voyage` (sends text for embeddings)
- 🌐 **OpenAI API** — Only when `NIMA_EMBEDDER=openai` (sends text for embeddings)
- 🔒 **Local embeddings** — Default (`NIMA_EMBEDDER=local`), no external API calls

**Opt-in Controls:**
```json
// 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
        }
      }
    }
  }
}
```

**Privacy Defaults:**
- Subagent sessions excluded
- Heartbeat/system noise filtered  
- Local embeddings (no external calls)
- All data stored locally

**To disable:** Remove `nima-memory` from `plugins.allow` in `openclaw.json`

## What's New in 2.1

### VADER Affect Analyzer
- **Contextual Analysis**: Caps boost (1.5x), punctuation emphasis (`!!!`), negation handling, degree modifiers
- **30+ Idiom Recognition**: Understands phrases like "not bad", "kind of", "sort of"
- **Panksepp 7-Affect Mapping**: Direct mapping from VADER sentiment to SEEKING, RAGE, FEAR, LUST, CARE, PANIC, PLAY
- **Guardian Archetype Transformation**: User anger → Agent concern/care response modulation
- Replaces previous lexicon-based emotion detection

### Noise Remediation (4-Phase)
1. **Empty Validation** — Filters out null/empty messages
2. **Heartbeat Filters** — Excludes system noise (`HEARTBEAT_OK`, polling messages)
3. **Deduplication** — Removes duplicate content within sessions
4. **Metrics Collection** — Tracks capture quality and filter effectiveness

### Performance Improvements
- **LadybugDB Circular Import Fix**: Resolved import issues in LadybugDB backend
- **Increased Token Budget**: Recall budget increased from 500 to 3000 tokens
- **Connection Pooling**: Improved connection management for LadybugDB backend

## What's New in 2.0

### LadybugDB Backend
- **3.4x faster** text search (9ms vs 31ms)
- **Native vector search** with HNSW (18ms)
- **44% smaller** database (50MB vs 91MB)
- **Graph traversal** with Cypher queries

### Security Hardened
- Query sanitization (FTS5, SQL injection prevention)
- Path traversal protection
- Temp file cleanup
- Error handling throughout

### Thread Safe
- Singleton pattern with double-checked locking
- API timeouts (30s Voyage, 10s LadybugDB)
- Connection pooling ready

### 348 Tests
- Full unit test coverage
- Thread safety verified
- Edge cases covered

## Architecture

```text
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
```

## Performance

| Metric | SQLite | LadybugDB |
|--------|--------|-----------|
| Text Search | 31ms | **9ms** (3.4x) |
| Vector Search | External | **18ms** (native) |
| Context Tokens | ~180 | **~30** (6x smaller) |
| Recall Token Budget | 500 | **3000** (v2.1+) |

## API

```python
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
```

## Configuration

| Variable | Default | Description |
|----------|---------|-------------|
| `NIMA_DATA_DIR` | `~/.nima` | Memory storage path |
| `NIMA_EMBEDDER` | `voyage` | `voyage`, `openai`, or `local` |
| `VOYAGE_API_KEY` | — | Required for Voyage |
| `NIMA_LADYBUG` | `0` | Set `1` for LadybugDB backend |

## Hooks

### nima-memory (Capture)
- Captures input, contemplation, output on every turn
- 4-phase noise remediation (empty validation, heartbeat filters, dedup, metrics)
- Stores to SQLite or LadybugDB
- Computes and stores embeddings

### nima-recall-live (Recall)
- Injects relevant memories before agent starts
- Lazy loading — only top N results
- Deduplicates with injected context
- Token budget: 3000 (increased from 500 in v2.1)

### nima-affect (Emotion)
- VADER-based real-time affect analysis from text
- Contextual analysis (caps, punctuation, negation, degree modifiers)
- 30+ idiom recognition
- Maintains Panksepp 7-affect state
- Guardian archetype transformation (user anger → agent care)

## Installation Options

### SQLite (Development)
```bash
pip install nima-core
./install.sh
```

### LadybugDB (Production)
```bash
pip install nima-core[vector]
./install.sh --with-ladybug
```

## Documentation

| Guide | Description |
|-------|-------------|
| [README.md](./README.md) | Full system overview |
| [SETUP_GUIDE.md](./SETUP_GUIDE.md) | Step-by-step installation |
| [docs/DATABASE_OPTIONS.md](./docs/DATABASE_OPTIONS.md) | SQLite vs LadybugDB |
| [docs/EMBEDDING_PROVIDERS.md](./docs/EMBEDDING_PROVIDERS.md) | Voyage, OpenAI, Local |
| [MIGRATION_GUIDE.md](./MIGRATION_GUIDE.md) | Migrate from old versions |
| [CHANGELOG.md](./CHANGELOG.md) | Release history |

## Security & Privacy

### Data Access
This plugin accesses:
- `~/.openclaw/agents/.../*.jsonl` — Session transcripts (for memory capture)
- `~/.nima/` — Local memory database (SQLite or LadybugDB)
- `~/.openclaw/extensions/` — Hook installation

### Network Calls
Embeddings are sent to external APIs:
- **Voyage AI** (`api.voyageai.com`) — Default embedding provider
- **OpenAI** (`api.openai.com`) — Optional embedding provider
- **Local** — No external calls when using sentence-transformers

### Required Environment Variables

| Variable | Purpose | Required |
|----------|---------|----------|
| `NIMA_EMBEDDER` | `voyage`, `openai`, or `local` | No (default: voyage) |
| `VOYAGE_API_KEY` | Voyage AI authentication | If using Voyage |
| `OPENAI_API_KEY` | OpenAI authentication | If using OpenAI |
| `NIMA_DATA_DIR` | Memory storage path | No (default: ~/.nima) |
| `NIMA_LADYBUG` | Use LadybugDB backend | No (default: 0) |

### Installation Script
The `install.sh` script:
1. Checks for Python 3 and Node.js
2. Creates `~/.nima/` directories
3. Installs Python packages via pip
4. Copies hooks to `~/.openclaw/extensions/`

**No external downloads.** All packages come from PyPI.

---

## Changelog

### v2.1.0 — VADER Affect Analyzer (Feb 17, 2026)
- **Added:** VADER-based affect analyzer replacing lexicon-based detection
  - Contextual analysis: caps boost (1.5x), punctuation (!!!), negation, degree modifiers
  - 30+ idiom recognition
  - Panksepp 7-affect mapping (SEEKING, RAGE, FEAR, LUST, CARE, PANIC, PLAY)
  - Guardian archetype transformation (user anger → agent concern/care)
- **Added:** 4-phase noise remediation (empty validation, heartbeat filters, dedup, metrics)
- **Fixed:** LadybugDB circular import issue
- **Changed:** Recall token budget increased from 500 to 3000
- **Improved:** Connection pooling for LadybugDB backend

### v2.0.3 — Security Hardening (Feb 15, 2026)
- **Security:** Fixed path traversal vulnerability in affect_history.py (CRITICAL)
- **Security:** Fixed temp file resource leaks in 3 files (HIGH)
- **Fixed:** Corrected non-existent json.JSONEncodeError → TypeError/ValueError
- **Improved:** Exception handling - replaced 5 generic catches with specific types
- **Quality:** Better error visibility and debugging throughout

### v2.0.1 — Thread Safety + Metadata
- **Fixed:** Thread-safe singleton with double-checked locking
- **Security:** Clarified metadata requirements (Node.js, env vars)
- **Docs:** Added security disclosure for API key usage

### v2.0.0 — LadybugDB + Security
- **Added:** LadybugDB backend with HNSW vector search
- **Added:** Native graph traversal with Cypher
- **Added:** nima-query CLI for unified queries
- **Security:** SQL/FTS5 injection prevention
- **Security:** Path traversal protection
- **Security:** Temp file cleanup
- **Fixed:** Thread-safe singleton initialization
- **Fixed:** API timeouts (Voyage 30s, LadybugDB 10s)
- **Tests:** 348 tests passing
- **Performance:** 3.4x faster text search, 44% smaller DB

### v1.2.1 — Consciousness Architecture
- Added: 8 consciousness systems (Φ, Global Workspace, self-awareness)
- Added: Sparse Block VSA memory
- Added: ConsciousnessCore unified interface

### v1.1.9 — Hook Efficiency Fix
- Fixed: nima-recall hook spawning new Python process every bootstrap
- Performance: ~50-250x faster hook recall

### v1.2.0 — Affective Response Engines
- Added: 4 Layer-2 composite affect engines
- Added: Async affective processing
- Added: Voyage AI embedding support

「AI 智能体」分类下的热门技能

数据月份:2026-10 · 下载/星标数聚合自公开技能注册库(ClawHub、SkillHub),按月更新。口径说明见数据方法。