claude-mem

项目导读

项目定位

本项目原名为claude-mem，现也可称为Grok Mem，是面向AI智能体、编程助手的跨会话持久记忆补充工具，不会替换原有AI系统自带的记忆能力。它会自动记录AI会话过程中的操作内容、团队决策、待办事项等信息，经AI压缩处理后，在后续新会话中自动注入相关历史上下文，目前兼容Claude Code、OpenClaw、Codex、Gemini、Hermes、Copilot、OpenCode等多款主流AI产品。

核心能力

项目提供的核心能力包括：

1. 持久记忆：上下文信息可跨会话保留，不会因开启新会话丢失历史记录
2. 渐进式披露：采用分层策略调取记忆，同时展示对应token消耗成本，方便管控开销
3. 自然语言搜索：支持用自然语言查询项目历史会话记录
4. 网页可视化界面：可通过worker启动后输出的地址，实时查看记忆流
5. 隐私控制：会话内容中用``标签包裹的敏感内容，不会被存入记忆
6. 精细配置：可自定义规则，控制哪些上下文需要被注入新会话
7. 自动运行：配置完成后无需人工干预，自动完成记录、压缩、注入全流程
8. 引用溯源：所有历史记录都带唯一ID，可通过API调用或网页界面查阅溯源

典型安装与使用方式

项目提供多种安装路径，可对应不同使用场景：

1. 通用安装：直接运行命令 npx claude-mem install，安装程序会自动完成基础配置，之后引导你在浏览器端通过邮箱魔法链接登录（无需绑定银行卡）。登录后可获得账户专属记忆密钥，解锁30天免费的claude-mem observer额度，试用期间不会占用你自有AI服务的使用额度；试用到期后如果不订阅付费服务，会自动切换使用你自有Anthropic服务的额度。如果不想登录，可添加--provider参数指定自有AI密钥（支持OpenRouter、Gemini、Anthropic），或者设置环境变量CLAUDEMEMONLINEOPTIN=false，即可在无交互状态下完成安装，适合CI/自动化部署场景。
2. 特定产品适配安装：

• 给Grok Bot安装：运行 npx claude-mem install --ide grok-bot
• 给OpenCode安装：运行 npx claude-mem install --ide opencode
• 给Antigravity CLI安装：运行 npx claude-mem install --ide antigravity
• 给Claude Code安装：直接在Claude Code会话中运行 /plugin marketplace add thedotmack/claude-mem 后再运行 /plugin install claude-mem，重启Claude Code即可生效

1. OpenClaw网关安装：如果要给OpenClaw网关添加持久记忆能力，运行命令 curl -fsSL https://install.cmem.ai/openclaw.sh | bash 即可，安装程序会自动处理依赖安装、插件配置、AI服务商设置、worker启动，还可配置对接Telegram、Discord、Slack等渠道推送实时观察数据。

注意：不要使用 npm install -g claude-mem 安装，该命令仅会安装SDK/工具库，不会注册插件钩子、配置worker服务，无法正常使用记忆功能。

部署与配置说明

项目运行要求Node.js版本≥20.0.0；默认使用CMEM Pro托管内存服务，如果你需要完全本地存储记忆数据，可在安装时添加--provider host参数开启本地运行模式；支持自定义上下文注入规则，可根据业务需求调整记录、注入的内容范围；所有记忆数据支持云同步备份，也可关闭同步完全本地存储。

许可证与采用建议

项目使用Apache-2.0许可证，允许个人、企业自由使用、修改、商用，无需开源修改后的代码。如果你所在团队日常高频使用AI编程助手，经常需要在新会话中重复交代项目背景、过往决策，可以先试用30天免费额度，评估效率提升效果后再决定是否订阅付费服务；如果有数据合规要求不能使用第三方托管服务，可选择本地部署模式，所有数据保存在自有环境中。