Claude-Mem：为AI代理提供跨会话持久上下文的记忆系统

🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇵🇹 Português • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français • 🇮🇱 עברית •

🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇵🇭 Tag

alog • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • �

�🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk为 Claude Code 构建的持久内存压缩系统。

快速入门 • 工作原理 • 搜索工具 • 文档 • 配置 • 故障排除 • 许可证Claude-Mem 通过自动捕获工具使用观察结果、生成语义摘要并使其可供未来会话使用，从而无缝地保存会话之间的上下文。

这使得 Claude 即使在会话结束或重新连接后也能保持项目知识的连续性。

使用单个命令安装：npx claude-mem install或者为 Gemini CLI 安装（自动检测 ~/.gemini）：npx claude-mem install --ide gemini-cli或者为 OpenCode 安装：

npx claude-mem install --ide opencode或者从 Claude Code 内部的插件市场安装：

/plugin marketplace add thedotmack/claude-mem/plugin install claude-mem重新启动 Claude Code 或 Gemini CLI。

之前会话的上下文将自动出现在新会话中。注意：Claude-Mem 也发布在 npm 上，但npm install -g claude-mem只安装 SDK/库——它不注册插件钩子或设置工作服务。

始终通过 npx claude-mem install 或上述 /plugin 命令安装。

使用一个命令在 OpenClaw 网关上将 claude-mem 安装为持久内存插件：curl -fsSL https://install.cmem.ai/openclaw.sh | bash该安装程序处理依赖项、插件设置、AI 提供商配置、

工作进程启动以及 Telegram、Discord、Slack 等的可选实时观察源。有关详细信息，请参阅 OpenClaw 集成指南。

主要特点：- 🧠 持久记忆 - 上下文在会话间保留- 📊 渐进式披露 - 具有代币成本可见性的分层内存检索- 🔍 基于技能的搜索 - 使用 mem-search 技能查询您的项目历史- 🖥️ Web 查看器 UI - 实时内存流，地址为 http:

//localhost:

37777- 💻 Claude Desktop 技能 - 从 Claude Desktop 对话中搜索内存- 🔒 隐私控制 - 使用 <private> 标签从存储中排除敏感内容- ⚙️ 上下文配置 - 对注入的上下文进行细粒度控制- 🤖 自动操作 - 无需手动干预

- 🔗 引用 - 使用 ID 引用过去的观察结果（通过 http://localhost:37777/api/observation/{id} 访问，或在 http://localhost:

37777 的 Web 查看器中查看所有内容）- 🧪 Beta 频道 - 通过版本切换尝试 Endless Mode 等实验性功能📚 查看完整文档 - 在官方网站上浏览- 安装指南 - 快速入门和高级安装- Gemini CLI 设置 - Google Gemini

CLI 集成的专用指南- 使用指南 - Claude-Mem 如何自动工作- 搜索工具 - 使用自然语言查询您的项目历史- 测试版功能 - 尝试 Endless Mode 等实验性功能- 上下文工程 - AI 代理上下文优化原则- 渐进式披露 - Claude-Mem 上

下文启动策略背后的理念- 概述 - 系统组件和数据流- 架构演变 - 从 v3 到 v5 的历程- 钩子架构 - Claude-Mem 如何使用生命周期钩子- 钩子参考 - 7 个钩子脚本说明- 工作服务 - HTTP API 和 Bun 管理- 数据库 - SQLite

模式和 FTS5 搜索- 搜索架构 - 与 Chroma 向量数据库的混合搜索- 配置 - 环境变量和设置- 开发 - 构建、

测试、贡献- 故障排除 - 常见问题和解决方案核心组件：- 5 个生命周期钩子 - SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd（6 个钩子脚本）- 智能安装 - 缓存依赖检查器（预钩子脚本，

不是生命周期钩子）- 工作服务 - 端口 37777 上的 HTTP API，

