MemPalace — AI Long-Term Memory Archive
Based on / 基于: milla-jovovich/mempalace
总览 / Overview
MemPalace 是一个本地长期记忆系统，为 AI 设计。对话永久存档，支持语义搜索。
MemPalace is a local long-term memory system for AI agents. Conversations are permanently archived and searchable by meaning (semantic search), not just keywords.
核心优势 / Key Advantages
| 优势 / Advantage | 说明 / Description |
|---|---|
| 本地存储 / Local Only | 所有数据存在你自己电脑，不上传任何服务器 / All data stays on your machine, nothing uploaded |
| 语义搜索 / Semantic Search | 按意思搜索，不只是关键词匹配 / Searches by meaning, not just keyword match |
| 零费用 / 100% Free | 无需 API Key，无需付费 / No API key, no subscription |
| 跨项目 / Cross-Project | 对话存档跨项目共享，不是单一 workspace / Archives shared across projects, not tied to one workspace |
| 自动归档 / Auto-Archive | 每天 23:00 自动保存，无需手动 / Daily auto-save at 23:00, no manual work |
| 源码内置 / Bundled Source | MemPalace 完整源码打包在 skill 内，首次运行自动安装 / Full MemPalace source bundled, auto-installed on first run |
费用对比 / Cost Comparison
| 方案 / Solution | 费用 / Cost | 数据位置 / Data Location |
|---|---|---|
| MemPalace | 免费 / Free | 本地 / Local |
| 普通 memory/ | 免费 / Free | workspace 内 / In workspace |
| 第三方云记忆服务 / Cloud memory services | 付费订阅 / Paid | 云端 / Cloud |
三个命令 / Three Commands
| 命令 / Command | 中文作用 | English Action |
|---|---|---|
/mem-arc | 手动归档当前对话到 MemPalace | Archive current session to MemPalace |
/mem-sea | 语义搜索历史记忆 | Semantic search past memories |
/mem-asave | 立即执行今日自动保存 | Auto-save today's memories now |
工作原理 / How It Works
MemPalace 将对话存储在分级结构中（Wing 主题 > Room 房间 > Drawer 抽屉），通过 ChromaDB 向量数据库实现语义搜索。
MemPalace stores conversations in a hierarchical structure (Wing topic > Room > Drawer) with a ChromaDB vector database for semantic search.
- Skill 安装后，第一次运行
/mem-arc时自动触发初始化 - 自动安装 MemPalace 源码 + chromadb/pyyaml 依赖
- 自动创建
palace_data/目录和mempalace.yaml配置文件 - 对话归档时：压缩内容 -> 写入 convos 文件夹 -> 索引到 ChromaDB
- 搜索时：通过向量匹配找到最相关的记忆片段
自动配置 / Auto-Setup
第一次运行时自动执行以下步骤，无需手动操作：
pip install -e ./mempalace --no-deps— 从内置源码安装 mempalacepip install chromadb pyyaml— 安装运行时依赖（chromadb 从 PyPI 下载）- 创建
palace_data/目录 — 存放对话归档和向量索引 - 创建
mempalace.yaml— Wing 和 Room 配置文件 - 运行初次索引 —
mempalace mine ./palace_data --wing openclaw
安装后只需要用命令，无需任何手动配置。
数据存储位置 / Storage Locations
所有路径相对于 skill 目录，不暴露用户路径。
All paths are relative to the skill directory — no user paths exposed.
mempalace/ Skill 目录 ├── mempalace/ 内置 MemPalace 源码 │ ├── cli.py, miner.py 等所有源码文件 │ └── pyproject.toml pip install -e 所需 ├── scripts/ │ └── archive.ps1 归档和搜索脚本 ├── palace_data/ 首次运行后自动创建 │ ├── convos/ 归档的对话文件 │ └── .mempalace/ ChromaDB 向量索引 ├── mempalace.yaml Wing/Room 配置 └── SKILL.md
适用 AI / Compatible AI
| AI 产品 / AI Product | 支持情况 / Support | 说明 / Notes |
|---|---|---|
| OpenClaw | 完全支持 / Full | Skill 系统 + exec + cron 完整支持 |
| XClaw | 待确认 / Unconfirmed | 取决于 exec 工具是否可用 |
| WorkBuddy | 待确认 / Unconfirmed | 取决于 exec 工具是否可用 |
| Claude Code | 可用 / Usable | 通过 exec 调用 Python/powershell |
| 其他 Agent | 可用 / Usable | 任何能运行 Python + 脚本的环境 |
Skill 触发机制（description 匹配）是 OpenClaw 特有的。XClaw/WorkBuddy 如果支持 Skill 加载则可用，否则需要手动执行 scripts/archive.ps1。
归档流程 / Archive Flow
- 读取当前 workspace 的
memory/文件夹内容（或直接传入内容） - 压缩：删除问候等废话，保留决策/配置/待办
- 写入：
palace_data/convos/YYYY-MM-DD-archive.md - 索引：
mempalace mine ./palace_data --wing openclaw
搜索流程 / Search Flow
- 运行：
mempalace search "搜索词" --wing openclaw - ChromaDB 返回向量相似度排序结果
- AI 解析结果，返回最相关的记忆片段
主动坦白 / Honest Disclosure
Security Scan 提出了几个合理问题，这里主动说明：
1. 数据写入位置 / Data Write Location
archive.ps1 在调用 mempalace CLI 前设置环境变量 MEMPALACE_PALACE_PATH=palace_data 目录的绝对路径。所有 MemPalace 数据（对话归档、ChromaDB 向量索引）都写入 skill 目录下的 palace_data/ 文件夹，不写入用户 home 目录。
2. Wikipedia 查询 / Wikipedia Lookups entity_registry 模块在实体消歧时会发起 Wikipedia API 请求（ benign outbound HTTP，用于消歧，不上传用户数据）。如需完全离线，可注释掉相关代码。
3. pip install 修改 Python 环境 / pip install Modifies Python Env
首次运行会执行 pip install -e ./mempalace 和 pip install chromadb pyyaml，会写入系统 Python 环境。如需隔离，建议用 venv：pip install -e ./mempalace --no-deps + pip install chromadb pyyaml 可在 venv 中运行。
4. cron 自动归档 / Cron Auto-Archive
每天 23:00 的自动归档通过 OpenClaw 内置 cron 实现（cron add），属于 OpenClaw 运行时调度，不体现在 skill 代码文件中。如需确认 cron 是否生效，问 AI：cron list。
5. 目录扫描范围 / Directory Scan Scope
mempalace mine 会递归扫描指定目录并索引其中的 .py/.json/.md/.yaml 等文件。归档时请确保 memory/ 目录内无敏感文件，或在归档前由 AI 过滤。
Skill: mempalace-openclaw | Based on milla-jovovich/mempalace | https://github.com/milla-jovovich/mempalace