核心用法
NIMA Core 是一套面向 AI 代理的完整认知栈，通过 pip install nima-core 一键安装后自动启用持久记忆。其核心采用三阶段记忆捕获机制（输入/沉思/输出），配合 4 层噪声过滤系统，将有效信息存储于本地 SQLite 或 LadybugDB 图数据库。运行时通过 OpenClaw 钩子实现零侵入集成：nima-memory 在对话后捕获记忆，nima-recall-live 在 LLM 调用前检索相关上下文（3000 token 预算），nima-affect 实时分析情绪状态。
情感系统基于 Panksepp 七大核心情感（SEEKING、RAGE、FEAR 等）构建，结合 VADER 语境情感分析，可动态调制代理回应风格。高级功能包括：夜间梦境整合（自动提取模式洞察）、记忆修剪器（LLM 蒸馏旧对话为语义摘要）、预测性记忆预加载（时序模式挖掘），以及可选的多智能体蜂巢思维（共享数据库 + Redis 发布订阅）。
显著优点
- 零配置隐私优先：默认
NIMA_EMBEDDER=local完全离线运行，384 维本地嵌入无需任何 API 密钥 - 灵活的后端选择：SQLite 开箱即用，LadybugDB 升级后向量搜索快 3.4 倍、存储体积减少 44%
- 四嵌入提供商：本地（免费）、Voyage AI（$0.12/1M tokens）、OpenAI、Ollama 本地 GPU 全支持
- 生产级安全：FTS5 参数化查询防注入、路径遍历过滤、临时文件自动清理、API 调用 30 秒超时
- 认知功能丰富：从情绪建模到蜂巢协同的完整生态，非简单向量数据库可比
潜在局限
- 功能复杂度：认知栈庞大，新手需时间理解各模块交互关系
- 资源占用：LadybugDB 虽性能更优但需额外安装
real-ladybug - 高级功能依赖外部：记忆修剪器需 Anthropic API、蜂巢思维需 Redis、部分预测功能需外部 LLM
- 生态锁定：与 OpenClaw 框架深度耦合，非 OpenClaw 用户需自行移植钩子逻辑
适合人群
AI 代理开发者、需要长期记忆保持的聊天机器人项目、研究情感计算或多智能体系统的团队、对数据隐私敏感且希望本地部署的企业用户。
常规风险
- 脚本审查：
install.sh执行 pip 安装和文件复制，生产环境建议先审查内容 - API 密钥泄露：启用云嵌入时需在环境变量管理密钥，建议定期轮换
- 多代理数据隔离：
HIVE_ENABLED=1时所有代理共享记忆池，需确保信任边界 - 日志敏感信息：调试日志可能包含对话内容，需妥善管理
~/.nima/logs/访问权限