具有 Web 查看器 UI 和 10 个搜索端点，由 Bun 管理- SQLite 数据库 - 存储会话、观察结果、摘要- mem-search 技能 - 具有渐进式披露的自然语言查询- Chroma 向量数据库 - 混合语义 + 关键字搜索，

用于智能上下文检索有关详细信息，请参阅架构概述。

Claude-Mem 通过 4 个 MCP 工具提供智能内存搜索，遵循代币高效的 3 层工作流模式：3 层工作流：

search - 获取带有 ID 的紧凑索引（约 50-100 个代币/结果）timeline - 获取有趣结果的时间顺序上下文get_observations - 仅获取已过滤 ID 的完整详细信息（约 500-1,

000 个代币/结果）工作原理：

- Claude 使用 MCP 工具搜索您的内存- 从 search 开始获取结果索引- 使用 timeline 查看特定观察结果周围发生的情况- 使用 get_observations 获取相关 ID 的完整详细信息- 通过在获取详细信息之前进行过滤，

可节省约 10 倍的代币可用的 MCP 工具：search - 使用全文查询搜索内存索引，

按类型/日期/项目过滤timeline - 获取特定观察或查询的时间顺序上下文get_observations - 按 ID 获取完整的观察详细信息（始终批量处理多个 ID）示例用法：

// 第 1 步：搜索索引search(query="authentication bug",type="bugfix",limit=10)// 第 2 步：审查索引，识别相关 ID（例如 #123、#456）// 第 3 步：

获取全部细节get_observations(ids=[123,456])有关详细示例，请参阅搜索工具指南。Claude-Mem 提供了一个具有实验性功能（如 Endless Mode，一种用于扩展会话的仿生存储架构）的测试版频道。

从 http://localhost:37777 的 Web 查看器 UI 在稳定版本和测试版之间切换。

有关 Endless Mode 以及如何尝试的详细信息，请参阅测试版功能文档。

- Node.js:18.0.0 或更高- Claude Code:支持插件的最新版本- Bun:JavaScript 运行时和进程管理器（如果缺少则自动安装）- uv:用于向量搜索的 Python 包管理器（如果缺少则自动安装）- SQLite 3:

用于持久存储（已捆绑）如果您看到类似以下错误：npm :The term 'npm' is not recognized as the name of a cmdlet请确保 Node.js 和 npm 已安装并添加到您的 PATH。

从 https://nodejs.org 下载最新的 Node.js 安装程序，并在安装后重新启动终端。设置在 ~/.claude-mem/settings.json 中管理（首次运行时自动创建默认值）。

配置 AI 模型、工作端口、数据目录、日志级别和上下文注入设置。有关所有可用设置和示例，请参阅配置指南。Claude-Mem 通过 CLAUDE_MEM_MODE 设置支持多种工作流模式和语言。

此选项控制两者：- 工作流行为（例如 code、chill、investigation）- 生成的观察中使用的语言编辑位于 ~/.claude-mem/settings.json 的设置文件：{"CLAUDE_MEM_MODE":

"code--zh"}模式在 plugin/modes/ 中定义。

要在本地查看所有可用模式：ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/语言特定模式遵循模式 code--[lang]，其中 [lang] 是 ISO 639-1 语言代码（例如 zh 表示中文，

ja 表示日语，es 表示西班牙语）。

注意：code--zh（简体中文）已内置——无需额外安装或插件更新。请参阅《开发指南》了解构建说明、测试和贡献工作流。如果遇到问题，请向 Claude 描述问题，故障排除技能将自动诊断并提供修复。

有关常见问题和解决方案，请参阅故障排除指南。使用自动生成器创建全面的错误报告：cd ~/.claude/plugins/marketplaces/thedotmacknpm run bug-report欢迎贡献！

请：- Fork 该仓库- 创建功能分支- 通过测试进行更改- 更新文档- 提交 Pull Request有关贡献工作流，请参见开发指南。Claude-Mem 根据 Apache 许可证授权。