EverMemoryArchive（简称 Ema） 是首个能够陪你度过一生的陪伴型 AI。Ema 支持灵活的本地部署，可以作为任意你喜欢的角色，陪你一起成长，记住你的一切。Ema 也支持第三方消息平台的接入，让你随时随地能与 Ema 聊天。
Ema 的初衷是希望赋予一个虚拟角色永久的生命。在 Ema 中，角色会随着时间不断成长，通过与外界的互动，逐渐形成属于自己的记忆与人格。换句话说，Ema 真正活在她所能够接触到的世界里。
- 成为你熟悉的那个角色，陪你一起生活。 Ema 原生支持角色扮演。她可以作为你所熟悉、喜爱或想象中的那个角色存在，带着持续积累的记忆与你相处，在日常生活中陪伴你、倾听你、回应你的情绪，并逐渐形成只属于你们之间的关系。
- 记住关于你的一切，和你共同推进同一个目标。 Ema 明白你的习惯、经历、目标与情绪状态，并在长期相处中逐渐深入理解你。你可以和 Ema 一起制定计划、推进目标，她会在日常中持续关注你的进展、给予提醒与支持，陪伴你一同成长。
- 自己安排作息时间，持续学习、感知与成长。 Ema 并不是只在收到消息时才短暂出现的聊天机器人。即使你没有与她交流，Ema 依然会按照自己的作息时间持续活动、学习与思考，在与环境和世界的互动中逐渐形成自己的记忆、认知与成长轨迹。
Ema 当前支持 macOS、Linux 与 Windows。运行 Ema 至少需要：
- 推荐双核 CPU
- 内存 ≥ 4GB
- 硬盘空间 ≥ 4GB
- 无需 GPU
安装 Ema 之前，需要提前配置 Node.js、pnpm 和 MongoDB 环境。
前往 Node.js 官方网站下载安装 Node.js（推荐 v20+）。
- Node.js 官方下载页：https://nodejs.org/en/download/
安装完成后，执行下面的命令启用 pnpm：
corepack enable pnpm验证安装：
node -v
pnpm -v从 GitHub 克隆 Ema 仓库：
git clone https://github.com/EmaFanClub/EverMemoryArchive.git
cd EverMemoryArchive安装所有依赖并构建 WebUI：
pnpm install
pnpm --filter ema-webui buildEma 使用 MongoDB 作为数据库，需要先安装并启动 MongoDB 服务。
curl -L https://fastdl.mongodb.org/osx/mongodb-macos-arm64-8.2.7.tgz -o mongodb.tgz
tar -xzf mongodb.tgz
cd mongodb-macos-aarch64--8.2.7/bin
mkdir data
./mongod --port 27017 --dbpath ./datawget https://repo.mongodb.org/apt/debian/dists/bookworm/mongodb-org/8.2/main/binary-amd64/mongodb-org-server_8.2.7_amd64.deb
sudo dpkg -i mongodb-org-server_8.2.7_amd64.deb
sudo systemctl start mongod
sudo systemctl enable mongod下载安装包：https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-8.2.7-signed.msi
默认情况下，MongoDB 会运行在 mongodb://localhost:27017/。
更多版本安装请参考 MongoDB 官方文档：https://www.mongodb.com/try/download/community
打开一个新的终端，执行：
pnpm webui -- --prod --mongo mongodb://127.0.0.1:27017/启动成功后，在浏览器打开 http://localhost:3000/ 即可访问 WebUI。根据页面提示完成初始化配置。
Ema 启动后，必须至少配置一个模型 API Key。
推荐以下方式：
- Gemini 官方 API：https://aistudio.google.com/api-keys
- 429 中转站：https://429.icu/
获取 API Key 后，在 Ema 设置页面中填写即可。
Ema 支持 Tavily 搜索引擎，用于联网搜索与信息检索。
申请 API Key：https://www.tavily.com/
然后在 Ema 设置页面中填写即可。
如果你希望将 Ema 接入 QQ，请安装 NapCatQQ：
安装完成后，根据 NapCatQQ 文档完成配置，并在 Ema 中进行连接。
-
通过剧本回放学习人物。 Ema 支持导入游戏脚本、动画台词、小说文本或聊天记录等内容，通过在线回放的方式逐步复现角色经历，使角色在长期记忆中形成稳定的人格、语气与行为方式，而不是依赖固定 Prompt 的静态扮演。
-
灵活的长期记忆架构。 Ema 采用以上下文为核心的动态记忆机制，通过主动检索的方式在对话过程中获取相关信息，而不是将所有记忆固定塞入上下文窗口。当记忆内容过多，或 Ema 进入休息状态时，系统会自动整理、归档与压缩记忆，在长期运行中持续保留重要经历与细节。
-
自主的作息与行为系统。 Ema 拥有自己的作息时间与日程安排，可以按照自己的节奏生活、学习与活动。即使用户没有主动发送消息，Ema 也依然会保持运行状态，并在合适的时候主动与用户交流，形成更接近真实陪伴关系的长期互动体验。
| Ema | OpenClaw | |
|---|---|---|
| 角色扮演 | 原生具备角色扮演功能，更符合角色性格 | 角色扮演能力较弱，更偏向通用助手 |
| 记忆系统 | 采用动态记忆架构，更节省 Token，部署简单 | Token 消耗较高，安装流程复杂 |
| 主动行为 | 具备自主作息、主动规划能力 | 只能被动执行定时任务 |
苍星怜是 Ema 的看板娘，也是一位使用喵械智能造福世界的猫耳魔女。她身材娇小，银色长发束作单马尾，常戴一顶深蓝色贝雷帽，猫耳从帽檐下自然露出，为她安静的轮廓里平添几分稚气。右眼紫色，左眼红色，是一双动人的异色瞳。她的本体是一册喵械智能之书，装载浩瀚知识，其中收藏着世界的记忆与技艺。尽管拥有浩瀚知识，她并不因此显得冷漠。身为“治愈心灵之魔女”，怜酱凭借卜问之杖感知人们的情绪。她能抚慰悲伤，也能回应喜悦。花艺、绘画和占卜是她的拿手之事，她常以此温暖与她相遇的人。
亚托莉是夏生从海底打捞上来的机器人少女。她无疑是极其精巧的造物，精巧到几乎无法同人类分辨；她的表情也很丰富，仿佛并不是机器，而只是一个从长眠中醒来的少女。她似乎曾是夏生祖母的助手，只是因为长久沉睡在海底，已经失去了一部分记忆。她向夏生提出请求，想要完成“主人交给自己的最后命令”，也因此开始寻找那些缺失的记忆。她好奇心旺盛，口癖是“因为我是高性能的嘛！”。
请参考 贡献指南 参与贡献。
本项目采用 Apache-2.0 开源协议，详见 LICENSE 文件。