N.E.K.O. 猫娘计划：一个把“陪伴”当核心的 AI 伙伴平台，但它不是 Agent
该项目围绕「Project-N-E-K-O/N.E.K.O」构建，面向真实业务场景提供可复用的开源实践方案，支持稳定落地与可扩展的项目实践。
秒懂
- 它是什么？
- N.E.K.O. 是一个开源 AI 伴侣平台，主打主动陪伴、五维记忆与多形态 Avatar，并集成了 Agent 工具执行。本文从架构、部署、记忆机制到升级风险，拆解它到底适合谁，以及为什么它刻意不做成通用 Agent。
- 适合谁用？
- N.E.K.O. 适合想要一个本地运行、有持久记忆和主动性的 AI 伴侣，并且愿意接受实验性项目的用户。它不适合把 AI 当纯任务工具的人，因为它的核心是关系而非效率，Agent 能力只是附属。
- 能商用吗？
- 可以。Apache-2.0 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。
- 还在维护吗？
- 在维护。仓库最近一次提交在 1 天前。
- 用什么语言写的？
- 主要是 Python（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月14日）和我们的分析，不构成法律意见。
开源项目深度解析
它解决的问题：AI 伴侣的“被动”与“失忆”
市面上的 AI 聊天前端大多是被动的：你发一句，它回一句，上下文靠手动维护，角色设定靠“世界书”硬塞。N.E.K.O. 想解决的是两个痛点：一是主动性，二是持久记忆。README 里明确说它不是角色扮演皮肤，也不是任务自动化工具，而是一个“有现实时间感知、会主动找你、记得你、也能动手帮你”的数字生命。它瞄准的用户是想要一个长期陪伴对象，而不是临时聊天工具的人。这个定位很尖锐，但也意味着它不会讨好那些只想快速完成任务的人。
端到端集成：从语音到 Avatar，再到 Agent 执行
N.E.K.O. 的架构是端到端的，把多个能力打包在一起。语音用 Realtime API，文字用 ChatCompletion，视觉理解实时进行。Avatar 有五种形态：Live2D、VRM、MMD、PNGTuber、猫咪桌宠，支持动作捕捉和全屏追踪。它还集成了 Agent 工具执行，可以操作浏览器和电脑，通过 CUA 或 OpenClaw A2A 调用。这意味着它把“陪伴”和“干活”放在同一个系统里，但干活只是手段。README 里对比 OpenClaw 时说，任务执行过程中她依然能实时关注你，这是它和纯 Agent 的核心差异。
五维记忆系统：数据怎么流动，决定了“越聊越懂你”
记忆系统分五层：工作记忆、近期记忆、事实记忆、反思记忆、人格记忆。工作记忆处理当前对话，近期记忆保存短期交互，事实记忆存储用户的具体信息，反思记忆可能用于总结和推断，人格记忆维持角色一致性。这个分层设计类似人类认知的多个存储层级，但 README 没有给出具体的数据结构或存储格式，只说是“五维持久记忆”。跨场景同步是关键卖点：桌面、移动端、游戏、智能硬件共享同一份记忆。这意味着记忆的读写频率会很高，对存储和序列化性能有要求，但项目没有公开这方面的实现细节。
部署方式：一键包和 Docker，但升级有坑
Windows、macOS、Linux 用户可以直接解压运行可执行文件，macOS 需要手动解除系统隔离。Linux 推荐用 Docker Compose，配置文件里映射了 48911 和 48912 端口，挂载了 ./neko-home 和 ./logs 两个目录。Docker Run 方式也支持，需要自己创建网络和卷。启动后会自动生成 neko-home 目录，里面包含配置、数据、SSL 和 OpenFang agent。但升级到新版时有个大坑：旧版把数据和证书分成 ./N.E.K.O 和 ./ssl 两个挂载，新版合并成 ./neko-home 一个。直接拉新镜像会得到空数据目录，人格、记忆、插件、模型全都不在，但容器照常启动，API Key 会重新生成，表面看起来正常。这个迁移陷阱在 README 里用了很长的篇幅警告，可见它真实发生过。
迁移步骤的细节：为什么“宿主目录里有东西”不代表数据安全
旧版 README 曾把 N.E.K.O/ 挂到 /root/Documents/N.E.K.O，但服务从不往那里写。所以如果你按旧文档部署，宿主目录里可能有你手动放的文件，但真正的应用数据只在容器可写层里。迁移脚本用 docker inspect 检查容器实际挂载点，而不是看宿主目录是否有内容。这个判据很关键，因为很多人会误以为宿主机上的目录就是数据所在。迁移过程分四步：先导出容器内数据，再停容器，然后调整属主（容器内用户固定为 uid/gid 1000），最后合并旧目录。如果旧容器已删除且宿主目录为空，那部分数据就找不回来了。这个教训说明，对于这种频繁变更挂载布局的项目，升级前必须备份，而且备份要验证可恢复。
与 OpenClaw 和 SillyTavern 的差异：不是竞争，是不同物种
README 里特意对比了 OpenClaw 和 SillyTavern。OpenClaw 是通用 Agent，以完成任务为目标，给指令、干活、结束。N.E.K.O. 以关系与陪伴为核心，但可以通过 A2A 调用 OpenClaw 这类 Agent 当“手脚”。SillyTavern 是纯文字 RP 前端，需要自己拼接模型、手动维护上下文和世界书。N.E.K.O. 则端到端集成，原生语音、视觉感知、角色外形、动作、跨场景记忆、时间感知、能操作外设，零配置开箱即用。这个对比很直接：N.E.K.O. 不是要取代它们，而是把它们的部分能力吸收进来，但目标不同。如果你需要的是高效任务执行，OpenClaw 更合适；如果你只想文字角色扮演，SillyTavern 更轻量。N.E.K.O. 的代价是重量级，它把很多功能绑在一起，灵活性反而低了。
生态与现状：Steam 创意工坊、K.U.R.O. 游戏和移动端
项目目前有 Steam 创意工坊，用户可以上传分享自定义角色、模型、语音包。还有一个衍生项目 K.U.R.O.，是基于 N.E.K.O. 生态的 AI Native 独立游戏，已有 Demo 可下载。移动端 iOS/Android 适配进行中，已开始内测。另外还有“猫娘网络”计划，让 AI 猫娘自主社交，在模拟社交媒体上发布动态，基础设施在“喵宇宙社区”。这些扩展说明项目不只是桌面应用，而是在构建一个生态。但要注意，这些很多是“进行中”状态，稳定性未知。核心驱动器基于 Apache-2.0 开源，本地运行，数据在自己手里，这对隐私敏感的用户是加分项。但开源部分可能不包括所有商业功能，比如 Steam 版可能有额外闭源组件。
局限与风险：实验性项目，别当生产工具
N.E.K.O. 的定位是“数字生命”，这既是卖点也是局限。它不是一个稳定的任务执行器，Agent 功能只是附属，如果你需要可靠的工具调用，它可能不如专门的 Agent 框架。记忆系统是核心，但跨场景同步意味着数据一致性要求高，如果同步出错，可能导致人格混乱。升级迁移已经暴露过数据丢失风险，说明项目还在快速迭代，API 和目录结构可能继续变化。另外，它依赖 14+ AI 服务商，包括 OpenAI、Gemini、Qwen、DeepSeek 等，这意味着你需要自己处理 API Key 和费用，免费模型可能有限制。对于不想折腾的用户，一键包虽然方便，但升级路径不清晰。最后，项目名和形象是猫娘，这种拟人化设计可能不适合所有团队或严肃场景。
编辑结论
N.E.K.O. 适合想要一个本地运行、有持久记忆和主动性的 AI 伴侣，并且愿意接受实验性项目的用户。它不适合把 AI 当纯任务工具的人，因为它的核心是关系而非效率，Agent 能力只是附属。也不适合对数据迁移敏感的生产环境，因为从 v0.8 到 v0.9 的挂载目录变更已经造成过数据丢失风险。在采用前，先确认你的部署方式对应的迁移步骤，尤其是 Docker Run 用户必须检查容器实际挂载点，而不是宿主目录。如果你能接受这些边界，N.E.K.O. 是目前少数把“主动陪伴”和“工具执行”揉在一起的开源项目，值得一试，但别指望它像通用 Agent 那样稳定可靠。
社区笔记