claude-mem 完全解析为 Claude Code 注入持久记忆的智能插件项目介绍当 AI 助手开始“记住”你在使用 Claude Code 等 AI 编程工具时你是否遇到过这样的困扰每次开始新会话都需要重新介绍项目背景、重复解释之前的决策AI 仿佛完全失忆。claude-mem正是为了解决这一痛点而生——它是一个专为 Claude Code 设计的开源插件能够自动捕获会话中的工具使用、决策过程和观察结果通过 AI 压缩生成语义摘要并在未来会话中智能注入相关上下文。简单来说claude-mem 让 Claude Code 拥有了长期记忆。当你结束一个会话它不会忘记你们讨论过的架构、发现的问题或达成的共识当你下次打开 Claude Code它会自动唤醒与当前项目最相关的历史记忆让对话无缝衔接。项目由开发者 Alex Newman 创建采用AGPL-3.0开源协议目前支持 Claude Code 和 OpenClaw 网关。核心功能自动、智能、可配置持久记忆跨会话保留claude-mem 通过 6 个生命周期钩子SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd 等捕获会话中的关键事件将工具调用、输出、用户提示等存储到本地 SQLite 数据库中。每次新会话启动时它会自动检索与当前项目相关的历史观察并作为上下文注入让 AI 无缝延续之前的思考。渐进式披露与 Token 优化传统记忆检索往往将大量上下文一次性塞入提示词造成 token 浪费。claude-mem 采用3 层渐进式披露策略search— 返回紧凑的索引结果约 50-100 tokens/条包含观察 ID、简短摘要。timeline— 获取特定观察周围的时序上下文了解事件发生的背景。get_observations— 仅针对筛选出的 ID 获取完整详情约 500-1,000 tokens/条。这种设计让 AI 可以先“翻阅目录”再决定是否阅读全文节省约 10 倍 token 消耗。智能搜索工具MCPclaude-mem 提供了 4 个 MCP 工具让 AI 能够主动查询历史记忆search— 全文搜索支持按类型、日期、项目过滤。timeline— 获取某个观察前后的时序链。get_observations— 批量获取观察的完整内容。用户也可以通过mem-search技能直接用自然语言查询历史例如“我之前关于用户认证模块有哪些讨论”。实时 Web 查看器安装后claude-mem 会在http://localhost:37777启动一个 Web UI你可以实时查看记忆流浏览所有会话、观察和摘要甚至可以通过 UI 切换稳定版或 Beta 版如实验性的 Endless Mode。隐私控制与精细化配置使用private标签包裹的敏感内容不会被存储。你可以通过settings.json精确控制哪些类型的上下文会被注入如仅注入代码变更忽略闲聊。所有数据存储在本地 SQLite 数据库中无需联网。快速上手5分钟安装在 Claude Code 中安装推荐在 Claude Code 终端中依次执行/plugin marketplace add thedotmack/claude-mem /plugin install claude-mem重启 Claude Code历史上下文将自动出现在新会话中。注意通过 npm 全局安装claude-mem仅会安装 SDK不会注册插件钩子请务必使用/plugin命令。在 OpenClaw 网关中安装curl -fsSL https://install.cmem.ai/openclaw.sh | bash安装程序会处理依赖、AI 提供商配置、Worker 启动并可选择将实时观察推送到 Telegram、Discord、Slack 等渠道。手动配置可选配置文件位于~/.claude-mem/settings.json可自定义 AI 模型、端口、数据目录、日志级别等。首次运行会自动生成默认配置。技术架构本地化、轻量、高效核心组件5 个生命周期钩子1 个预钩子在会话各阶段捕获数据。Worker 服务基于 Bun 运行的 HTTP API提供 Web UI 和 10 个搜索端点。SQLite 数据库存储会话、观察和摘要内置 FTS5 全文搜索。Chroma 向量数据库提供混合语义关键词搜索提升检索精度。mem-search 技能让 AI 通过自然语言查询历史。智能压缩与摘要当捕获的观察积累到一定量时claude-mem 会调用 AI通过 Claude Agent SDK自动生成语义摘要将冗长的对话提炼为精炼的知识点既节省存储空间又提升检索效率。Beta 特性Endless Mode实验性的 Endless Mode 尝试模拟生物记忆机制让 Claude 能够在超长会话中保持一致性适合需要长时间不间断工作的场景。核心优势真正自动化无需任何手动干预从会话开始到结束全程自动记录、压缩、注入。智能而非蛮力渐进式披露 AI 摘要让记忆既完整又高效。开发者友好清晰的配置选项、Web UI 实时查看、MCP 工具灵活调用。隐私优先所有数据本地化敏感内容可标记排除。总结让 AI 真正成为你的“记忆伙伴”claude-mem 不是简单地保存对话日志而是用 AI 理解 AI——它自动识别哪些信息值得保留用智能摘要提炼核心并在你需要时以最合适的方式呈现。对于长期维护复杂项目的开发者这意味着一遍又一遍的重复解释将成为历史每次打开 Claude Code它都像昨天刚刚离开的同事知道你在做什么、做过什么、需要什么。如果你是 Claude Code 的深度用户或者正在构建需要持续上下文的 AI 应用claude-mem 绝对值得一试。现在就通过/plugin命令安装让 AI 助手拥有真正的“长期记忆”。项目地址https://github.com/thedotmack/claude-mem官方文档https://claude-mem.aiOpenClaw 集成curl -fsSL https://install.cmem.ai/openclaw.sh | bash