Claude-Mem：让AI编程工具跨会话持久记忆

Claude-Mem 无缝保留跨会话上下文，自动捕获工具使用观察、生成语义摘要，并让后续会话可访问。这使 Claude 能在会话结束或重连后仍保持关于项目的知识连续性。

为 Grok Bot 安装 claude-mem：

npx claude-mem install --ide grok-bot

Grok Bot 没有主机钩子，所以我们监听聊天日志文件。默认是 CMEM Pro，托管式记忆。本地观察器需要主动选择：--provider host。安装此插件不会同时安装 Cursor。

Awareness push 试点（LFG + Orifice）：观察（decision、bugfix、security_alert、sensitive）以带日期的 - YYYY-MM-DD [awareness] … 形式追加到该 bot 的 memory/log/YYYY-MM.md。Grok Bot 已从磁盘重新读取日志。这不会写入 profile.md、user-memory 或 project memory。用 CLAUDE_MEM_GROK_BOT_AWARENESS_ENABLED=false 禁用。

用一条命令安装：

npx claude-mem install

安装程序先完成所有设置，然后让你在浏览器中登录 claude-mem（邮箱魔法链接——无需信用卡）。登录后为你的账户配置一个 memory key，并解锁 claude-mem observer：超出计划运行的记忆，免费最长 14 天，让你的计划用量提升最高 100%。免费试用结束后，记忆自动回退到你的 Anthropic 计划，除非你订阅了会员。登录后你可以选择记忆提供者——claude-mem observer、你自己的 OpenRouter 或 Gemini key，或你的 Anthropic 计划。

想跳过登录？传入显式 --provider flag、设置 CLAUDE_MEM_ONLINE_OPTIN=false，或在 CI/非交互式 shell 中运行——安装程序无需任何账户交互即可完成。

或为 OpenCode 安装：

npx claude-mem install --ide opencode

或为 Antigravity CLI 安装（设置指南）：

npx claude-mem install --ide antigravity

或为 OMP（Oh My Pi）安装：

npx claude-mem install --ide omp

或通过 Claude Code 内的插件市场安装：

/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem

重启 Claude Code。之前会话的上下文会自动出现在新会话中。

注意：Claude-Mem 也在 npm 上发布，但 npm install -g claude-mem 只安装 SDK/库——不会注册插件钩子或设置 worker 服务。始终通过 npx claude-mem install 或上述 /plugin 命令安装。

用一条命令将 claude-mem 作为持久记忆插件安装到 OpenClaw 网关：

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

安装程序处理依赖、插件设置、AI 提供商配置、worker 启动，以及可选的 Telegram、Discord、Slack 等实时观察订阅。详见 OpenClaw 集成指南。

🧠 持久记忆 - 上下文跨会话存活

📊 渐进式披露 - 分层记忆检索，token 成本可见

🔍 基于技能的搜索 - 用 mem-search 技能查询项目历史

🖥️ Web 查看器 UI - 在 worker 启动时打印的 URL 上查看实时记忆流

💻 Claude Desktop 技能 - 从 Claude Desktop 对话中搜索记忆

🔒 隐私控制 - 用 <private> 标签将敏感内容排除在存储之外

⚙️ 上下文配置 - 细粒度控制注入哪些上下文

🤖 自动运行 - 无需手动干预

🔗 引用 - 通过 worker API 用 ID 引用历史观察，或在 web 查看器中查看全部

📚 查看完整文档 - 在官网浏览

安装指南 - 快速入门和高级安装

使用指南 - Claude-Mem 如何自动工作

搜索工具 - 用自然语言查询项目历史

云同步 - 将记忆备份到 cmem.ai——无需 daemon，worker 在写入时同步

上下文工程 - AI agent 上下文优化原则

渐进式披露 - Claude-Mem 上下文 priming 策略背后的理念

概述 - 系统组件与数据流

架构演进 - 从 v3 到 v5 的演进历程

