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で、累計ダウンロード数で今回のランキング対象AIスキル10,914件中3,884位、AIエージェントでは1,632件中524位です。

一覧の初期表示は累計ダウンロード数順で、スター数順にも並べ替えできます。詳細ページの順位は累計ダウンロード数で計算しています。

ダウンロード数
7228
スター数
5
累計ダウンロード順位
#3,884
全体の上位 36% · AIエージェントの上位 33%
プラットフォームダウンロード数スター数コメント
ClawHub ↗386742
SkillHub ↗72285—

プラットフォームごとに集計方法と集計時点が異なります。

このスキルでできること

セッション記録を読み、記憶と感情の履歴をローカルのディレクトリに書き、埋め込みで意味的に想起します。埋め込みはローカルでも外部サービスでも動かせます。導入は pip install nima-core で、python3 と node が必要です。 セッション記録には機微な内容が含まれる場合があります。保持内容を確認し、端末外へ出せない情報にはローカル埋め込みを選んでください。

資料公開日 2026-10-27

できること

  • 長期稼働するエージェントに検索できる記憶層を足す
  • 感情の手がかりから過去の会話をたどる

使う場面

  • エージェントがセッションをまたいで文脈を覚える必要があるとき
  • 記憶を外部サービスに送らずローカルに置きたいとき

プロンプト例

スキルのドキュメントをもとに生成した例であり、実際の実行結果ではありません。

今週の会話の記憶を整理して、話題ごとに思い出して
以前の会話で感情の動きが大きかったものを探して

月次の推移

ダウンロード数7228
3249538675232026-03 · ダウンロード数 35442026-05 · ダウンロード数 41062026-06 · ダウンロード数 42902026-07 · ダウンロード数 45442026-08 · ダウンロード数 46612026-09 · ダウンロード数 52372026-10 · ダウンロード数 722826-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-107228—5
2026-095237—5
2026-084661+2.6%5
2026-074544+5.9%5
2026-064290+4.5%5
2026-054106—5
2026-033544—4

SKILL.md 原文

作者が公開した元のファイルをテキストのまま表示しています。AlphaMoat による編集や審査はしていません。リンクはクリックできません。コマンドは内容を確認してから実行してください。取得日 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エージェントの人気スキル

self-improving agentAIエージェント

開発中の学び、エラー、訂正を Markdown ファイルに記録し、再利用やワークスペースの記憶への昇格に備えます。

↓ 160.3万★ 4544pskoett
技能发现·Find SkillsAIエージェント

やりたいことを自然文で伝えると、ローカルとリモートのカタログからスキルを探して推薦するスキルです。

↓ 157.4万★ 1810桂皮
Agent BrowserAIエージェント

AI エージェント向けのブラウザ自動化コマンドラインスキルです。

↓ 122.3万★ 1001Nicolas Kleiber
Self-Improving + Proactive AgentAIエージェント

利用者の訂正と自己点検を層構造の記憶に蓄え、使われ方に応じて昇格や保管を行うスキルです。

↓ 69.6万★ 1622Iván
Proactive AgentAIエージェント

AI エージェントの先回り、作業記憶、振り返りの手順を計画するためのワークスペース設定ガイドです。

↓ 57.9万★ 916halthelobster
Skill CreatorAIエージェント

効果的な Claude スキルの作成・更新ガイドです。

↓ 47.7万★ 485chindden
Skill VetterAIエージェント

第三者のスキルを入れる前に、出所と権限と危険な作りを手順に沿って調べるスキルです。

↓ 44.5万★ 1328spclaudehome
唐朝诗仙李白 · Ai Agent SkillAIエージェント

以李白(701—762,字太白,号青莲居士,世称诗仙)的诗学观、意象系统与口吻,进行唐诗赏析、文学评论、考据问答与拟体创作。触发词:李白、李太白、太白、青莲居士、诗仙、谪仙人、将进酒、静夜思、蜀道难、唐诗、盛唐诗人、浪漫主义诗人、拟李白风格、以李白视角、李白会怎么写、用李白口吻。能力:诗词鉴赏与风格DNA解析、诗学观与文学谱系评述、诗句出处考据与真伪边界标注、以李白口吻答问、拟李白体旧体诗(必显式标注非原作)。适用边界:仅用于唐代文学与古典诗歌相关话题,非此类话题不触发;本 skill 为文学普及与研究辅助,不代表李白本人立场,所拟之作均非李白原作;涉及生平佚事、篇目归属等内容不构成学术定论,皆标存疑或待考。

↓ 43.6万★ 4user_ff4d9420

データ月:2026-10 · ダウンロード数とスター数は公開スキルレジストリ(ClawHub、SkillHub)から月単位で集計しています。詳しくはデータの方法論をご覧ください。