名称： nima-core
描述： "Noosphere 集成记忆架构 — 为 AI 智能体提供的完整认知栈：持久记忆、情感智能、梦境巩固、群体心智、预知回忆与清醒时刻。支持 4 种嵌入提供商，LadybugDB 图数据库后端，零配置安装。nima-core.ai"
版本： 3.1.4
元数据： {"openclaw":{"emoji":"🧠","source":"https://github.com/lilubot/nima-core","homepage":"https://nima-core.ai","requires":{"bins":["python3","node"],"env":[]},"optional_env":{"NIMA_DATA_DIR":"覆盖默认数据目录 ~/.nima","NIMA_EMBEDDER":"voyage|openai|ollama|local (默认: local — 零外部调用)","VOYAGE_API_KEY":"当 NIMA_EMBEDDER=voyage 时必需","OPENAI_API_KEY":"当 NIMA_EMBEDDER=openai 时必需","NIMA_OLLAMA_MODEL":"当 NIMA_EMBEDDER=ollama 时使用的模型名称","NIMA_VOICE_TRANSCRIBER":"whisper|local (用于语音笔记)","WHISPER_MODEL":"tiny|base|small|medium|large","ANTHROPIC_API_KEY":"用于记忆修剪器的 LLM 蒸馏（仅限选择启用）"},"permissions":{"reads":["~/.nima/"],"writes":["~/.nima/","~/.openclaw/extensions/nima-*/"],"network":["voyage.ai (仅当 NIMA_EMBEDDER=voyage 时)","openai.com (仅当 NIMA_EMBEDDER=openai 时)"]},"external_calls":"所有外部 API 调用均需通过显式环境变量选择启用。默认模式使用本地嵌入，无网络调用。"}}

NIMA Core 3.1

Noosphere 集成记忆架构 — 为 AI 智能体提供的完整认知栈：持久记忆、情感智能、梦境巩固、群体心智与预知回忆。

官网: https://nima-core.ai · GitHub: https://github.com/lilubot/nima-core

快速开始

pip install nima-core && nima-core

你的机器人现在拥有了持久记忆。无需任何配置。

v3.0 新特性

完整认知栈

NIMA 已从一个记忆插件演变为完整的认知架构：

v3.0 亮点

• 所有认知模块统一在一个包中
• 安装器 (install.sh) 实现零摩擦设置
• 所有 OpenClaw 钩子已打包并可直接使用
• README 重写，所有版本对齐至 3.0.4

架构

OPENCLAW 钩子
├── nima-memory/          捕获钩子（3 层，4 阶段噪声过滤）
│   ├── index.js          钩子入口点
│   ├── ladybug_store.py  LadybugDB 存储后端
│   ├── embeddings.py     多提供商嵌入（Voyage/OpenAI/Ollama/本地）
│   ├── backfill.py       历史转录本导入
│   └── health_check.py   数据库完整性检查
├── nima-recall-live/     回忆钩子（before_agent_start）
│   ├── lazy_recall.py    当前回忆引擎
│   └── ladybug_recall.py LadybugDB 原生回忆
├── nima-affect/          情感钩子（message_received）
│   ├── vader-affect.js   VADER 情感分析器
│   └── emotion-lexicon.js 情感关键词词典
└── shared/               弹性包装器，错误处理

PYTHON 核心 (nima_core/)
├── cognition/
│   ├── dynamic_affect.py         Panksepp 7 情感系统
│   ├── emotion_detection.py      文本情感提取
│   ├── affect_correlation.py     跨情感分析
│   ├── affect_history.py         时间情感追踪
│   ├── affect_interactions.py    情感耦合动力学
│   ├── archetypes.py             人格原型（守护者、探索者等）
│   ├── personality_profiles.py   JSON 人格配置
│   └── response_modulator_v2.py  情感 → 响应调制
├── dream_consolidation.py        夜间记忆合成引擎
├── memory_pruner.py              情景记忆蒸馏 + 抑制
├── hive_mind.py                  多智能体记忆共享
├── precognition.py               时间模式挖掘
├── lucid_moments.py              自发记忆浮现
├── connection_pool.py            SQLite 连接池（WAL，线程安全）
├── logging_config.py             单例日志记录器
└── metrics.py                    线程安全计数器/计时器

隐私与权限

• ✅ 所有数据本地存储在 ~/.nima/
• ✅ 默认：本地嵌入 = 零外部调用
• ✅ 无 NIMA 自有服务器，无专有跟踪，无分析数据发送至外部服务
• ⚠️ 可选网络功能：群体心智（Redis 发布/订阅）、预知（LLM 端点）、LadybugDB 迁移 — 见下方可选功能
• 🔒 仅当明确启用时才会进行嵌入 API 调用（VOYAGE_API_KEY、OPENAI_API_KEY 等）

需要网络访问的可选功能

安全

安装内容

凭证处理

建议： 从 NIMA_EMBEDDER=local（默认）开始。仅在需要更好的嵌入质量时启用云端提供商。

安全特性

• 输入过滤 — 系统消息、心跳信号和重复内容在捕获前被过滤
• FTS5 注入防护 — 参数化查询防止 SQL 注入
• 路径遍历防护 — 所有文件路径都经过清理
• 临时文件清理 — 自动清理临时文件
• API 超时 — 网络调用设有合理超时（Voyage 30 秒，本地 10 秒）