Hooks 架构 - Claude-Mem 如何使用生命周期钩子

Hooks 参考 - 7 个钩子脚本详解

Worker 服务 - HTTP API 与 Bun 管理

数据库 - SQLite 架构与 FTS5 搜索

搜索架构 - 结合 Chroma 向量数据库的混合语义+关键词搜索

详见架构概述。

Claude-Mem 通过 4 个 MCP 工具提供智能记忆搜索，采用节能的 3 层工作流模式：

3 层工作流：

search - 获取紧凑索引和 ID（每个结果约 50-100 tokens）

timeline - 获取有趣结果的时间上下文

get_observations - 仅针对过滤后的 ID 获取完整详情（每个结果约 500-1,000 tokens）

Claude 用 MCP 工具搜索记忆

从 search 开始获取结果索引

用 timeline 查看特定观察周围发生了什么

用 get_observations 获取相关 ID 的完整详情

在获取详情前先过滤，节省约 10 倍 tokens

search - 用全文查询搜索记忆索引，支持按 type/date/project 过滤

timeline - 获取特定观察或查询的时间上下文

get_observations - 按 ID 批量获取观察详情（始终批量多个 ID）

// Step 1: 搜索索引
search(query="authentication bug", type="bugfix", limit=10)

// Step 2: 查看索引，识别相关 ID（如 #123, #456）

// Step 3: 获取完整详情
get_observations(ids=[123, 456])

详见搜索工具指南。

稳定版本从 main 发布并发布到 npm。core-dev 和 community-edge 是源码运行分支，用于早期可靠性修复和社区集成。详见发布分支了解分支流程和非稳定版运行说明。

环境要求

Node.js：20.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 模型、worker 端口、数据目录、日志级别和上下文注入设置。

要将每个 harness 在 Claude Code 和 Codex SessionStart 上下文中的观察都包含进来，在该文件中设置 "CLAUDE_MEM_SESSION_START_INCLUDE_ALL_SOURCES": "true"，或在查看器设置中启用 Include all sources at session start。默认是 "false"，将启动上下文限制为当前 harness。观察数量限制仍适用于所选数据源。

详见配置指南了解所有可用设置和示例。

模式与语言配置

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 Code 以应用新模式配置。

详见开发指南了解构建、测试和贡献工作流程。

遇到问题时，向 Claude 描述问题，troubleshoot 技能会自动诊断并提供修复方案。

详见故障排除指南了解常见问题和解决方案。

用自动化生成器创建全面的 bug 报告：

cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report

欢迎贡献！请：

创建功能分支

用测试做更改

提交 Pull Request

Claude-Mem 从三个分支发布：main（稳定版）、core-dev 和 community-edge。只有 main 发布到 npm；其他分支从源码运行。详见发布分支了解策略和本地运行说明。

详见开发指南了解贡献工作流程。

Claude-Mem 遵循 Apache License 2.0 许可。

我们选择 Apache-2.0，是因为持久的 agentic memory 应该易于嵌入开发者工具、本地 agent、MCP 服务器、企业系统、机器人技术栈和生产 agent harness。

详见 LICENSE 文件了解完整细节。详见 docs/license.md 和 docs/ip-boundary.md 了解许可范围和开源/商业边界。

关于 Ragtime 的说明：ragtime/ 目录采用 Apache License 2.0。详见 ragtime/LICENSE。

问题反馈：GitHub Issues

仓库：github.com/thedotmack/claude-mem

官方 X 账号：@Claude_Memory

官方 Discord：加入 Discord

作者：Alex Newman（@thedotmack）

基于 Claude Agent SDK 构建 | 适用于 Claude Code | TypeScript 开发

CMEM 是第三方创建的 token，但已被 Claude-Mem 创建者（Alex Newman，@thedotmack）正式采用。该 token 作为社区增长催化剂，帮助将 CMEM 带给最需要的开发者和知识工作者。

官方 BASE CA：0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3