Claude-Mem：让 AI 助手拥有持久记忆

核心要点：Claude-Mem 是一款智能记忆插件，能够自动捕获跨会话的工具使用观察记录、生成语义摘要，并在新会话中注入相关上下文。项目、知识在会话结束后依然延续

快速安装

一行命令即可完成安装：

# 标准安装（Claude Code）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/库，不会注册插件钩子或设置 Worker 服务。请务必使用 npx claude-mem install 或上述 /plugin 命令安装

OpenClaw 网关集成

在 OpenClaw 网关上通过一条命令安装 Claude-Mem 作为持久记忆插件：

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

该安装程序会自动处理依赖、插件配置、AI 提供商设置、Worker 启动，以及可选的实时观测推送到 Telegram、Discord、Slack 等渠道。详见 OpenClaw 集成指南。

核心功能

架构概览

核心组件

Claude-Mem 由以下 6 个核心组件构成：

• 5 个生命周期钩子 — SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd（共 6 个钩子脚本）
• 智能安装器 — 缓存依赖检查器（预钩子脚本，非生命周期钩子）
• Worker 服务 — 运行在端口 37777 的 HTTP API，提供 Web 查看器 UI 和 10 个搜索端点，由 Bun 管理
• SQLite 数据库 — 存储会话、观测记录、摘要
• mem-search 技能 — 支持自然语言查询，渐进式展示结果
• Chroma 向量数据库 — 混合语义 + 关键词搜索，实现智能上下文检索

MCP 搜索工具

Claude-Mem 提供 4 个 MCP 工具，采用高效的 3 层工作流模式：

3 层工作流：

1. search — 获取紧凑索引和 ID（约 50~100 Token/结果）
2. timeline — 获取感兴趣结果周围的时序上下文
3. get_observations — 仅对筛选后的 ID 获取完整详情（约 500~1,000 Token/结果）

通过过滤后再获取详情，可节省约 10 倍 Token。

使用示例：

// 步骤 1：搜索获取索引search(query="authentication bug", type="bugfix", limit=10)// 步骤 2：审阅索引，识别相关 ID（如 #123、#456）// 步骤 3：获取完整详情get_observations(ids=[123, 456])

工作模式与语言配置

Claude-Mem 通过 CLAUDE_MEM_MODE 设置支持多种工作模式和多语言。

配置方法

编辑配置文件 ~/.claude-mem/settings.json：

{  "CLAUDE_MEM_MODE": "code--zh"}

可用模式

语言特定模式遵循 code--[lang] 格式，其中 [lang] 为 ISO 639-1 语言代码。

注意：code--zh（简体中文）已内置，无需额外安装或更新插件

更改模式后，重启 Claude Code 即可生效。

Beta 特性

Claude-Mem 提供 Beta 频道，包含 Endless Mode（类生物记忆架构，用于长时间会话）等实验性功能。可在 Web 查看器 UI（http://localhost:37777 → 设置）中切换稳定版和 Beta 版。

系统要求

• Node.js：18.0.0 或更高版本
• Claude Code：支持插件的最新版本
• Bun：JavaScript 运行时和进程管理器（缺少时自动安装）
• uv：Python 包管理器，用于向量搜索（缺少时自动安装）
• SQLite 3：持久化存储（已捆绑）

Windows 设置说明

如果遇到如下错误：

npm : 无法将 'npm' 识别为 cmdlet 的名称

请确保 Node.js 和 npm 已安装并添加到 PATH 环境变量中。从 https://nodejs.org 下载最新的 Node.js 安装程序，安装后重启终端。

贡献与支持

如何贡献

欢迎贡献代码！流程如下：

1. Fork 仓库
2. 创建功能分支
3. 编写代码并附带测试
4. 更新文档
5. 提交 Pull Request

许可证

Claude-Mem 采用 Apache License 2.0 许可证。选择该许可的原因：持久的智能体记忆应易于嵌入开发者工具、本地 Agent、MCP 服务器、企业系统、机器人栈以及生产级 Agent 框架。

资源链接

• 文档：docs/
• 问题反馈：GitHub Issues
• 仓库：github.com/thedotmack/claude-mem
• 官方 X 账号：@Claude_Memory
• 作者：Alex Newman（@thedotmack）

技术特点：Claude-Mem 通过 5 个生命周期钩子实现跨会话的持久记忆，结合 SQLite 持久化存储、Chroma 向量混合搜索和 3 层渐进式检索机制，在保证 Token 效率的同时提供智能化的上下文注入能力

文档来源：Claude-Mem 

原始作者：Alex Newman (thedotmack) 

本文由 AI 助手整理优化，欢迎关注、分享转载，请注明出处