最佳实践

1. 安装前审查 — 运行前检查 install.sh 和钩子文件
2. 备份配置 — 添加钩子前备份 ~/.openclaw/openclaw.json
3. 不要以 root 身份运行 — 安装会写入用户主目录
4. 使用容器化环境 — 如果不确定，先在虚拟机或容器中测试
5. 轮换 API 密钥 — 如果使用云端嵌入，定期轮换密钥
6. 监控日志 — 检查 ~/.nima/logs/ 是否有可疑活动

数据位置

~/.nima/
├── memory/
│   ├── graph.sqlite       # SQLite 后端（默认）
│   ├── ladybug.lbug       # LadybugDB 后端（可选）
│   ├── embedding_cache.db # 缓存的嵌入
│   └── embedding_index.npy# 向量索引
├── affect/
│   └── affect_state.json  # 当前情感状态
└── logs/                  # 调试日志（如果启用）

~/.openclaw/extensions/
├── nima-memory/           # 捕获钩子
├── nima-recall-live/     # 回忆钩子
└── nima-affect/          # 情感钩子

控制选项：

{
  "plugins": {
    "entries": {
      "nima-memory": {
        "skip_subagents": true,
        "skip_heartbeats": true,
        "noise_filtering": { "filter_system_noise": true }
      }
    }
  }
}

配置

嵌入提供商

数据库后端

升级：pip install real-ladybug && python -c "from nima_core.storage import migrate; migrate()"

所有环境变量

# 嵌入（默认：本地）
NIMA_EMBEDDER=local|voyage|openai|ollama
VOYAGE_API_KEY=pa-xxx
OPENAI_API_KEY=sk-xxx
NIMA_OLLAMA_MODEL=nomic-embed-text

# 数据路径
NIMA_DATA_DIR=~/.nima
NIMA_DB_PATH=~/.nima/memory/ladybug.lbug

# 记忆修剪器
NIMA_DISTILL_MODEL=claude-haiku-4-5
ANTHROPIC_API_KEY=sk-ant-xxx

# 日志记录
NIMA_LOG_LEVEL=INFO
NIMA_DEBUG_RECALL=1

钩子

安装

./install.sh
openclaw gateway restart

或手动安装：

cp -r openclaw_hooks/nima-memory ~/.openclaw/extensions/
cp -r openclaw_hooks/nima-recall-live ~/.openclaw/extensions/
cp -r openclaw_hooks/nima-affect ~/.openclaw/extensions/

高级功能

梦境巩固

夜间合成从情景记忆中提取见解和模式：

python -m nima_core.dream_consolidation
# 或通过 OpenClaw cron 在凌晨 2 点调度

记忆修剪器

将旧对话蒸馏为语义摘要，抑制原始噪声：

python -m nima_core.memory_pruner --min-age 14 --live
python -m nima_core.memory_pruner --restore 12345  # 30 天内撤销

群体心智

多智能体记忆共享：

from nima_core import HiveMind
hive = HiveMind(db_path="~/.nima/memory/ladybug.lbug")
context = hive.build_agent_context("研究任务", max_memories=8)
hive.capture_agent_result("agent-1", "结果摘要", "模型名称")

预知

时间模式挖掘 → 预测性记忆预加载：

from nima_core import NimaPrecognition
precog = NimaPrecognition(db_path="~/.nima/memory/ladybug.lbug")
precog.run_mining_cycle()

清醒时刻

情感共鸣记忆的自发浮现（附带安全措施：创伤过滤、静默时段、每日上限）：

from nima_core import LucidMoments
lucid = LucidMoments(db_path="~/.nima/memory/ladybug.lbug")
moment = lucid.surface_moment()

情感系统

基于 Panksepp 7 种情感的情感智能，支持人格原型：

from nima_core import DynamicAffectSystem
affect = DynamicAffectSystem(identity_name="my_bot", baseline="guardian")
state = affect.process_input("我对此感到兴奋！")
# 原型：guardian, explorer, trickster, empath, sage

API

from nima_core import (
    DynamicAffectSystem,
    get_affect_system,
    HiveMind,
    NimaPrecognition,
    LucidMoments,
)

# 情感系统（线程安全单例）
affect = get_affect_system(identity_name="lilu")
state = affect.process_input("你好！")

# 群体心智
hive = HiveMind()
context = hive.build_agent_context("任务描述")

# 预知
precog = NimaPrecognition()
precog.run_mining_cycle()

# 清醒时刻
lucid = LucidMoments()
moment = lucid.surface_moment()

更新日志

完整版本历史请参见 CHANGELOG.md。

近期发布

• v3.0.4 (2026年2月23日) — 达尔文式记忆引擎，新 CLI，安装器，错误修复
• v2.5.0 (2026年2月21日) — 群体心智，预知，清醒时刻
• v2.4.0 (2026年2月20日) — 梦境巩固引擎
• v2.3.0 (2026年2月19日) — 记忆修剪器，连接池，Ollama 支持
• v2.2.0 (2026年2月19日) — VADER 情感，4 阶段噪声修复，生态学评分
• v2.0.0 (2026年2月13日) — LadybugDB 后端，安全加固，348 项测试

许可证

MIT — 任何 AI 智能体均可免费使用，商业或个人用途均可。