← Back to Skills Marketplace
dmdorta1111

Nima Core

by Lilu · GitHub ↗ · v3.1.5 · MIT-0
cross-platform ⚠ suspicious
2752
Downloads
4
Stars
3
Active Installs
49
Versions
Install in OpenClaw
/install nima-core
Description
Neural Integrated Memory Architecture — Persistent memory, emotional intelligence, and semantic recall for AI agents. Memory pruner, VADER affect, 5 embeddin...
Usage Guidance
This skill largely does what it says (captures OpenClaw session transcripts, stores local memory, optional external embeddings, and affect analysis), but several red flags merit review before installing: - Packaging/metadata mismatches: version numbers and declared install method disagree across files. Treat the bundle as unvetted source — prefer installing from the upstream GitHub repo you trust and confirm tags/commits. - Installer behavior: install.sh will clone, pip-install packages (possibly system-wide), initialize databases, and copy hooks into ~/.openclaw/extensions. It also writes ~/.nima/.env. Run it in a sandbox or in a dedicated VM/container, or inspect and run steps manually (use a venv, avoid --break-system-packages). - Sensitive data flow: by design the hooks read agent session transcripts (~/.openclaw/agents/*/sessions/*.jsonl). If you enable non-local embedders or the memory-pruner LLM distillation, text will be sent to external services (voyage.ai, openai.com, etc.). If you must avoid exfiltration, keep NIMA_EMBEDDER=local and audit code paths that call external APIs. - Undeclared prerequisites: the installer requires git and enforces Python >=3.10; the registry did not include git in required binaries. Ensure your environment meets installer checks or perform a manual install. - Audit before enabling: review install.sh and the OpenClaw hook JS entry points that will run on agent events. Backup ~/.openclaw/openclaw.json and your OpenClaw environment before activating the plugin. If you want to proceed safely: clone the repo yourself, inspect the install script and hook code, perform pip installs inside a virtual environment, set NIMA_EMBEDDER=local, set NIMA_DATA_DIR to an isolated path, and test in a non-production agent sandbox. If you need help verifying specific files (hooks or network calls), provide those files and I can review them in detail.
Capability Analysis
Type: OpenClaw Skill Name: nima-core Version: 3.1.5 The nima-core skill bundle is a highly professional and security-conscious memory and affect system for AI agents. The codebase demonstrates significant security maturity, including explicit mitigations for Cypher injection in nima_core/hive_mind.py (addressing LadybugDB's lack of parameterized queries), path traversal protection in nima_core/storage/hybrid_search.py, and a critical transition from insecure pickle serialization to HMAC-signed JSON in nima_core/cognition/sparse_block_memory.py. The installation and maintenance scripts (install.sh, doctor.sh) follow best practices, such as avoiding arbitrary shell execution when parsing environment variables. All declared permissions and network calls to voyage.ai or openai.com are strictly aligned with the stated purpose of generating embeddings for semantic recall.
Capability Assessment
Purpose & Capability
Name/description (persistent memory, affect, recall) align with the code and hooks present (nima-core Python package + OpenClaw hooks). Requested binaries (python3, node) and the declared read/write paths (~/.openclaw sessions and ~/.nima/) match the stated purpose. However, the package includes many code files but the registry entry lists no install spec — and the bundled installer requires git and Python >=3.10 while README/docs mention other Python versions. These mismatches are unexpected and merit caution.
Instruction Scope
SKILL.md clearly instructs the agent to install hooks, read session transcripts (~/.openclaw/agents/*/sessions/*.jsonl) and write persistent state to ~/.nima/. It documents conditional network calls to embedding providers (voyage/openai/ollama) and provides opt-in controls. The runtime instructions therefore do request sensitive data (agent session transcripts) and conditional external network use — but those actions are documented and coherent with a memory plugin.
Install Mechanism
Registry metadata indicated 'instruction-only' (no install spec) but the bundle includes an install.sh and many files that will be written to disk and deployed to ~/.openclaw/extensions. install.sh clones from GitHub, runs pip installs (including attempting to install real-ladybug), may initialize databases, and writes ~/.nima/.env. The installer also requires git and Python 3.10+, which are not listed in the registry requirements. The mismatch between 'no install spec' and an extractive installer increases risk and surprise for users.
Credentials
The registry lists only NIMA_DATA_DIR as required and the skill documents optional env vars (NIMA_EMBEDDER, VOYAGE_API_KEY, OPENAI_API_KEY, plus other LLM-related vars in code). These envs are proportionate to embedding/LLM features. Be aware that enabling non-local embedders or the memory pruner (LLM distillation) will require API keys and will send text externally; the default local embeddings mode does not. Also some canonical LLM env vars appear in code but were not declared in the registry's required list — review which envs the runtime actually reads.
Persistence & Privilege
always:false and user-invocable:true. The skill installs persistent OpenClaw hooks (writes to ~/.openclaw/extensions) so it will run on agent events as intended for a memory plugin. That level of persistence is expected for this purpose and is documented. No evidence it modifies other skills' configurations beyond adding its own hooks, but the installer writes to ~/.nima/.env and copies hooks into the OpenClaw extensions directory — review and backup OpenClaw config before installing.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install nima-core
  3. After installation, invoke the skill by name or use /nima-core
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.1.5
v3.1.5: LadybugDB schema migrations, unified NIMA_LLM_* env vars, silent cron thresholds, SQLite migration, allowSubagentRecall, logging cleanup, N+1 fixes.
v3.3.0
NIMA v3.3.0: Bayesian confidence scoring, push triggers for proactive memory surfacing, ProtocolNode constitutional governance layer. Full security review completed.
v3.2.1
Fix ClawHub audit: declare install spec (kind:shell), expand permissions, add HIVE env vars, fix heading version 3.1→3.2
v3.2.0
v3.2.0: ACT-R temporal decay + Hebbian learning storage/ module. LadybugDB schema audit + idempotent init script. Full schema migration. Dynamic skill router plugin. Security hardening.
v3.1.4
Complete cognitive stack for AI agents
v3.1.3
PR #82 review fixes, all code review issues resolved
v3.1.2
Fix USE_LADYBUG flag, lazy_recall routing, affect hooks
v3.1.1
Fix ClawHub audit issues
v3.1.0
v3.1.0 - Precognitive Actions + Security Hardening
v3.0.9
Hotfix: recall returns 0 memories Fixes Binder exception on LadybugDB schemas missing last_accessed, is_ghost, dismissal_count fields. These columns were added in init_db.py but not in existing .lbug files, causing all recall queries to fail silently. - Remove last_accessed from SET in update_memory_stats() - Remove last_accessed/is_ghost/dismissal_count from Cypher RETURN - Default missing fields to safe Python values
v3.0.8
Security & polish release
v3.0.7
Add scheduling setup section to README — full cron configs for Lucid Moments, Dream Consolidation, Memory Pruner, Embedding Index, and Precognition
v3.0.6
CRITICAL fix: SyntaxError in lucid_moments.py line 447 — unterminated f-string was preventing NIMA from loading
v3.0.5
Self-contained hooks: inline shared deps, fix jiti module resolution
v3.0.4
Fix nima-memory null safety crash, type guards, tighter metadata regex
v3.0.3
Fix clawhubignore glob patterns, align versions, README/SKILL.md rewrite, remove dead script references
v3.0.2
Fix missing cognition folder and hook files. README rewritten.
v3.0.1
CRITICAL FIX: v3.0.0 was missing nima_core/cognition/ (10 files) and all openclaw_hooks Python/JS files due to .clawhubignore glob bug. Fixed recursive re-inclusion. README rewritten with full v3.0 feature set. All versions aligned to 3.0.1.
v3.0.0
nima-core 3.0.0 - Bump version to 3.0.0 in SKILL.md; no other content or documentation was changed. - Prepares the skill for a new major release with no feature or compatibility updates noted in this commit.
v2.6.0
Major update with significant restructuring and new capabilities. - Introduces dream consolidation, hive mind, lucid moments, and voice note capture features. - Adds scripts for memory cleanup, forgetting engine, backend management, and batch operations. - Removes legacy cognition and plugin hook files, shifting towards a new modular structure. - Updates metadata to support voice transcription options (e.g., Whisper). - Streamlines codebase: 6 files added, 39 removed, simplifying core maintenance.
Metadata
Slug nima-core
Version 3.1.5
License MIT-0
All-time Installs 4
Active Installs 3
Total Versions 49
Frequently Asked Questions

What is Nima Core?

Neural Integrated Memory Architecture — Persistent memory, emotional intelligence, and semantic recall for AI agents. Memory pruner, VADER affect, 5 embeddin... It is an AI Agent Skill for Claude Code / OpenClaw, with 2752 downloads so far.

How do I install Nima Core?

Run "/install nima-core" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Nima Core free?

Yes, Nima Core is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Nima Core support?

Nima Core is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Nima Core?

It is built and maintained by Lilu (@dmdorta1111); the current version is v3.1.5.

💬 Comments